Bir müşterinin hesabı sipariş ettikten sonra bir dizi farklı abonelik oluşturabilirsiniz:
- Yıllık taahhüt aboneliği
- Esnek bir abonelik
- 30 günlük ücretsiz deneme
- İndirimli abonelik
Bu aboneliklerin kullandığı ürünler hakkında daha fazla bilgi için Ürünler ve SKU'lar bölümüne bakın.
Bu müşterinin hesabı için sipariş vermediyseniz bir aboneliği aktarabilirsiniz.
customerType = 'team'
hesabı olan müşteriler yalnızca Google Workspace'in Essentials ve Enterprise Essentials sürümlerini satın alabilir. Diğer Google Workspace aboneliklerinden herhangi birini satın almaya çalışırsanız şu hatayı alırsınız: Customer is not eligible to purchase this subscription
. Essentials veya kullanıma dayalı abonelikler satın alan müşteriler Yıllık Taahhüt planlarını kullanamayabilir ve sınırlı yükseltme ve düşürme seçeneklerine sahip olabilir.
Abonelik oluşturma
Yeni oluşturulan bir müşteri hesabı için abonelik oluşturmak amacıyla aşağıdaki POST
HTTP isteğini kullanın ve yetkilendirme jetonunu ekleyin:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
CUSTOMER_ID
, müşterinin birincil alan adı veya yeniden satış yapılan bir müşterinin hesabı alınırken döndürülen benzersiz alan adıdır.
Yıllık taahhüt planı oluşturma
Yıllık taahhüt planı abonelikleri için tüm SKU'lar aynı varsayılan yenileme ayarlarına sahip değildir. renewalSettings
adlı belgeyi her zaman geçmenizi öneririz. 10 lisansı olan bir yıllık taahhüt aboneliği oluşturun:
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" }
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alan adı veya benzersiz tanımlayıcısı.SKU_ID
: Benzersiz stok tutma birimi (SKU) tanımlayıcısı. Daha fazla bilgi için Ürünler ve SKU kimlikleri bölümüne bakın.PURCHASE_ORDER_ID
: Kullanımı takip etmek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliğidir.
Başarılı bir yanıt, HTTP 200
durumunu ve yıllık taahhüt planı için yeni aboneliğin ayarlarını döndürür. ANNUAL_MONTHLY_PAY
, tüm API yanıtlarında ANNUAL
olarak döndürülür.
Aşağıda, yıllık plan yanıtına bir örnek verilmiştir:
{
"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"
}
Esnek plan oluşturun
Yeni oluşturulan bir müşteri hesabında esnek abonelik oluşturmak için aşağıdaki POST
HTTP isteğini kullanın ve yetkilendirme jetonunu ekleyin:
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" }
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alan adı veya benzersiz tanımlayıcısı.SKU_ID
: Benzersiz stok tutma birimi (SKU) tanımlayıcısı. Daha fazla bilgi için Ürünler ve SKU kimlikleri bölümüne bakın.PURCHASE_ORDER_ID
: Kullanımı takip etmek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliğidir.
Aşağıda, bir esnek plan yanıtı örneği verilmiştir:
{
"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"
}
Ücretsiz deneme oluşturun
Yeni oluşturulan bir müşterinin hesabı için 30 günlük ücretsiz deneme aboneliği oluşturmak amacıyla aşağıdaki POST
HTTP isteğini kullanın ve yetkilendirme jetonunu ekleyin:
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" }
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alan adı veya benzersiz tanımlayıcısı.SKU_ID
: Benzersiz stok tutma birimi (SKU) tanımlayıcısı. Daha fazla bilgi için Ürünler ve SKU kimlikleri bölümüne bakın.PURCHASE_ORDER_ID
: Kullanımı takip etmek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliğidir.
Aşağıda, 30 günlük ücretsiz deneme planına ilişkin bir yanıt örneği verilmiştir:
{
"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"
}
İndirim aboneliği oluşturma
Google, indirimli fiyatla abonelik oluşturmak için bir fırsat kodu sağlayabilir. Bir abonelikte indirim yapmak için abonelik insert
çağrısında fırsat kodunu sağlamanız gerekir. Müşteri orijinal SKU'sunu değiştirirse indirim kaldırılır.
Yeni oluşturulan bir müşteri hesabı için indirimli yıllık taahhüt aboneliği oluşturmak istiyorsanız aşağıdaki POST
HTTP isteğini kullanın ve yetkilendirme jetonunu ekleyin:
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" }
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alan adı veya benzersiz tanımlayıcısı.SKU_ID
: Benzersiz stok tutma birimi (SKU) tanımlayıcısı. Daha fazla bilgi için Ürünler ve SKU kimlikleri bölümüne bakın.PURCHASE_ORDER_ID
: Kullanımı takip etmek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliğidir.GOOGLE_CONTRACT_DEAL_CODE
: Google'ın sunduğu bir indirim kodudur.
Aşağıda, indirimli yıllık plan yanıtına bir örnek verilmiştir:
{
"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"
}
Aboneliği aktarma
Müşterinin hesabını yeni müşteri hesabı sipariş etme işlemini kullanarak sipariş etmediyseniz bu müşteri için abonelik oluştururken müşterinin aktarım jetonunu kullanın.
Sipariş vermediğiniz bir müşteri hesabı için abonelik oluşturmak istiyorsanız aşağıdaki POST
HTTP isteğini kullanın:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alan adı veya benzersiz tanımlayıcısı.TOKEN_VALUE
: Müşteriniz tarafından sağlanan bir aktarım jetonu. Müşteri jetonu oluşturduktan sonra jeton 30 gün boyunca geçerlidir.
Müşterilerin aktarım jetonunu nasıl aldığı hakkında daha fazla bilgi edinmek için Google Workspace Yardım Merkezi'ne göz atın.
Yıllık taahhüt planı müşterisinin aboneliğini aktarmak için aşağıdaki POST
HTTP isteğini kullanın ve yetkilendirme jetonunu ekleyin:
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" }
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alan adı veya benzersiz tanımlayıcısı.SKU_ID
: Benzersiz stok tutma birimi (SKU) tanımlayıcısı. Daha fazla bilgi için Ürünler ve SKU kimlikleri bölümüne bakın.PURCHASE_ORDER_ID
: Kullanımı takip etmek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliğidir.
Başarılı bir yanıt, yıllık taahhüt planı için bir HTTP 200
durum kodu ve aktarılan aboneliğin ayarlarını döndürür:
{
"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"
}
Aktarım sınırlamaları
İlişkilendirilmiş bir Google Drive veya Google Apps Kasası aboneliğiyle bir Google Workspace aboneliğini aktarıyorsanız ACTIVE
durumundaki tüm abonelikleri aktarmak için batch
işlemini kullanın. Her aboneliğin tek tek aktarılması hataya neden olur.
Askıya alınmış aboneliklerin aktarılmasına yalnızca askıya alma nedeni PENDING_TOS_ACCEPTANCE
, TRIAL_ENDED
veya RENEWAL_WITH_TYPE_CANCEL
olduğunda izin verilir.
Eski bir SKU'yu aktarırken subscriptions.list
, aktarılması gereken SKU'nun skuId
kadarını döndürür. Müşterinin gerçekten sahip olduğu SKU'nun skuId
transferInfo.currentLegacySkuId
olarak döndürülür. skuIds
listesinin tam listesini ve bu planların hangi ürünleri kullandığını görmek için Ürünler ve SKU'lar bölümüne bakın.
İndirim fırsat kodlarıyla aktarımlar yapılamaz.