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.