Membuat atau mentransfer langganan

Setelah memesan akun pelanggan, Anda dapat membuat sejumlah langganan yang berbeda:

  • Langganan komitmen tahunan
  • Langganan fleksibel
  • Uji coba gratis selama 30 hari
  • Langganan dengan diskon

Untuk mengetahui informasi selengkapnya tentang produk yang digunakan langganan ini, lihat Produk dan SKU.

Jika tidak memesan akun pelanggan ini, Anda dapat mentransfer langganan.

Pelanggan dengan customerType = 'team' hanya dapat membeli edisi Google Workspace Essentials dan Enterprise Essentials. Jika Anda mencoba membeli langganan Google Workspace lainnya, Anda akan mendapatkan error—Customer is not eligible to purchase this subscription. Pelanggan yang membeli langganan Essentials atau langganan berbasis penggunaan mungkin tidak dapat menangani paket Komitmen Tahunan dan memiliki opsi upgrade dan downgrade yang terbatas.

Membuat langganan

Untuk membuat langganan bagi akun pelanggan yang baru dibuat, gunakan permintaan HTTP POST berikut dan sertakan token otorisasi:

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

CUSTOMER_ID adalah nama domain utama pelanggan atau ID unik pelanggan yang ditampilkan saat mengambil akun pelanggan yang dijual kembali.

Membuat paket komitmen tahunan

Untuk langganan paket komitmen tahunan, tidak semua SKU memiliki setelan perpanjangan default yang sama. Sebaiknya selalu teruskan renewalSettings. Buat langganan komitmen tahunan dengan 10 kursi:

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

Ganti kode berikut:

  • CUSTOMER_ID: Nama domain utama pelanggan atau ID unik pelanggan.
  • SKU_ID: ID unit penyimpanan stok (SKU) unik. Untuk informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID purchase order opsional yang dapat Anda gunakan untuk melacak penggunaan.

Respons yang berhasil akan menampilkan status 200 HTTP dan setelan langganan baru untuk paket komitmen tahunan. ANNUAL_MONTHLY_PAY ditampilkan sebagai ANNUAL di semua respons API.

Berikut adalah contoh respons paket tahunan:

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

Membuat rencana yang fleksibel

Untuk membuat langganan fleksibel bagi akun pelanggan yang baru dibuat, gunakan permintaan HTTP POST berikut dan sertakan token otorisasi:

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

Ganti kode berikut:

  • CUSTOMER_ID: Nama domain utama pelanggan atau ID unik pelanggan.
  • SKU_ID: ID unit penyimpanan stok (SKU) unik. Untuk informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID purchase order opsional yang dapat Anda gunakan untuk melacak penggunaan.

Berikut adalah contoh respons paket fleksibel:

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

Membuat uji coba gratis

Untuk membuat langganan uji coba gratis 30 hari untuk akun pelanggan yang baru dibuat, gunakan permintaan HTTP POST berikut dan sertakan token otorisasi:

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

Ganti kode berikut:

  • CUSTOMER_ID: Nama domain utama pelanggan atau ID unik pelanggan.
  • SKU_ID: ID unit penyimpanan stok (SKU) unik. Untuk informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID purchase order opsional yang dapat Anda gunakan untuk melacak penggunaan.

Berikut adalah contoh respons paket uji coba gratis 30 hari:

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

Membuat langganan diskon

Google mungkin memberikan kode promo untuk membuat langganan dengan tarif diskon. Untuk memberikan diskon langganan, Anda harus memberikan kode promo dalam panggilan insert langganan. Jika pelanggan mengubah dari SKU asli, diskon akan dihapus.

Untuk membuat langganan komitmen tahunan diskon bagi akun pelanggan yang baru dibuat, gunakan permintaan HTTP POST berikut dan sertakan token otorisasi:

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

Ganti kode berikut:

  • CUSTOMER_ID: Nama domain utama pelanggan atau ID unik pelanggan.
  • SKU_ID: ID unit penyimpanan stok (SKU) unik. Untuk informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID purchase order opsional yang dapat Anda gunakan untuk melacak penggunaan.
  • GOOGLE_CONTRACT_DEAL_CODE: Kode diskon yang tersedia dari Google.

Berikut adalah contoh respons paket tahunan diskon:

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

Mentransfer langganan

Jika Anda tidak memesan akun pelanggan menggunakan operasi memesan akun pelanggan baru, gunakan token transfer pelanggan saat membuat langganan untuk pelanggan tersebut.

Untuk membuat langganan bagi akun pelanggan yang tidak Anda pesan, gunakan permintaan HTTP POST berikut:

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

Ganti kode berikut:

  • CUSTOMER_ID: Nama domain utama pelanggan atau ID unik pelanggan.
  • TOKEN_VALUE: Token transfer yang diberikan oleh pelanggan Anda. Setelah dibuat oleh pelanggan, token tersebut valid selama 30 hari.

Untuk mengetahui informasi selengkapnya tentang cara pelanggan mendapatkan token transfer, lihat pusat bantuan Google Workspace.

Untuk mentransfer langganan pelanggan paket komitmen tahunan, gunakan permintaan HTTP POST berikut dan sertakan token otorisasi:

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

Ganti kode berikut:

  • CUSTOMER_ID: Nama domain utama pelanggan atau ID unik pelanggan.
  • SKU_ID: ID unit penyimpanan stok (SKU) unik. Untuk informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID purchase order opsional yang dapat Anda gunakan untuk melacak penggunaan.

Respons yang berhasil akan menampilkan kode status HTTP 200 dan setelan langganan yang ditransfer untuk paket komitmen tahunan:

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

Batasan transfer

Jika mentransfer langganan Google Workspace dengan langganan Google Drive atau Google Vault terkait, gunakan operasi batch untuk mentransfer semua langganan dengan status ACTIVE. Mentransfer setiap langganan satu per satu akan menyebabkan error.

Transfer langganan yang ditangguhkan hanya diizinkan jika alasan penangguhannya adalah PENDING_TOS_ACCEPTANCE, TRIAL_ENDED, atau RENEWAL_WITH_TYPE_CANCEL.

Saat mentransfer SKU lama, subscriptions.list menampilkan skuId SKU yang perlu ditransfer. skuId SKU yang sebenarnya dimiliki pelanggan ditampilkan sebagai transferInfo.currentLegacySkuId. Untuk mengetahui daftar lengkap skuIds dan produk yang digunakan oleh paket ini, lihat Produk dan SKU.

Transfer tidak berfungsi dengan kode promo diskon.