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 cam kết hằng năm
  • Gói thuê bao linh hoạt
  • Dùng thử miễn phí 30 ngày
  • Gói thuê bao được giảm giá

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

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

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ố gắng mua bất kỳ gói thuê bao Google Workspace nào khác, bạn sẽ gặp lỗi Customer is not eligible to purchase this subscription. Khách hàng mua gói thuê bao 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ó ít lựa chọn nâng cấp và hạ cấp.

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à thê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 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.

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

Đối với 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 truyền renewalSettings. Tạo gói thuê bao cam kết hằng năm có 10 chỗ:

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ế nội dung 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: Giá trị 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 đặt hàng không bắt buộc mà bạn có thể dùng để theo dõi mứ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 gói thuê bao mới cho gói cam kết hằng năm. ANNUAL_MONTHLY_PAY được trả về dưới dạng ANNUAL trong tất cả các phản hồi API.

Sau đây là ví dụ về phản hồi của 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 một 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à 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": "FLEXIBLE"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Thay thế nội dung 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: Giá trị 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 đặt hàng không bắt buộc mà bạn có thể dùng để theo dõi mức sử dụng.

Sau đây là ví dụ về một phản hồi của gói 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í trong 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ã 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": "TRIAL"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Thay thế nội dung 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: Giá trị 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 đặt hàng không bắt buộc mà bạn có thể dùng để theo dõi mức sử dụng.

Sau đây là ví dụ về phản hồi của 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 với mức chiết khấu. Để chiết khấu một 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 SKU ban đầu, thì chiết khấu sẽ bị xoá.

Để tạo một 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ế nội dung 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: Giá trị 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 đặt hàng không bắt buộc mà bạn có thể dùng để theo dõi mức sử dụng.
  • GOOGLE_CONTRACT_DEAL_CODE: Mã chiết khấu do Google cung cấp.

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

{
  "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ã thông báo 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ế nội dung 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 được 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 khách hàng sử dụng gói cam kết 1 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ế nội dung 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: Giá trị 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 đặt hàng không bắt buộc mà bạn có thể dùng để theo dõi mứ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 cam kết hằng năm được chuyển nhượng:

{
  "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"
}

Quy định hạn chế đối với việc chuyển miền

Nếu bạn đang chuyển một gói thuê bao Google Workspace có liên kết với gói thuê bao Google Drive hoặc Google Vault, 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 sẽ dẫn đến lỗi.

Bạn chỉ được phép chuyển 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 thực sự có sẽ được trả về dưới dạng transferInfo.currentLegacySkuId. Để xem danh sách đầy đủ về skuIds và những sản phẩm mà 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 mã ưu đãi chiết khấu.