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 skuIdtransferInfo.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.