Tạo hoặc chuyển gói thuê bao

Sau khi đặt hàng tài khoản của khách hàng, bạn có thể tạo một số gói thuê bao khác nhau:

  • Gói thuê bao theo cam kết hằng năm
  • Gói thuê bao linh hoạt
  • Thời gian dùng thử miễn phí 30 ngày
  • Một gói thuê bao với mức giá chiết khấu

Để biết thêm thông tin về sản phẩm mà các gói thuê bao này sử dụng, hãy xem bài viết Sản phẩm và SKU.

Nếu bạn không yêu cầu tài khoản của khách hàng này, thì bạn có thể chuyển gói thuê bao.

Những khách hàng có customerType = 'team' chỉ có thể mua các phiên bản Essentials và Enterprise Essentials của Google Workspace. Nếu cố mua bất kỳ gói thuê bao nào khác của Google Workspace, bạn sẽ gặp lỗi –Customer is not eligible to purchase this subscription. Những khách hàng mua Essentials hoặc gói thuê bao dựa trên mức sử dụng có thể không xử lý được Gói cam kết hằng năm và có các lựa chọn nâng cấp và hạ cấp có giới hạn.

Tạo gói thuê bao

Để tạo gói thuê bao cho tài khoản của khách hàng mới tạo, hãy sử dụng yêu cầu HTTP POST sau đây và bao gồm mã thông báo uỷ quyền:

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

CUSTOMER_ID là 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 được trả về khi truy xuất tài khoản của khách hàng được bán lại.

Tạo gói cam kết hằng năm

Đối với các gói thuê bao cam kết hằng năm, không phải SKU nào cũng có cùng chế độ cài đặt gia hạn mặc định. Bạn nên luôn chuyển renewalSettings. Tạo một gói thuê bao cam kết hằng năm với 10 giấy phép:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  renewalSettings: {
    "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
  },
  "purchaseOrderId": "PURCHASE_ORDER_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.
  • SKU_ID: Mã nhận dạng đơn vị lưu kho (SKU) duy nhất. Để biết thêm thông tin, hãy xem bài viết Sản phẩm và mã SKU.
  • PURCHASE_ORDER_ID: Mã đơn hàng không bắt buộc mà bạn có thể dùng để theo dõi việc sử dụng.

Phản hồi thành công sẽ trả về trạng thái HTTP 200 và chế độ cài đặt của gói thuê bao mới đối với gói cam kết hằng năm. ANNUAL_MONTHLY_PAY được trả về dưới dạng ANNUAL trong tất cả phản hồi của API.

Sau đây là ví dụ về việc phản hồi gói hằng năm:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "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": "my_example.com_annual_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

Tạo gói linh hoạt

Để tạo gói thuê bao linh hoạt cho tài khoản của khách hàng mới tạo, hãy sử dụng yêu cầu HTTP POST sau đây và bao gồm mã thông báo uỷ quyền:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "FLEXIBLE"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_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.
  • SKU_ID: Mã nhận dạng đơn vị lưu kho (SKU) duy nhất. Để biết thêm thông tin, hãy xem bài viết Sản phẩm và mã SKU.
  • PURCHASE_ORDER_ID: Mã đơn hàng không bắt buộc mà bạn có thể dùng để theo dõi việc sử dụng.

Sau đây là ví dụ về một phản hồi của kế hoạch linh hoạt:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "FLEXIBLE",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10,
    "licensedNumberOfSeats": 0
  },
  "trialSettings": {
    "isInTrial": false
  },
  "purchaseOrderId": "my_example_flex_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

Tạo bản dùng thử miễn phí

Để tạo gói thuê bao dùng thử miễn phí 30 ngày cho tài khoản của khách hàng mới tạo, hãy sử dụng yêu cầu HTTP POST sau đây và thêm mã uỷ quyền:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "TRIAL"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_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.
  • SKU_ID: Mã nhận dạng đơn vị lưu kho (SKU) duy nhất. Để biết thêm thông tin, hãy xem bài viết Sản phẩm và mã SKU.
  • PURCHASE_ORDER_ID: Mã đơn hàng không bắt buộc mà bạn có thể dùng để theo dõi việc sử dụng.

Dưới đây là ví dụ về phản hồi gói dùng thử miễn phí 30 ngày:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "TRIAL",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10,
    "licensedNumberOfSeats": 0
  },
  "trialSettings": {
    "isInTrial": true,
    "trialEndTime": "1331648420142"
  },
  "purchaseOrderId": "my_example_trial_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

Tạo gói thuê bao chiết khấu

Google có thể cung cấp mã ưu đãi để tạo gói thuê bao ở mức giá chiết khấu. Để chiết khấu gói thuê bao, bạn phải cung cấp mã ưu đãi trong lệnh gọi insert của gói thuê bao. Nếu khách hàng thay đổi từ SKU ban đầu, thì khoản chiết khấu sẽ bị xoá.

Để tạo gói thuê bao cam kết hằng năm có chiết khấu cho tài khoản của khách hàng mới tạo, hãy sử dụng yêu cầu HTTP POST sau đây và thêm mã thông báo uỷ quyền:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  renewalSettings: {
    "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID",
  "dealCode": "GOOGLE_CONTRACT_DEAL_CODE"
}

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.
  • SKU_ID: Mã nhận dạng đơn vị lưu kho (SKU) duy nhất. Để biết thêm thông tin, hãy xem bài viết Sản phẩm và mã SKU.
  • PURCHASE_ORDER_ID: Mã đơn hàng không bắt buộc mà bạn có thể dùng để theo dõi việc sử dụng.
  • GOOGLE_CONTRACT_DEAL_CODE: Mã giảm giá do Google cung cấp.

Sau đây là ví dụ về phản hồi cho gói chiết khấu hằng năm:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "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": "my_example.com_annual_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "dealCode": "GOOGLE_CONTRACT_DEAL_CODE",
  "skuName": "Google Workspace Business Standard"
}

Chuyển gói thuê bao

Nếu bạn không đặt hàng tài khoản của khách hàng bằng thao tác đặt hàng tài khoản khách hàng mới, hãy sử dụng mã chuyển của khách hàng khi tạo gói thuê bao cho khách hàng đó.

Để tạo gói thuê bao cho một tài khoản khách hàng mà bạn không đặt hàng, 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?customerAuthToken=TOKEN_VALUE

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.
  • TOKEN_VALUE: Mã chuyển do khách hàng của bạn cung cấp. Sau khi khách hàng tạo mã thông bá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 nhận mã thông báo chuyển, hãy xem trung tâm trợ giúp của Google Workspace.

Để chuyển gói thuê bao của một khách hàng sử dụng gói cam kết hằng năm, hãy sử dụng yêu cầu HTTP POST sau đây và thêm mã thông báo uỷ quyền:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions?customerAuthToken=auth token
{
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_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.
  • SKU_ID: Mã nhận dạng đơn vị lưu kho (SKU) duy nhất. Để biết thêm thông tin, hãy xem bài viết Sản phẩm và mã SKU.
  • PURCHASE_ORDER_ID: Mã đơn hàng không bắt buộc mà bạn có thể dùng để theo dõi việc sử dụng.

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200 và chế độ cài đặt của gói thuê bao đã chuyển đối với gói cam kết hằng năm:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "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": "example.com_annual_1",
  "status": "ACTIVE",
  "resourceUiUrl": "URL to customer's Admin console dashboard",
  "skuName": "Google Workspace Business Standard"
}

Giới hạn chuyển

Nếu bạn chuyển một gói thuê bao của Google Workspace sang một gói thuê bao Google Drive hoặc Google Vault được liên kết, hãy sử dụng thao tác batch để chuyển tất cả các gói thuê bao có trạng thái ACTIVE. Việc chuyển từng gói thuê bao từng gói thuê bao sẽ dẫn đến một lỗi.

Chỉ được phép chuyển các gói thuê bao bị tạm ngưng nếu lý do tạm ngưng là PENDING_TOS_ACCEPTANCE, TRIAL_ENDED hoặc RENEWAL_WITH_TYPE_CANCEL.

Khi chuyển một SKU cũ, subscriptions.list sẽ trả về một skuId của SKU cần được chuyển. skuId của SKU mà khách hàng đã nhận được trả về dưới dạng transferInfo.currentLegacySkuId. Để xem danh sách đầy đủ skuIds và những sản phẩm được các gói này sử dụng, hãy xem phần Sản phẩm và SKU.

Bạn không thể chuyển thẻ và mã ưu đãi giảm giá.