Membuat atau mentransfer langganan

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

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

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

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

Pelanggan dengan customerType = 'team' hanya dapat membeli Google Workspace edisi 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 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 dapat berupa nama domain primer pelanggan atau ID unik pelanggan yang ditampilkan saat mengambil akun pelanggan reseller.

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 slot:

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 primer pelanggan atau ID unik pelanggan.
  • SKU_ID: ID unik unit penyimpanan stok (SKU). Untuk informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID pesanan pembelian (PO) 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 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"
}

Buat 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 primer pelanggan atau ID unik pelanggan.
  • SKU_ID: ID unik unit penyimpanan stok (SKU). Untuk informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID pesanan pembelian (PO) 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"
}

Buat uji coba gratis

Untuk membuat langganan uji coba gratis 30 hari 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": "TRIAL"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Ganti kode berikut:

  • CUSTOMER_ID: Nama domain primer pelanggan atau ID unik pelanggan.
  • SKU_ID: ID unik unit penyimpanan stok (SKU). Untuk informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID pesanan pembelian (PO) 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 dapat memberikan kode promo untuk membuat langganan dengan tarif diskon. Untuk memberikan diskon langganan, Anda harus memberikan kode promo dalam panggilan insert langganan. Jika pelanggan berubah dari SKU aslinya, diskon tersebut 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 primer pelanggan atau ID unik pelanggan.
  • SKU_ID: ID unik unit penyimpanan stok (SKU). Untuk informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID pesanan pembelian (PO) 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 pesan 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 primer pelanggan atau ID unik pelanggan.
  • TOKEN_VALUE: Token transfer yang diberikan oleh pelanggan. Setelah pelanggan membuat token, token tersebut akan 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 primer pelanggan atau ID unik pelanggan.
  • SKU_ID: ID unik unit penyimpanan stok (SKU). Untuk informasi selengkapnya, lihat ID Produk & SKU.
  • PURCHASE_ORDER_ID: ID pesanan pembelian (PO) 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 menghasilkan error.

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

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

Transfer tidak berfungsi dengan kode promo diskon.