Bir aboneliği aldıktan sonra, şuradaki bilgileri kullanabilirsiniz: şuna başarılı yanıt: abonelik durumunu değiştir veya aboneliği güncelleyebilirsiniz. Bu sayfada, Çevik yaklaşımı abonelik alma ve güncelleme.
Abonelik alma
Başarıyla sipariş edilen veya aktarılan bir aboneliği geri almak için
aşağıdaki GET
HTTP isteği ile karşılaşıyorsunuz.
GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.SUBSCRIPTION_ID
: Varsayılan abonelik kimliği her müşteri için benzersizdir. Bu değeri, Tüm bayi abonelikleri yöntemini alma
Bu işlemin istek gövdesinde parametre yok.
Başarılı bir yanıt, HTTP 200
durumu döndürüyor
ve abonelik ayarlarını değiştirebilirsiniz. Aşağıdaki örnek yanıtta,
isInTrial
özelliği false
ancak mevcut değil
trialEndTime
mülkü, yani bu müşteri daha önce hiç
Bu planla 30 günlük ücretsiz deneme süresinden yararlanın.
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"billingMethod": "ONLINE",
"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": "RENEW_CURRENT_USERS_MONTHLY_PAY"
},
"purchaseOrderId": "example.com_annual_1",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
}
Bir müşterinin tüm aboneliklerini alma
Belirli bir bayi müşterisinin, şu ana kadarki tüm aboneliklerini geri almak için
aşağıdaki GET
HTTP isteğini kullanın ve
şunları ekleyin:
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID value&pageToken=START_DATE&maxResults=MAX_NUMBER
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.START_DATE
: Şu biçimdeki başlangıç tarihi:YYYY-MM-DD
.MAX_NUMBER
: Döndürülen maksimum sonuç sayısı açıklama metni oluşturabilirsiniz.
Bu işlemin istek gövdesinde parametre yok.
Başarılı bir yanıt, bir HTTP 200
durum kodu ve
abonelik ve ayarlarına bağlıdır. Abonelik listesi şunları içerebilir:
Bayi API'sinin bu sürümünde yönetilmeyen diğer ürünleri.
Bu müşteriyi siz yönetmiyorsanız 403 "Forbidden"
hatası
geri döndü.
Bir müşteri için tüm aktarılabilir abonelikleri alma
Müşterinin olası tüm aboneliklerini almak için
Bayinin yönetimine aktarıldıysa aşağıdaki GET
HTTP isteğini kullanın
ve yetkilendirme jetonunu dahil etmelisiniz. İlgili içeriği oluşturmak için kullanılan
customerId
gereklidir ve şu durumlarda müşterinin benzersiz tanımlayıcısıdır:
yeniden satış yapılan bir müşterinin hesabını alma.
customerAuthToken
, müşteriniz tarafından sağlanan bir aktarım jetonudur ve
özel bir e-posta gönderin. Müşteri tarafından oluşturulduktan sonra
30 gün. Müşterilerin jetonu nasıl oluşturduğu hakkında daha fazla bilgi için
Google Workspace hesabınızı bir bayiye aktarın.
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID&customerAuthToken=AUTH_TOKEN&pageToken=START_DATE&maxResults=MAX_NUMBER
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.AUTH_TOKEN
: Tarafınızca sağlanan aktarım jetonu müşteri kimliğinizi belirleyebilirsiniz. Oluşturulduktan sonra 30 gün boyunca geçerlidir. Müşterilerin, ürün tesliminin nasıl devam ettiği ve jetonu oluşturmak için Google Workspace hesabınızı bir bayiye aktarın. Bu değer geçerli değilse veya süresi dolmuşsa API yanıtı bir403 "Forbidden"
hata.START_DATE
: Şu biçimdeki başlangıç tarihi:YYYY-MM-DD
.MAX_NUMBER
: Döndürülen maksimum sonuç sayısı açıklama metni oluşturabilirsiniz.
Bu işlemin istek gövdesinde parametre yok.
Başarılı bir yanıt, bir HTTP 200
durum kodu ve
aktarımın sona erme tarihiyle birlikte müşterinin aktarılabilir abonelikleri
jetonu ve aktarım siparişinde gereken minimum lisans sayısı. Müşteri
aktarılamayan ek abonelikler barındırabilir.
{
"kind": "reseller#subscriptions",
"subscriptions": [
{
"kind": "subscriptions#subscription",
"customerId": "custId-6543",
"subscriptionId": "432",
"skuId": "1010020028",
"billingMethod": "ONLINE",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"maximumNumberOfSeats": 500,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"transferInfo": {
"transferabilityExpirationTime": "1333183980142",
"minimumTransferableSeats": "20"
},
"purchaseOrderId": "PO_890",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
},
{
"kind": "subscriptions#subscription",
"customerId": "custId-6543",
"subscriptionId": "140",
"skuId": "1010020028",
"creationTime": "1329389322728",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 50
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false,
"trialEndTime": "1331877480016"
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"transferInfo": {
"transferabilityExpirationTime": "1333183780159",
"minimumTransferableSeats": "10"
},
"purchaseOrderId": "",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
},
],
"nextPageToken": "token"
}
Bu abonelikleri,
tüm abonelikleri aktarın. Her aboneliği aktarma
hataya neden olabilir. Ayrıca, toplu işlem yalnızca
ACTIVE
durumunda olan abonelikler. Daha fazla bilgi için bkz.
Aboneliği aktarma.
Tüm bayi aboneliklerini alma
Bir bayinin başarıyla sipariş edilen veya aktarılan tüm bayilerini almak için
aşağıdaki GET
HTTP isteğini kullanın ve yetkilendirme jetonunu ekleyin.
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=PREFIX &pageToken=TOKEN&maxResults=MAX_NUMBER
Aşağıdakini değiştirin:
PREFIX
: Müşteri adının başındaki aradığınız abonelikleri görebilirsiniz.TOKEN
: Sitenin belirli bir sayfasını tanımlayan jeton sunucu tarafından döndürülmesi gerekir.MAX_NUMBER
: Döndürülen maksimum sonuç sayısı açıklama metni oluşturabilirsiniz.
Bu işlem, OAuth salt okuma erişim kapsamını kullanabilir. İlgili içeriği oluşturmak için kullanılan
customerNamePrefix
, pageToken
ve maxResults
isteğe bağlı sorgu dizeleridir.
Aşağıdaki örnek, bir bayinin şu hesaba ait tüm aboneliklerini alır: adı 'exam' ile başlayan müşteriler:
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=exam
{
"kind": "reseller#subscriptions",
"subscriptions": [
{
"kind": "subscriptions#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"creationTime": "1331647980142",
"billingMethod": "ONLINE",
"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": "PO_135",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
},
{
"kind": "subscriptions#subscription",
"customerId": "custId-5678",
"subscriptionId": "1404686",
"skuId": "1010020028",
"billingMethod": "ONLINE",
"creationTime": "1329389322728",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 50,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false,
"trialEndTime": "1331877480016"
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "AUTO_RENEW"
},
"purchaseOrderId": "",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
"skuName": "Google Workspace Business Standard"
},
],
"nextPageToken": "token"
}
Abonelik planını güncelleme
Google Workspace planlarının güncellenmesi plana göre farklılık gösterir. Güncellemeden önce şunları göz önünde bulundurun:
Bir abonelik oluşturduğunuzda ve müşteri uygun hale geldiğinde, aboneliğin planı 30 günlük deneme olabilir. Hem esnek hem de yıllık taahhüt ödeme planları 30 günlük ücretsiz deneme olabilir. Deneme süresinde aboneliğin ödeme planını esnek veya yıllık olarak değiştirebilirsiniz ve taahhüt planlarını takip etmelisiniz. Deneme süresi sona erdikten ve plan planı güncellenirse, aboneliklerin etkin planlardan bahsedeceğiz. Deneme aboneliğini hemen bir aktif plan, 30 günlük ücretsiz deneme aboneliğinden ücretli hizmet başlatma. 30 günlük denemeyle ilgili daha fazla bilgi ve müşteri uygunluğu kuralları için şu sayfayı inceleyin: yönetim yardım merkezini ziyaret edin.
Esnek planı yıllık taahhüt planına güncelleyebilirsiniz.
Yıllık taahhüt planını güncelleyemezsiniz.
Bazı planlar tüm ürünlerde kullanılamaz. Hangi proje yönetimi metodolojisi bu planlar tarafından nasıl kullanıldığını görmek için Ürünler ve SKU'lar.
30 günlük deneme planlarını veya esnek plan aboneliklerini yıllık abonelik
taahhüt planı için aşağıdaki POST
HTTP isteğini kullanın:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changePlan
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.SUBSCRIPTION_ID
: Varsayılan abonelik kimliği her müşteri için benzersizdir. Bu değeri, Tüm bayi abonelikleri yöntemini alma
Aşağıdaki örnekte, abonelik subscriptionId
ile güncellenir.
olduğunu varsayalım. customerId
numarası C0123456.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changePlan
İsteğin gövdesinde şunlar bulunur:
{
"kind": "reseller#changePlanRequest",
"planName": "ANNUAL_MONTHLY_PAY",
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10
},
"purchaseOrderId": "123_March2012"
}
Başarılı bir yanıt, bir HTTP 201
durum kodu döndürür ve
abonelik planı ayarları:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"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": "123_March2012",
"status": "ACTIVE",
"skuName": "Google Workspace Business Standard"
}
Aboneliğin lisans sayısını güncelleme
Yıllık taahhüt planı aboneliğinin güncellenmesi farklı bir abonelik kullanır Google Workspace esnek plan aboneliğini güncellemekten daha fazlasıdır.
Yıllık plan aboneliği için koltukları güncelleme
Yıllık plan aboneliğinin kullanıcı lisansı ayarlarını güncellemek için aşağıdaki talimatları kullanın:
POST
HTTP isteği:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeSeats
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.SUBSCRIPTION_ID
: Varsayılan abonelik kimliği her müşteri için benzersizdir. Bu değeri, Tüm bayi abonelikleri yöntemini alma
Aşağıdaki örnekte, abonelik 123 subscriptionId
ile güncellenir. İlgili içeriği oluşturmak için kullanılan
customerId
: C0123456. İsteğin gövdesi, reklamverenin
plan türü:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changeSeats
Bir Google Workspace yıllık taahhüt planı aboneliği, bu isteğin metnini şu amaçlarla kullanır:
Kullanıcı lisansı sayısını güncellemek. numberOfSeats
değeri bir
toplamıdır. Örneğin, önceden 10 kullanıcı lisansınız varsa ve
5 yeni lisans için müşteri siparişi; bu lisans için isteğin gövdesindeki toplam,
numberOfSeats
, aşağıdaki örnekte gösterildiği gibi 15'tir:
{
"kind": "subscriptions#seats",
"numberOfSeats": 15
}
Esnek plan aboneliği için lisans güncelleme
Google Workspace esnek planının aboneliği, güncelleme yapmak için istek gövdesini kullanır
kullanıcı lisansları. maximumNumberOfSeats
değeri şunların toplamıdır:
mevcut ve yeni lisansları görürsünüz. Bu, maksimum kullanıcı sayısıdır
hesabın temel hazırlığını yapabileceği lisans sayısı.
{
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 15
}
Başarılı bir yanıt, bir HTTP 201
durum kodu döndürür ve
abonelik lisans ayarları:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 15,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"skuName": "Google Workspace Business Standard"
}
Aboneliğin yenileme ayarlarını güncelleme
Yıllık taahhüt aboneliğinin yenileme ayarlarını güncellemek için şurayı kullanın:
Aşağıdaki POST
HTTP isteği:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeRenewalSettings
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.SUBSCRIPTION_ID
: Varsayılan abonelik kimliği her müşteri için benzersizdir. Bu değeri, Tüm bayi abonelikleri yöntemini alma
Aşağıda örnek bir istek gövdesi verilmiştir:
{
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
}
renewalType
özelliğinin değeri aşağıdakilerden herhangi biri olabilir:
AUTO_RENEW_YEARLY_PAY
: Yıllık taahhüt planı aralığının sonunda, aboneliğin planını şu tarihte otomatik olarakANNUAL_YEARLY_PAY
ile yenile: aynınumberOfSeats
.AUTO_RENEW_MONTHLY_PAY
: Yıllık taahhüt planının sonunda zaman aralığı, abonelik planını mümkün olduğunca AynınumberOfSeats
ileANNUAL_MONTHLY_PAY
.RENEW_CURRENT_USERS_YEARLY_PAY
: Yıllık taahhüt planının sonunda zaman aralığı için abonelik planınıANNUAL_YEARLY_PAY
olarak yenileyin, ancak Mevcut etkin kullanıcı lisanslarının toplam sayısı. Bu, varsayılan ayardır etkin yıllık taahhüt planları (yıllık olarak ödenir) için geçerli olan ayardır.RENEW_CURRENT_USERS_MONTHLY_PAY
: Yıllık taahhüt planının sonunda zaman aralığı için abonelik planınıANNUAL_MONTHLY_PAY
olarak yenileyin, ancak Mevcut etkin kullanıcı lisanslarının toplam sayısı. Bu, varsayılan ayardır (aylık ödenmesi gerekir) için etkin yıllık taahhüt planları.RENEW_ON_PROPOSED_OFFER
: Mevcut taahhüt planının sonunda aralığı; en son yenileme teklifini, numara olarak numberOfSeats olacak şekilde yenileyin mevcut etkin kullanıcı lisansının veya önerilen teklif taahhüdünün yüzdesi (hangisi geçerliyse) daha yüksek.SWITCH_TO_PAY_AS_YOU_GO
: Yıllık taahhüt planının sonunda yıllık taahhüt planını esnek bir plana geçirin.CANCEL
: Yıllık taahhüt planı aralığının sonunda abonelik askıya alındı. Askıya alma durumunun nasıl kaldırılacağını öğrenmek için şu sayfayı inceleyin: yönetim yardım merkezini ziyaret edin.
Başarılı bir yanıt, bir HTTP 201
durum kodu döndürür ve
abonelik yenileme ayarları:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 15,
"licensedNumberOfSeats": 15
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"skuName": "Google Workspace Business Standard"
}
Ücretsiz deneme aboneliğinden ücretli hizmet başlatma
30 günlük ücretsiz deneme aboneliğini hemen ücretli bir hizmete taşımak için
deneme için ayarlanmış bir ödeme planı varsa
aboneliği için aşağıdaki POST
HTTP isteğini kullanın.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/startPaidService
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.SUBSCRIPTION_ID
: Varsayılan abonelik kimliği her müşteri için benzersizdir. Bu değeri, Tüm bayi abonelikleri yöntemini alma
Aşağıdaki örnekte customerId
olarak C0123456,
subscriptionId
değeri 123:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/startPaidService
Bu işlemin istek gövdesinde parametre yok.
Başarılı bir yanıt, bir HTTP 201
durum kodu ve güncellenmiş abonelik ayarlarını döndürür:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 15,
"licensedNumberOfSeats": 15
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"skuName": "Google Workspace Business Standard"
}
Aboneliği yükseltme veya düşürme
Hizmet döneminin ortasında yıllık planlarda alt sürüme geçemezsiniz ve
yenileme ayarlarını kullanarak eski sürüme geçiş yapmayı planlayabilirsiniz. Hedef EBM'yi
Yenileme ayarlarını FLEXIBLE
olarak değiştirin ve yenileme tarihinden sonra eski sürüme geçirin.
Bir aboneliği yükseltmek veya düşürmek için yeni bir abonelik oluşturun
yükseltme veya düşürme istediğiniz skuId
ile.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.
Bu çağrı, önceki aboneliği sonlandırıp yeni bir abonelik oluşturur.
Şununla ilgili daha fazla bilgi edinin: yükseltme ve düşürme ve SKU'lar sayfası.