Membuat atau mentransfer langganan

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

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

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

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

Pelanggan dengan customerType = 'team' hanya dapat membeli edisi Essentials dan Enterprise Essentials Google Workspace. 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 mengetahui informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID pesanan pembelian opsional yang dapat Anda gunakan untuk melacak penggunaan.

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

Berikut adalah contoh respons rencana 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 paket 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 mengetahui informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID pesanan pembelian 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 mengetahui informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID pesanan pembelian 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 mendiskon langganan, Anda harus memberikan kode promo dalam panggilan langganan insert. Jika pelanggan beralih dari SKU aslinya, diskon akan dihapus.

Untuk membuat langganan komitmen tahunan diskon 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": "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 mengetahui informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID pesanan pembelian 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 order a new customer account, 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 pelanggan membuat token, token tersebut akan berlaku 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 mengetahui informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID pesanan pembelian 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 menggunakan paket ini, lihat Produk dan SKU.

Transfer tidak berfungsi dengan kode penawaran diskon.