Müşteri hesabı sipariş ettikten sonra<0x0x0A>ç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ünü inceleyin.
Bu müşterinin hesabını siz sipariş etmediyseniz abonelik aktarabilirsiniz.
customerType = 'team'
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ıştığınızda Customer is not eligible to purchase this subscription
hatasını alırsınız. Essentials veya kullanıma dayalı abonelik satın alan müşteriler, Yıllık Taahhüt planlarını kullanamayabilir ve yükseltme ile düşürme seçenekleri sınırlı 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
, yeniden satılan bir müşterinin hesabı alınırken döndürülen müşterinin birincil alan adı veya 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 aynı varsayılan yenileme ayarlarına sahip değildir. Her zaman renewalSettings
parametresini iletmenizi öneririz. 10 koltuklu yıllık taahhüt aboneliği oluşturma:
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 başlıklı makaleyi inceleyin.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, 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 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 plan oluşturma
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 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 başlıklı makaleyi inceleyin.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 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 başlıklı makaleyi inceleyin.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, abonelikleri indirimli fiyata oluşturmak için bir fırsat kodu sağlayabilir. 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üş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 başlıklı makaleyi inceleyin.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 alınan bir indirim kodu.
Aşağıda, indirimli 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",
"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 bu 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 jetonu oluşturduktan sonra 30 gün boyunca geçerlidir.
Müşterilerin nasıl aktarım jetonu alacağı 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 başlıklı makaleyi inceleyin.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, HTTP 200
durum kodu ve yıllık taahhüt planı için 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ı
Google Drive veya Google Vault aboneliğiyle ilişkili bir Google Workspace aboneliğini aktarıyorsanız ACTIVE
durumundaki tüm abonelikleri aktarmak için batch
işlemini kullanın. Her aboneliği tek tek aktarmak 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
ise izin verilir.
Eski bir SKU aktarılı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
'nın tam listesi ve bu planlarda kullanılan ürünler için Ürünler ve SKU'lar bölümüne bakın.
Transferler, indirim fırsatı kodlarıyla çalışmaz.