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:

  • Gói thuê bao cam kết hằng năm
  • Gói thuê bao linh hoạt
  • 30 ngày dùng thử miễn phí
  • Gói thuê bao có chiết khấu

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

Nếu không phải là người đặt hàng cho 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 phiên bản Essentials và phiên bản Enterprise Essentials của Google Workspace. Nếu cố gắng mua gói thuê bao Google Workspace khác, bạn sẽ gặp lỗi Customer is not eligible to purchase this subscription. Những khách hàng mua gói Essentials hoặc gói thuê bao dựa trên mức sử dụng có thể không xử lý được cá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 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 đã 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 với 10 chỗ ngồi:

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 phần 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 200 HTTP 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ả các phản hồi API.

Sau đây là ví dụ về nội dung phản hồi cho 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 kế hoạch 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à 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": "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 phần 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 về 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í trong 30 ngày cho tài khoản mới tạo của khách hàng, 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 duy nhất của đơn vị lưu kho (SKU). Để biết thêm thông tin, hãy xem phần 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 về gói dùng thử miễn phí trong 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 có chiết khấu

Google có thể cung cấp mã ưu đãi để tạo gói thuê bao với mức giá 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ì 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 một 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 duy nhất của đơn vị lưu kho (SKU). Để biết thêm thông tin, hãy xem phần 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á của Google.

Sau đây là ví dụ về phản hồi về 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 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:

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ã thông báo chuyển do khách hàng cung cấp. Sau khi khách hàng tạo mã thông báo, mã thông báo 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 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 duy nhất của đơn vị lưu kho (SKU). Để biết thêm thông tin, hãy xem phần 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 bạn 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 toán tử 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 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 chuyển. skuId của SKU mà khách hàng thực sự có được trả về dưới dạng transferInfo.currentLegacySkuId. Để biết 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ể sử dụng mã ưu đãi chiết khấu khi chuyển.