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

Nếu bạn không đặt hàng bằ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 Essentials và Các phiên bản 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ẽ nhận được lỗi—Customer is not eligible to purchase this subscription. Khách hàng việc mua Essentials hoặc gói thuê bao theo 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ó các lựa chọn nâng cấp và hạ cấp giới hạn.

Tạo gói thuê bao

Để tạo gói thuê bao cho tài khoản khách hàng mới tạo, hãy sử dụng sau yêu cầu HTTP POST và đưa vào 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 gói thuê bao cam kết hằng năm, không phải tất cả SKU đều giống nhau cài đặt gia hạn mặc định. Bạn nên luôn truyền renewalSettings. Sáng tạo gói thuê bao cam kết hằng năm với 10 người dùng:

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

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

Sau đây là ví dụ về nội dung 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 kế hoạch linh hoạt

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

Sau đây là ví dụ về 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 đăng ký dùng thử miễn phí 30 ngày cho tài khoản của bạn, hãy sử dụng yêu cầu HTTP POST sau và bao gồm yêu cầu mã thông bá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ế đ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.
  • SKU_ID: Đơn vị lưu kho duy nhất (SKU) giá trị nhận dạng. Để biết thêm thông tin, hãy xem Sản phẩm và Mã SKU.
  • PURCHASE_ORDER_ID: Đơn đặt hàng không bắt buộc Mã nhận dạng mà bạn có thể dùng để theo dõi việc sử dụng.

Sau đây là ví dụ về phản hồi đối vớ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 được 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 cho một gói thuê bao, bạn phải cung cấp mã ưu đãi bằng cuộc gọi insert đăng ký. Nếu khách hàng thay đổi từ SKU ban đầu, thì khoản 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 một gói thuê bao mới tạo tài khoản của khách hàng, hãy sử dụng yêu cầu HTTP POST sau và đưa vào 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ế đ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.
  • SKU_ID: Đơn vị lưu kho duy nhất (SKU) giá trị nhận dạng. Để biết thêm thông tin, hãy xem Sản phẩm và Mã SKU.
  • PURCHASE_ORDER_ID: Đơn đặt hàng không bắt buộc Mã nhận dạng mà bạn có thể dùng để theo dõi việc sử dụng.
  • GOOGLE_CONTRACT_DEAL_CODE: Có mã giảm giá từ Google.

Sau đây là ví dụ về phản hồi của 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 đặt hàng một tài khoản khách hàng mới hoạt động, hãy sử dụng mã chuyển của khách hàng khi tạo đăng ký 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 sau đây là yêu cầu HTTP POST:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE

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.
  • TOKEN_VALUE: Mã chuyển do bạn cung cấp khách hàng. Sau khi khách hàng tạo mã, mã này 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 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 sau yêu cầu HTTP POST và đưa vào 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ế đ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.
  • SKU_ID: Đơn vị lưu kho duy nhất (SKU) giá trị nhận dạng. Để biết thêm thông tin, hãy xem Sản phẩm và Mã SKU.
  • PURCHASE_ORDER_ID: Đơn đặt hàng không bắt buộc Mã nhận dạng 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à các chế độ cài đặt của gói thuê bao được chuyển cho một 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 với một Google Drive được liên kết 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. Đang chuyển từng 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 SKU cũ, subscriptions.list sẽ trả về một skuId của SKU cần được chuyển. skuIdcủa SKU mà khách hàng thực tế đã được trả về là transferInfo.currentLegacySkuId. Đối với danh sách đầy đủ skuIds và những sản phẩm mà các gói này sử dụng, hãy xem Sản phẩm và SKU.

Không thể chuyển khoản tín dụng cho mã ưu đãi chiết khấu.