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

Sau khi truy xuất gói thuê bao, bạn có thể sử dụng thông tin từ phản hồi thành công tới 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 gói thuê bao đã đặt hoặc chuyển thành công, hãy sử dụng theo yêu cầu HTTP GET.

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

Thay thế đoạn mã sau:

  • CUSTOMER_ID: Miền chính của khách hàng tên hoặc mã 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 đang riêng biệt cho mỗi khách hàng. Bạn có thể truy xuất giá trị này bằng cách sử dụng toán tử Truy xuất tất cả phương thức đăng ký của đại lý.

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

Phản hồi thành công sẽ trả về trạng thái HTTP 200 mã và các chế độ cài đặt của gói thuê bao. Trong phản hồi ví dụ sau, Thuộc tính isInTrial là false nhưng không có trialEndTime, tức là khách hàng này chưa từng tham gia một Dùng thử miễn phí 30 ngày đối với 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 là đại lý cụ thể mà bạn đã đã đặ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à bao gồ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ế đoạn mã sau:

  • CUSTOMER_ID: Miền chính của khách hàng tên hoặc mã 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 trang phản hồi.

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

Khi phản hồi thành công, hệ thống sẽ trả về mã trạng thái HTTP 200 và danh sách các gói thuê bao và chế độ cài đặt của khách hàng. Danh sách các 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 người bán lại.

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

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ó thể đượ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. Chiến lược phát hành đĩa đơn customerId là bắt buộc và là giá trị nhận dạng riêng biệ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 của bạn cung cấp dành riêng cho mã đại lý của bạn. Sau khi đã được khách hàng tạo, giấy phép này có hiệu lực với 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 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ế đoạn mã sau:

  • CUSTOMER_ID: Miền chính của khách hàng tên hoặc mã nhận dạng duy nhất của khách hàng.
  • AUTH_TOKEN: Mã chuyển do bạn cung cấp khách hàng cụ thể cho mã đại lý của bạn. Sau khi quảng cáo được tạo bằng khách hàng, 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 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ề một 403 "Forbidden" lỗi.
  • 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 trang phản hồi.

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

Khi phản hồi thành công, hệ thống sẽ trả về mã trạng thái HTTP 200 và danh sách gói thuê bao có thể chuyển nhượng của khách hàng có ngày hết hạn chuyển mã thông báo và số chỗ tối thiểu cần thiết trong yêu cầu chuyển. Một khách hàng có thể giữ lại gói thuê bao bổ sung không thể chuyển nhượng.

{
  "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 định chuyển những gói thuê bao này bằng cách sử dụng lô chuyển mọi gói thuê bao. Chuyển từng gói thuê bao từng kết quả một sẽ dẫn đến lỗi. Ngoài ra, thao tác theo lô 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 Chuyển một gói thuê bao.

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

Để truy xuất tất cả những đơn hàng đã được đặt hàng hoặc chuyển đi thành công của đại lý gói thuê bao, hãy sử dụng yêu cầu HTTP GET sau 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ế đoạn mã sau:

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

Thao tác này có thể sử dụng phạm vi truy cập chỉ đọc của OAuth. Chiến lược phát hành đĩa đơn 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ề những khách hàng có tên bắt đầu bằng từ "exam":

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

Cách cập nhật các gói Google Workspace sẽ khác nhau tuỳ theo gói. Trước khi cập nhật một kế hoạch, 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, có thể là gói dùng thử 30 ngày. Cả gói linh hoạt và gói hằng năm gói thanh toán theo cam kết có thể là gói 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 hằng năm các gói cam kết của bạn thường xuyên nếu cần. Nhưng sau khi thời gian dùng thử kết thúc và gói sẽ bắt đầu hoạt động, việc cập nhật kế hoạch sẽ tuân theo các quy tắc giống như các quy tắc khác các gói thuê bao kế hoạch hoạt động. Để chuyển ngay gói thuê bao dùng thử sang kế hoạch hoạt động, bắt đầu sử dụng dịch vụ có tính phí thông qua gói thuê bao dùng thử miễn phí 30 ngày. Để biết thêm thông tin về bản dùng thử 30 ngày và các quy tắc đánh giá chất lượng 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ề việc sản phẩm được các gói này sử dụng, hãy xem 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 thành gói hằng năm gói cam kết, 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ế đoạn mã sau:

  • CUSTOMER_ID: Miền chính của khách hàng tên hoặc mã 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 đang riêng biệt cho mỗi khách hàng. Bạn có thể truy xuất giá trị này bằng cách sử dụng toán tử Truy xuất tất cả phương thức đăng ký của đại lý.

Ví dụ sau đây cập nhật gói thuê bao bằng subscriptionId với giá trị 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ề giá trị đã cập nhật cài đặt gói thuê bao:

{
  "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 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 nhiều 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 vị trí cho gói thuê bao của gói 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:

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

Thay thế đoạn mã sau:

  • CUSTOMER_ID: Miền chính của khách hàng tên hoặc mã 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 đang riêng biệt cho mỗi khách hàng. Bạn có thể truy xuất giá trị này bằng cách sử dụng toán tử Truy xuất tất cả phương thức đăng ký của đại lý.

Ví dụ sau đây cập nhật gói thuê bao bằng 123 subscriptionId. Chiến lược phát hành đĩa đơn customerId là C0123456. Nội dung của yêu cầu khác nhau tuỳ thuộc vào loại gói dịch vụ:

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

Gói thuê bao 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à tổng cộng. Ví dụ: nếu trước đây bạn có 10 giấy phép người dùng và bạn có đơn đặt hàng 5 giấy phép mới của khách hàng, tổng số giấy phép trong phần nội dung của yêu cầu cho numberOfSeats là 15, như trong ví dụ sau:

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

Cập nhật vị trí cho gói thuê bao của gói linh hoạt

Gói thuê bao 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 của giấy phép hiện có và giấy phép mới. Đây là số người dùng tối đa giấy phép mà tài khoản có thể cấp phép.

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

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

{
  "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 việc gia hạn của gói thuê bao cam kết hằng năm, hãy sử dụng sau đây là yêu cầu HTTP POST:

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

Thay thế đoạn mã sau:

  • CUSTOMER_ID: Miền chính của khách hàng tên hoặc mã 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 đang riêng biệt cho mỗi khách hàng. Bạn có thể truy xuất giá trị này bằng cách sử dụng toán tử Truy xuất tất cả phương thức đăng ký 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"
}

Giá trị của thuộc tính renewalType có thể là bất kỳ giá trị nào 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, tự động gia hạn 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 thời gian sử dụng gói cam kết hằng năm tự động gia hạn gói thuê bao thành ANNUAL_MONTHLY_PAY với cùng numberOfSeats.
  • RENEW_CURRENT_USERS_YEARLY_PAY: Khi kết thúc thời gian sử dụng gói cam kết hằng năm hãy gia hạn gói thuê bao là ANNUAL_YEARLY_PAY nhưng sử dụng tổng số giấy phép người dùng hiện đang hoạt động. Đây là lựa chọn mặc định chế độ cài đặt 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 thời gian sử dụng gói cam kết hằng năm hãy gia hạn gói thuê bao là ANNUAL_MONTHLY_PAY nhưng sử dụng tổng số giấy phép người dùng hiện đang hoạt động. Đây là lựa chọn mặc định chế độ cài đặt 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 thời gian sử dụng gói cam kết hiện tại khoảng thời gian, hãy gia hạn theo đề xuất gia hạn mới nhất với numberOfSeats dưới dạng số trong số giấy phép người dùng đang hoạt động hiện tại hoặc cam kết ưu đãi được đề xuất, tuỳ theo cao hơn.
  • SWITCH_TO_PAY_AS_YOU_GO: Khi kết thúc thời gian sử dụng gói cam kết hằng năm 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 cam kết hằng năm, gói thuê bao đã bị tạm ngưng. Để tìm hiểu cách gỡ bỏ quyết định tạm ngưng, hãy xem trung tâm trợ giúp dành cho quản trị viên.

Khi phản hồi thành công, hệ thống sẽ trả về mã trạng thái HTTP 201 và mã trạng thái cài đặt gia hạn gói thuê bao:

{
  "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 sử dụng dịch vụ có tính phí từ gói thuê bao dùng thử miễn phí

Để di chuyển ngay gói đăng ký dùng thử miễn phí 30 ngày sang dịch vụ có tính phí gói thuê bao nếu bạn đã thiết lập gói thanh toán để dùng thử 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/startPaidService

Thay thế đoạn mã sau:

  • CUSTOMER_ID: Miền chính của khách hàng tên hoặc mã 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 đang riêng biệt cho mỗi khách hàng. Bạn có thể truy xuất giá trị này bằng cách sử dụng toán tử Truy xuất tất cả phương thức đăng ký của đại lý.

Ví dụ sau có C0123456 là customerId và Giá trị subscriptionId/123:

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

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

Khi phản hồi thành công, hệ thống sẽ trả về mã trạng thái HTTP 201 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": 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 thời hạn của gói và 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 đặt các tùy chọn cài đặt gia hạn để chuyển sang FLEXIBLE, sau đó hạ cấp sau thời gian gia hạn.

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

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

Thay thế đoạn mã sau:

  • CUSTOMER_ID: Miền chính của khách hàng tên hoặc mã nhận dạng duy nhất của khách hàng.

Cuộc 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 & SKU.