Membuat atau mentransfer langganan

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

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

Untuk 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 Essentials dan Google Workspace edisi Enterprise Essentials. Jika Anda mencoba membeli langganan Google Workspace lainnya, Anda akan mendapatkan error—Customer is not eligible to purchase this subscription. Pelanggan membeli langganan Essentials atau berbasis penggunaan mungkin tidak dapat ditangani Paket Komitmen Tahunan dan memiliki opsi upgrade serta downgrade yang terbatas.

Membuat langganan

Untuk membuat langganan bagi akun pelanggan yang baru dibuat, gunakan permintaan HTTP POST berikut dan menyertakan 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 atribut yang sama setelan perpanjangan default. Sebaiknya selalu teruskan renewalSettings. Berkreasi 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: Domain primer pelanggan atau ID unik pelanggan.
  • SKU_ID: Unit penyimpanan saham (SKU) yang unik yang sesuai. Untuk informasi selengkapnya, lihat Produk & ID SKU.
  • PURCHASE_ORDER_ID: Pesanan pembelian (PO) opsional ID yang dapat Anda gunakan untuk melacak penggunaan.

Respons yang berhasil akan menampilkan status 200 HTTP dan status langganan yang 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 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: Domain primer pelanggan atau ID unik pelanggan.
  • SKU_ID: Unit penyimpanan saham (SKU) yang unik yang sesuai. Untuk informasi selengkapnya, lihat Produk & ID SKU.
  • PURCHASE_ORDER_ID: Pesanan pembelian (PO) opsional ID 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 langganan pelanggan yang baru dibuat akun Anda, gunakan permintaan HTTP POST berikut dan sertakan otorisasi token:

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: Domain primer pelanggan atau ID unik pelanggan.
  • SKU_ID: Unit penyimpanan saham (SKU) yang unik yang sesuai. Untuk informasi selengkapnya, lihat Produk & ID SKU.
  • PURCHASE_ORDER_ID: Pesanan pembelian (PO) opsional ID 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"
}

Buat langganan diskon

Google mungkin memberikan kode promo untuk membuat langganan dengan harga diskon besar. Untuk memberikan diskon pada langganan, Anda harus memberikan kode transaksi di panggilan insert langganan. Jika pelanggan berubah dari SKU asli, diskon akan dihapus.

Untuk membuat langganan komitmen tahunan berdiskon untuk langganan yang baru dibuat gunakan permintaan HTTP POST berikut, lalu 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: Domain primer pelanggan atau ID unik pelanggan.
  • SKU_ID: Unit penyimpanan saham (SKU) yang unik yang sesuai. Untuk informasi selengkapnya, lihat Produk & ID SKU.
  • PURCHASE_ORDER_ID: Pesanan pembelian (PO) opsional ID yang dapat Anda gunakan untuk melacak penggunaan.
  • GOOGLE_CONTRACT_DEAL_CODE: Kode diskon tersedia dari Google.

Berikut adalah contoh respons paket tahunan dengan 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 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: Domain primer pelanggan atau ID unik pelanggan.
  • TOKEN_VALUE: Token transfer yang disediakan oleh juga merupakan pelanggan Google Workspace. Setelah pelanggan membuat token, token tersebut akan berlaku selama 30 hari.

Untuk 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 menyertakan 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: Domain primer pelanggan atau ID unik pelanggan.
  • SKU_ID: Unit penyimpanan saham (SKU) yang unik yang sesuai. Untuk informasi selengkapnya, lihat Produk & ID SKU.
  • PURCHASE_ORDER_ID: Pesanan pembelian (PO) opsional ID yang dapat Anda gunakan untuk melacak penggunaan.

Respons yang berhasil akan menampilkan status 200 HTTP kode langganan 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 Google Drive terkait atau langganan Google Vault, gunakan Operasi batch untuk mentransfer semua langganan dengan status ACTIVE. Mentransfer setiap langganan satu per satu akan menimbulkan error.

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

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

Transfer tidak dapat digunakan dengan kode promo diskon.