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
  • Bản dùng thử miễn phí 30 ngày
  • Gói thuê bao được chiết khấu

Để 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 Sản phẩm và SKU.

Nếu không đặt hàng tài khoản của khách hàng, 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 Google Workspace Essentials và Google Workspace Enterprise Essentials của Google Workspace. Nếu bạn 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 không đủ điều kiện mua gói thuê bao này). 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 sử dụng đượ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, hãy sử dụng yêu cầu HTTP POST sau đây và đưa mã thông báo uỷ quyền vào:

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 gói thuê bao cam kết hằng năm, không phải tất cả SKU đều 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 duy nhất của đơn vị lưu kho (SKU). Để biết thêm thông tin, hãy xem 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 của 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ả phản hồi của 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 gói thuê bao linh hoạt cho tài khoản của khách hàng mới, hãy sử dụng yêu cầu HTTP POST sau đây và đưa mã thông báo uỷ quyền vào:

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 duy nhất của đơn vị lưu kho (SKU). Để biết thêm thông tin, hãy xem 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 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, hãy sử dụng yêu cầu HTTP POST sau đây và đưa mã thông báo uỷ quyền vào:

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 duy nhất của đơn vị lưu kho (SKU). Để biết thêm thông tin, hãy xem 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 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ì mức 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, hãy sử dụng yêu cầu HTTP POST sau đây và đưa mã thông báo uỷ quyền vào:

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 duy nhất của đơn vị lưu kho (SKU). Để biết thêm thông tin, hãy xem 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ã giảm giá do Google cung cấp.

Sau đây là ví dụ về phản hồi của 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ã 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 tài khoản của 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 mã chuyển, hãy xem Trung tâm trợ giúp dành cho quản trị viên.

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

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 duy nhất của đơn vị lưu kho (SKU). Để biết thêm thông tin, hãy xem 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 thuê bao đã chuyển cho 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 chuyển Gói thuê bao của Google Workspace có gói thuê bao được liên kết Google Drive hoặc Google Vault, hãy sử dụng thao tác batch để chuyển tất 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ó thể 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 SKU cũ, subscriptions.list sẽ trả về skuId của SKU cần 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 đủ các skuIds và sản phẩm mà các gói này sử dụng, hãy xem bài viết Sản phẩm và SKU.

Tính năng chuyển không hoạt động với mã ưu đãi chiết khấu.