Truy xuất và cập nhật gói thuê bao

Sau khi truy xuất một gói thuê bao, bạn có thể sử dụng thông tin từ phản hồi thành công để thay đổi trạng thái của gói thuê bao hoặc cập nhật gói thuê bao đó. Trang này tập trung vào những cách mà bạn có thể truy xuất và cập nhật gói thuê bao.

Truy xuất gói thuê bao

Để truy xuất một gói thuê bao được đặt hoặc chuyển thành công, hãy sử dụng yêu cầu HTTP GET sau đây.

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID

Thay thế các đoạn mã sau:

  • CUSTOMER_ID: Tên miền chính của khách hàng hoặc giá trị nhận dạng duy nhất của khách hàng.
  • SUBSCRIPTION_ID: Giá trị nhận dạng gói thuê bao là duy nhất cho từng khách hàng. Bạn có thể truy xuất giá trị này bằng cách sử dụng phương thức truy xuất tất cả gói thuê bao của đại lý.

Thao tác này không có thông số trong nội dung yêu cầu.

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200 và các chế độ cài đặt của gói thuê bao. Trong phản hồi mẫu sau, thuộc tính isInTrial là false nhưng không có thuộc tính trialEndTime, nghĩa là khách hàng này chưa từng dùng gói dùng thử miễn phí 30 ngày của gói này.

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "billingMethod": "ONLINE",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "RENEW_CURRENT_USERS_MONTHLY_PAY"
  },
  "purchaseOrderId": "example.com_annual_1",
  "status": "ACTIVE",
  "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
  "skuName": "Google Workspace Business Standard"
}

Truy xuất tất cả gói thuê bao cho một khách hàng

Để truy xuất tất cả các gói thuê bao của một khách hàng cụ thể là đại lý đã được đặt hàng hoặc chuyển thành công, hãy sử dụng yêu cầu HTTP GET sau đây và thêm mã thông báo uỷ quyền:

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID value&pageToken=START_DATE&maxResults=MAX_NUMBER

Thay thế các đoạn mã sau:

  • CUSTOMER_ID: Tên miền chính của khách hàng hoặc giá trị nhận dạng duy nhất của khách hàng.
  • START_DATE: Ngày bắt đầu ở định dạng YYYY-MM-DD.
  • MAX_NUMBER: Số lượng kết quả tối đa được trả về trên một trang phản hồi.

Thao tác này không có thông số trong nội dung yêu cầu.

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200 cùng danh sách các gói thuê bao và chế độ cài đặt của khách hàng. Danh sách gói thuê bao có thể bao gồm các sản phẩm không được quản lý trong phiên bản này của API Đại lý.

Nếu bạn không quản lý khách hàng này không được quản lý, thì hệ thống sẽ trả về lỗi 403 "Forbidden".

Truy xuất tất cả gói thuê bao có thể chuyển cho khách hàng

Để truy xuất tất cả các gói thuê bao của khách hàng mà có khả năng được chuyển sang quyền quản lý của đại lý, hãy sử dụng yêu cầu HTTP GET sau đây và bao gồm mã thông báo uỷ quyền. customerId là bắt buộc và là giá trị nhận dạng duy nhất của khách hàng được trả về khi truy xuất tài khoản của khách hàng được bán lại. customerAuthToken là mã chuyển do khách hàng cung cấp, dành riêng cho mã đại lý của bạn. Sau khi do khách hàng tạo, mã này sẽ có hiệu lực trong 30 ngày. Để biết thêm thông tin về cách khách hàng tạo mã thông báo, hãy xem bài viết Chuyển tài khoản Google Workspace của bạn cho đại lý.

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID&customerAuthToken=AUTH_TOKEN&pageToken=START_DATE&maxResults=MAX_NUMBER

Thay thế các đoạn mã sau:

  • CUSTOMER_ID: Tên miền chính của khách hàng hoặc giá trị nhận dạng duy nhất của khách hàng.
  • AUTH_TOKEN: Mã chuyển do khách hàng cung cấp. Mã này dành riêng cho mã đại lý của bạn. Sau khi được khách hàng tạo, mã này sẽ có hiệu lực trong 30 ngày. Để biết thêm thông tin về cách khách hàng tạo mã thông báo, hãy xem bài viết Chuyển tài khoản Google Workspace của bạn cho đại lý. Nếu giá trị này không hợp lệ hoặc đã hết hạn, thì phản hồi của API sẽ trả về lỗi 403 "Forbidden".
  • START_DATE: Ngày bắt đầu ở định dạng YYYY-MM-DD.
  • MAX_NUMBER: Số lượng kết quả tối đa được trả về trên một trang phản hồi.

Thao tác này không có thông số trong nội dung yêu cầu.

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200 và danh sách các gói thuê bao có thể chuyển của khách hàng có ngày hết hạn của mã thông báo chuyển và số giấy phép tối thiểu cần thiết trong yêu cầu chuyển. Khách hàng có thể giữ thêm các gói thuê bao không chuyển nhượng được.

{
  "kind": "reseller#subscriptions",
  "subscriptions": [
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-6543",
      "subscriptionId": "432",
      "skuId": "1010020028",
      "billingMethod": "ONLINE",
      "creationTime": "1331647980142",
      "plan": {
        "planName": "ANNUAL",
        "isCommitmentPlan": true,
        "commitmentInterval": {
          "startTime": "1331647980142",
          "endTime": "1363183980142"
        }
      },
      "seats": {
        "kind": "subscriptions#seats",
        "numberOfSeats": 10,
        "maximumNumberOfSeats": 500,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "transferInfo": {
        "transferabilityExpirationTime": "1333183980142",
        "minimumTransferableSeats": "20"
      },
      "purchaseOrderId": "PO_890",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-6543",
      "subscriptionId": "140",
      "skuId": "1010020028",
      "creationTime": "1329389322728",
      "plan": {
        "planName": "FLEXIBLE",
        "isCommitmentPlan": false
      },
      "seats": {
        "kind": "subscriptions#seats",
        "maximumNumberOfSeats": 50
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false,
        "trialEndTime": "1331877480016"
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "transferInfo": {
        "transferabilityExpirationTime": "1333183780159",
        "minimumTransferableSeats": "10"
      },
      "purchaseOrderId": "",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
  ],
  "nextPageToken": "token"
}

Nếu bạn dự định chuyển các gói thuê bao này bằng cách sử dụng thao tác hàng loạt, hãy chuyển tất cả các gói thuê bao. Việc chuyển từng gói thuê bao sẽ dẫn đến lỗi. Ngoài ra, thao tác hàng loạt chỉ chuyển các gói thuê bao có trạng thái ACTIVE. Để biết thêm thông tin, hãy xem phần Chuyển gói thuê bao.

Truy xuất tất cả gói thuê bao của đại lý

Để truy xuất tất cả các gói thuê bao được đặt mua hoặc chuyển thành công của đại lý, hãy sử dụng yêu cầu HTTP GET sau đây và bao gồm mã thông báo uỷ quyền. 

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=PREFIX &pageToken=TOKEN&maxResults=MAX_NUMBER

Thay thế các đoạn mã sau:

  • PREFIX: Phần đầu của tên khách hàng có các gói thuê bao bạn đang tìm kiếm.
  • TOKEN: Mã thông báo xác định một trang kết quả cụ thể mà máy chủ sẽ trả về.
  • MAX_NUMBER: Số lượng kết quả tối đa được trả về trên một trang phản hồi.

Thao tác này có thể sử dụng phạm vi truy cập chỉ đọc OAuth. customerNamePrefix, pageToken và maxResults là các chuỗi truy vấn không bắt buộc.

Ví dụ sau đây truy xuất tất cả các gói thuê bao của đại lý thuộc về khách hàng có tên bắt đầu bằng "exam" (bài kiểm tra):

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=exam

{
  "kind": "reseller#subscriptions",
  "subscriptions": [
    {
      "kind": "subscriptions#subscription",
      "customerId": "C0123456",
      "subscriptionId": "123",
      "skuId": "1010020028",
      "creationTime": "1331647980142",
      "billingMethod": "ONLINE",
      "plan": {
        "planName": "ANNUAL",
        "isCommitmentPlan": true,
        "commitmentInterval": {
          "startTime": "1331647980142",
          "endTime": "1363183980142"
        }
      },
      "seats": {
        "kind": "subscriptions#seats",
        "numberOfSeats": 10,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "purchaseOrderId": "PO_135",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-5678",
      "subscriptionId": "1404686",
      "skuId": "1010020028",
      "billingMethod": "ONLINE",
      "creationTime": "1329389322728",
      "plan": {
        "planName": "FLEXIBLE",
        "isCommitmentPlan": false
      },
      "seats": {
        "kind": "subscriptions#seats",
        "maximumNumberOfSeats": 50,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false,
        "trialEndTime": "1331877480016"
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "AUTO_RENEW"
      },
      "purchaseOrderId": "",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
  ],
  "nextPageToken": "token"
}

Cập nhật gói thuê bao

Quá trình cập nhật các gói Google Workspace sẽ khác nhau tuỳ theo gói. Trước khi bạn cập nhật một gói, hãy cân nhắc những điều sau:

  • Khi bạn tạo một gói thuê bao và khách hàng đủ điều kiện, gói thuê bao của gói thuê bao có thể có thời hạn dùng thử 30 ngày. Cả gói thanh toán linh hoạt và gói thanh toán hằng năm đều có thời hạn dùng thử miễn phí 30 ngày. Trong thời gian dùng thử, bạn có thể thay đổi gói thanh toán của gói thuê bao thành gói linh hoạt hoặc gói cam kết hằng năm thường xuyên nếu cần. Tuy nhiên, sau khi thời gian dùng thử kết thúc và gói bắt đầu hoạt động, việc cập nhật gói sẽ tuân theo các quy tắc tương tự như các gói đang hoạt động của các gói thuê bao khác. Để chuyển ngay gói thuê bao dùng thử sang một gói đang hoạt động, hãy bắt đầu sử dụng một dịch vụ có tính phí từ gói thuê bao dùng thử miễn phí 30 ngày. Để biết thêm thông tin về thời gian dùng thử 30 ngày và các quy tắc đánh giá khách hàng, hãy xem trung tâm trợ giúp dành cho quản trị viên.

  • Bạn có thể cập nhật gói linh hoạt thành gói cam kết hằng năm.

  • Bạn không thể cập nhật gói cam kết hằng năm.

  • Không phải gói nào cũng dùng được với mọi sản phẩm. Để biết thêm thông tin về những sản phẩm được sử dụng trong các gói này, hãy xem phần Sản phẩm và SKU.

Để cập nhật gói dùng thử 30 ngày hoặc gói linh hoạt lên gói cam kết hằng năm, hãy sử dụng yêu cầu HTTP POST sau:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changePlan

Thay thế các đoạn mã sau:

  • CUSTOMER_ID: Tên miền chính của khách hàng hoặc giá trị nhận dạng duy nhất của khách hàng.
  • SUBSCRIPTION_ID: Giá trị nhận dạng gói thuê bao là duy nhất cho từng khách hàng. Bạn có thể truy xuất giá trị này bằng cách sử dụng phương thức truy xuất tất cả gói thuê bao của đại lý.

Ví dụ sau đây cập nhật gói thuê bao bằng subscriptionId với giá trị là 123. customerId là C0123456.

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changePlan

Nội dung yêu cầu có các thành phần sau:

{
  "kind": "reseller#changePlanRequest",
  "planName": "ANNUAL_MONTHLY_PAY",
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  "purchaseOrderId": "123_March2012"
}

Phản hồi thành công sẽ trả về mã trạng thái HTTP 201 và trả về các chế độ cài đặt gói thuê bao đã cập nhật:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "purchaseOrderId": "123_March2012",
  "status": "ACTIVE",
  "skuName": "Google Workspace Business Standard"
}

Cập nhật giấy phép của gói thuê bao

Việc cập nhật gói thuê bao cam kết hằng năm sẽ sử dụng các thuộc tính gói thuê bao khác với việc cập nhật gói thuê bao của gói linh hoạt của Google Workspace.

Cập nhật giấy phép cho gói thuê bao hằng năm

Để cập nhật chế độ cài đặt giấy phép người dùng của gói thuê bao hằng năm, hãy sử dụng yêu cầu HTTP POST sau đây:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeSeats

Thay thế các đoạn mã sau:

  • CUSTOMER_ID: Tên miền chính của khách hàng hoặc giá trị nhận dạng duy nhất của khách hàng.
  • SUBSCRIPTION_ID: Giá trị nhận dạng gói thuê bao là duy nhất cho từng khách hàng. Bạn có thể truy xuất giá trị này bằng cách sử dụng phương thức truy xuất tất cả gói thuê bao của đại lý.

Ví dụ sau đây cập nhật gói thuê bao bằng 123 subscriptionId. customerId là C0123456. Nội dung của yêu cầu sẽ khác nhau tuỳ thuộc vào loại kế hoạch:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changeSeats

Gói thuê bao của gói cam kết hằng năm của Google Workspace sử dụng nội dung yêu cầu này để cập nhật số lượng giấy phép người dùng. Giá trị numberOfSeats là giá trị tổng. Ví dụ: nếu trước đây bạn có 10 giấy phép người dùng và bạn có một đơn đặt hàng của khách hàng cho 5 giấy phép mới, thì tổng số trong nội dung của yêu cầu cho numberOfSeats là 15, như minh hoạ trong ví dụ sau:

{
    "kind": "subscriptions#seats",
    "numberOfSeats": 15
}

Cập nhật giấy phép cho gói thuê bao của gói linh hoạt

Gói thuê bao của gói linh hoạt của Google Workspace sử dụng nội dung yêu cầu để cập nhật giấy phép của người dùng. Giá trị maximumNumberOfSeats là tổng số giấy phép hiện có và giấy phép mới. Đây là số lượng giấy phép người dùng tối đa mà tài khoản có thể cấp.

{
  "kind": "subscriptions#seats",
  "maximumNumberOfSeats": 15
}

Phản hồi thành công sẽ trả về mã trạng thái HTTP 201 và các chế độ cài đặt giấy phép gói thuê bao đã cập nhật:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "FLEXIBLE",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 15,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "skuName": "Google Workspace Business Standard"
}

Cập nhật chế độ cài đặt gia hạn của gói thuê bao

Để cập nhật chế độ cài đặt gia hạn của gói thuê bao cam kết hằng năm, hãy sử dụng yêu cầu HTTP POST sau đây:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeRenewalSettings

Thay thế các đoạn mã sau:

  • CUSTOMER_ID: Tên miền chính của khách hàng hoặc giá trị nhận dạng duy nhất của khách hàng.
  • SUBSCRIPTION_ID: Giá trị nhận dạng gói thuê bao là duy nhất cho từng khách hàng. Bạn có thể truy xuất giá trị này bằng cách sử dụng phương thức truy xuất tất cả gói thuê bao của đại lý.

Sau đây là ví dụ về nội dung yêu cầu:

{
  "kind": "subscriptions#renewalSettings",
  "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
}

Thuộc tính renewalType có thể có giá trị bất kỳ sau đây:

  • AUTO_RENEW_YEARLY_PAY: Khi kết thúc khoảng thời gian của gói cam kết hằng năm, hệ thống sẽ tự động gia hạn gói của gói thuê bao thành ANNUAL_YEARLY_PAY với cùng một numberOfSeats.
  • AUTO_RENEW_MONTHLY_PAY: Khi kết thúc khoảng thời gian của gói cam kết hằng năm, sẽ tự động gia hạn gói của gói thuê bao với tên ANNUAL_MONTHLY_PAY với cùng một numberOfSeats.
  • RENEW_CURRENT_USERS_YEARLY_PAY: Khi kết thúc khoảng thời gian của gói cam kết hằng năm, hãy gia hạn gói thuê bao thành ANNUAL_YEARLY_PAY nhưng sử dụng tổng số giấy phép người dùng đang hoạt động. Đây là chế độ cài đặt mặc định cho các gói cam kết hằng năm đang hoạt động (thanh toán hằng năm).
  • RENEW_CURRENT_USERS_MONTHLY_PAY: Khi kết thúc khoảng thời gian của gói cam kết hằng năm, hãy gia hạn gói thuê bao thành ANNUAL_MONTHLY_PAY nhưng sử dụng tổng số giấy phép người dùng đang hoạt động. Đây là chế độ cài đặt mặc định cho các gói cam kết hằng năm đang hoạt động (thanh toán hằng tháng).
  • RENEW_ON_PROPOSED_OFFER: Khi kết thúc khoảng thời gian của gói cam kết hiện tại, hãy gia hạn đề xuất gia hạn mới nhất với numberOfSeats số giấy phép người dùng hiện đang hoạt động hoặc cam kết ưu đãi được đề xuất tuỳ theo số nào lớn hơn.
  • SWITCH_TO_PAY_AS_YOU_GO: Khi kết thúc khoảng thời gian của gói cam kết hằng năm, hãy thay đổi gói cam kết hằng năm thành gói linh hoạt.
  • CANCEL: Khi kết thúc khoảng thời gian của gói cam kết hằng năm, gói thuê bao sẽ bị tạm ngưng. Để tìm hiểu cách gỡ bỏ lệnh tạm ngưng, hãy truy cập vào trung tâm trợ giúp dành cho quản trị viên.

Phản hồi thành công sẽ trả về mã trạng thái HTTP 201 và các chế độ cài đặt gia hạn gói thuê bao đã cập nhật:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 15,
    "licensedNumberOfSeats": 15
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "skuName": "Google Workspace Business Standard"
}

Bắt đầu dịch vụ có tính phí từ gói thuê bao dùng thử miễn phí

Để chuyển ngay gói thuê bao dùng thử miễn phí 30 ngày sang gói thuê bao dịch vụ có tính phí, nếu bạn đã thiết lập gói thanh toán cho gói thuê bao dùng thử, hãy sử dụng yêu cầu HTTP POST sau. 

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/startPaidService

Thay thế các đoạn mã sau:

  • CUSTOMER_ID: Tên miền chính của khách hàng hoặc giá trị nhận dạng duy nhất của khách hàng.
  • SUBSCRIPTION_ID: Giá trị nhận dạng gói thuê bao là duy nhất cho từng khách hàng. Bạn có thể truy xuất giá trị này bằng cách sử dụng phương thức truy xuất tất cả gói thuê bao của đại lý.

Ví dụ sau đây có C0123456 là customerId và giá trị subscriptionId là 123:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/startPaidService

Thao tác này không có thông số trong nội dung yêu cầu.

Phản hồi thành công sẽ trả về mã trạng thái HTTP 201 và chế độ cài đặt gói thuê bao được cập nhật:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 15,
    "licensedNumberOfSeats": 15
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "skuName": "Google Workspace Business Standard"
}

Nâng cấp hoặc hạ cấp gói thuê bao

Bạn không thể hạ cấp gói hằng năm vào giữa kỳ hạn của gói hằng năm, cũng như không thể lên lịch hạ cấp bằng cách sử dụng chế độ cài đặt gia hạn. Bạn nên thiết lập chế độ cài đặt gia hạn để chuyển thành FLEXIBLE rồi hạ cấp sau thời gian gia hạn.

Để nâng cấp hoặc hạ cấp một gói thuê bao, hãy tạo một gói thuê bao mới có skuId mà bạn muốn nâng cấp hoặc hạ cấp xuống.

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

Thay thế các đoạn mã sau:

  • CUSTOMER_ID: Tên miền chính của khách hàng hoặc giá trị nhận dạng duy nhất của khách hàng.

Lệnh gọi này sẽ chấm dứt gói thuê bao trước đó và tạo một gói thuê bao mới.

Tìm thêm thông tin về nâng cấp và hạ cấp trên trang Sản phẩm và SKU.