Müşteri hesabı sipariş ettikten sonra çeşitli abonelikler oluşturabilirsiniz:
- Yıllık taahhüt aboneliği
- Esnek 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ını sipariş etmediyseniz abonelik aktarabilirsiniz.
customerType = 'team' lisansına sahip müşteriler yalnızca Google Workspace Essentials ve Enterprise Essentials sürümlerini satın alabilir. Diğer Google Workspace aboneliklerinden birini satın almaya çalışırsanız Customer is not eligible to purchase this subscription hatası alırsınız. 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üşterinin hesabı için abonelik oluşturmak üzere 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ıdır veya yeniden satılan bir müşterinin hesabı alınırken müşterinin benzersiz tanımlayıcısıdır.
Yıllık taahhüt planı oluşturma
Yıllık taahhüt planı aboneliklerinde tüm SKU'lar için aynı varsayılan yenileme ayarları geçerli değildir. Her zaman renewalSettings değerini iletmenizi öneririz. 10 koltuk içeren 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 müşterinin 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ı izlemek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliği.
Başarılı bir yanıt, yıllık taahhüt planı için HTTP 200 durumu ve 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 dair 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 bir plan oluşturma
Yeni oluşturulan bir müşterinin hesabı için esnek abonelik oluşturmak üzere 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 müşterinin 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ı izlemek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliği.
Aşağıda, esnek plan yanıtına dair bir örnek 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 sürümü oluşturma
Yeni oluşturulan bir müşterinin hesabı için 30 günlük ücretsiz deneme aboneliği oluşturmak üzere 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 müşterinin 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ı izlemek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliği.
Aşağıda, 30 günlük ücretsiz deneme planı 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"
}
İndirimli abonelik oluşturma
Google, indirimli fiyatla abonelik oluşturmak için bir fırsat kodu sağlayabilir. Bir aboneliğe indirim uygulamak 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üşterinin hesabı için indirimli yıllık taahhüt aboneliği oluşturmak üzere 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 müşterinin 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ı izlemek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliği.GOOGLE_CONTRACT_DEAL_CODE: Google'dan kullanılabilen bir indirim kodu.
Aşağıda, yıllık plan indirimi yanıtına dair 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"
}
Abonelik aktarma
Müşterinin hesabını yeni müşteri hesabı sipariş etme işlemini kullanarak sipariş etmediyseniz söz konusu müşteri için abonelik oluştururken müşterinin aktarım jetonunu kullanın.
Sipariş etmediğiniz bir müşteri hesabı için abonelik oluşturmak üzere 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 müşterinin benzersiz tanımlayıcısı.TOKEN_VALUE: Müşteriniz tarafından sağlanan bir aktarım jetonu. Müşteri tarafından oluşturulan jeton 30 gün boyunca geçerlidir.
Müşterilerin aktarım jetonu alma hakkında daha fazla bilgi için Google Workspace Yardım Merkezi'ne bakı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 müşterinin 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ı izlemek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliği.
Başarılı bir yanıt, yıllık taahhüt planı için HTTP 200 durum kodunu 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şkili bir Google Drive veya Google Vault aboneliğiyle birlikte bir Google Workspace aboneliği aktarıyorsanız ACTIVE durumu olan tüm abonelikleri aktarmak için batch işlemini kullanın. Abonelikleri tek tek aktarmak hatayla sonuçlanır.
Askıya alınmış aboneliklerin aktarılmasına yalnızca askıya alınma nedeni PENDING_TOS_ACCEPTANCE, TRIAL_ENDED veya RENEWAL_WITH_TYPE_CANCEL ise izin verilir.
Eski bir SKU'yu aktarırken subscriptions.list, aktarılması gereken SKU'nun skuId değerini döndürür. Müşterinin sahip olduğu SKU'nun skuId değeri transferInfo.currentLegacySkuId olarak döndürülür. skuIds planlarının ve bu planların hangi ürünlerde kullanıldığının tam listesi için Ürünler ve SKU'lar bölümüne bakın.
Aktarımlar, indirim fırsatı kodlarıyla çalışmaz.