Bir aboneliği aldıktan sonra, başarılı yanıttaki bilgileri kullanarak aboneliğin durumunu değiştirebilir veya aboneliği güncelleyebilirsiniz. Bu sayfada, aboneliklerin nasıl alınacağı ve güncelleneceği açıklanmaktadır.
Aboneliği geri alma
Başarıyla sipariş edilmiş veya aktarılmış bir aboneliği almak için aşağıdaki GET HTTP isteğini kullanın:
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 adı veya müşterinin benzersiz tanımlayıcısı.SUBSCRIPTION_ID: Her müşteri için benzersiz olan abonelik tanımlayıcısı. Bu değeri Retrieve all reseller subscriptions method (Tüm bayi aboneliklerini alma yöntemi) ile alabilirsiniz.
Bu işlemin istek gövdesinde parametre yok.
Başarılı bir yanıt, HTTP 200 durum kodu ve aboneliğin ayarlarını döndürür. Aşağıdaki örnek yanıtta, isInTrial özelliği false olarak ayarlanmış ancak trialEndTime özelliği yok. Bu da müşterinin bu planla 30 günlük ücretsiz deneme süresinden hiç yararlanmadığı anlamına geliyor.
{
"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 başarıyla sipariş edilmiş veya aktarılmış tüm aboneliklerini 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?customerId=CUSTOMER_ID&pageToken=START_DATE&maxResults=MAX_NUMBER
Aşağıdakini değiştirin:
CUSTOMER_ID: Müşterinin birincil alan adı veya müşterinin benzersiz tanımlayıcısı.START_DATE: Başlangıç tarihiYYYY-MM-DDbiçimindedir.MAX_NUMBER: Bir yanıt sayfasında döndürülen maksimum sonuç sayısı.
Bu işlemin istek gövdesinde parametre yok.
Başarılı bir yanıt, HTTP 200 durum kodu ve müşterinin aboneliklerinin ve ayarlarının listesini döndürür. Abonelik listesinde, Bayi API'sinin bu sürümünde yönetilmeyen ürünler yer alabilir.
Müşteriyi yönetmiyorsanız 403 Forbidden hatası döndürülür.
Bir müşterinin aktarılabilir tüm aboneliklerini alma
Bir müşterinin, bayi yönetimine aktarılabilecek tüm aboneliklerini almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme jetonunu ekleyin. customerId gereklidir
ve yeniden satılan bir müşterinin hesabı alınırken döndürülen müşterinin benzersiz tanımlayıcısıdır.
customerAuthToken, müşteriniz tarafından sağlanan ve bayi kimliğinize özel bir aktarım jetonudur. Müşteri jetonu oluşturduktan sonra 30 gün boyunca geçerlidir. Müşterilerin jetonu nasıl oluşturduğu hakkında daha fazla bilgi için Google Workspace hesabınızı bir bayiye aktarma başlıklı makaleyi inceleyin.
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 adı veya müşterinin benzersiz tanımlayıcısı.AUTH_TOKEN: Müşteriniz tarafından sağlanan ve bayi kimliğinize özel bir aktarım jetonu. Müşteri jetonu oluşturduktan sonra 30 gün boyunca geçerli olur. Müşterilerin jetonu nasıl oluşturduğu hakkında daha fazla bilgi için Google Workspace hesabınızı bir bayiye aktarma başlıklı makaleyi inceleyin. Bu değer geçerli değilse veya süresi dolmuşsa API yanıtı403 Forbiddenhatası döndürür.START_DATE: Başlangıç tarihiYYYY-MM-DDbiçimindedir.MAX_NUMBER: Bir yanıt sayfasında döndürülen maksimum sonuç sayısı.
Bu işlemin istek gövdesinde parametre yok.
Başarılı bir yanıt, HTTP 200 durum kodu ve müşterinin aktarılabilir aboneliklerinin listesini (aktarım jetonunun son kullanma tarihi ve aktarım siparişinde gereken minimum koltuk sayısı ile birlikte) döndürür. Müşteri, aktarılamayan ek aboneliklere sahip olabilir.
{
"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 toplu işlem kullanarak aktarmayı planlıyorsanız tüm abonelikleri aktarın. Abonelikleri tek tek aktarmak hataya neden olur. Ayrıca, toplu işlem yalnızca ACTIVE durumundaki abonelikleri aktarır. Daha fazla bilgi için Abonelik aktarma başlıklı makaleyi inceleyin.
Tüm bayi aboneliklerini alma
Bir bayinin başarıyla sipariş ettiği veya aktardığı tüm abonelikleri 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: Aboneliklerini aradığınız müşterinin adının başlangıcı.TOKEN: Sunucunun döndürmesi gereken belirli bir sonuç sayfasını tanımlayan jeton.MAX_NUMBER: Bir yanıt sayfasında döndürülen maksimum sonuç sayısı.
Bu işlemde OAuth salt okuma erişim kapsamı kullanılabilir. customerNamePrefix, pageToken ve maxResults isteğe bağlı sorgu dizeleridir.
Aşağıdaki örnek, adı "exam" ile başlayan müşterilere ait olan tüm bayii aboneliklerini alır:
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. Bir planı güncellemeden önce aşağıdakileri göz önünde bulundurun:
Abonelik oluşturduğunuzda ve müşteri uygun olduğunda aboneliğin planı 30 günlük deneme süresi olabilir. Hem esnek hem de yıllık taahhütlü ödeme planları 30 günlük ücretsiz deneme süresiyle sunulabilir. Deneme süresi boyunca, aboneliğin ödeme planını gerektiği sıklıkta esnek veya yıllık taahhütlü planlara değiştirebilirsiniz. Deneme süresi sona erdikten ve plan etkinleştirildikten sonra planı güncellemek için diğer aboneliklerin etkin planlarıyla aynı kurallar geçerlidir. Deneme aboneliğini hemen etkin bir plana taşımak için 30 günlük ücretsiz deneme aboneliğinden ücretli bir hizmet başlatın. 30 günlük deneme sürümü ve müşteri yeterlilik kuralları hakkında daha fazla bilgi için Yönetici Yardım Merkezi'ne göz atın.
Esnek planları yıllık taahhütlü planlara güncelleyebilirsiniz.
Yıllık taahhüt planlarını güncelleyemezsiniz.
Bazı planlar tüm ürünlerde kullanılamaz. Bu planlarda kullanılan ürünler hakkında daha fazla bilgi için Ürünler ve SKU'lar başlıklı makaleyi inceleyin.
30 günlük deneme veya esnek plan aboneliği için bir planı yıllık taahhüt planına güncellemek üzere 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 adı veya müşterinin benzersiz tanımlayıcısı.SUBSCRIPTION_ID: Her müşteri için benzersiz olan abonelik tanımlayıcısı. Bu değeri Tüm bayi aboneliklerini alma yöntemini kullanarak alabilirsiniz.
Aşağıdaki örnekte, abonelik 123 subscriptionId
değeriyle güncellenmektedir. customerId, C0123456'dır.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changePlan
İstek metninde şunlar bulunur:
{
"kind": "reseller#changePlanRequest",
"planName": "ANNUAL_MONTHLY_PAY",
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10
},
"purchaseOrderId": "123_March2012"
}
Başarılı bir yanıtta HTTP 201 durum kodu ve güncellenen abonelik planı ayarları döndürülü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": 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 koltuklarını güncelleme
Yıllık taahhüt planı aboneliğini güncellemek için Google Workspace esnek plan aboneliğini güncellemekten farklı abonelik özellikleri kullanılır.
Yıllık plan aboneliğinin koltuklarını güncelleme
Yıllık plan aboneliğinin kullanıcı lisansı ayarlarını güncellemek 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/changeSeats
Aşağıdakini değiştirin:
CUSTOMER_ID: Müşterinin birincil alan adı veya müşterinin benzersiz tanımlayıcısı.SUBSCRIPTION_ID: Her müşteri için benzersiz olan abonelik tanımlayıcısı. Bu değeri Tüm bayi aboneliklerini alma yöntemini kullanarak alabilirsiniz.
Aşağıdaki örnekte, abonelik 123
subscriptionId ile güncellenmektedir. customerId, C0123456'dır. İstek gövdesi, plan türüne göre değişir:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changeSeats
Google Workspace yıllık taahhüt planı aboneliğinde, kullanıcı lisansı sayısını güncellemek için bu istek gövdesi kullanılır. numberOfSeats değeri bir toplamdır. Örneğin, daha önce 10 kullanıcı lisansınız varsa ve 5 yeni lisans için müşteri siparişiniz varsa aşağıdaki örnekte gösterildiği gibi, isteğin gövdesindeki numberOfSeats için toplam 15 olur:
{
"kind": "subscriptions#seats",
"numberOfSeats": 15
}
Esnek plan aboneliğinin koltuklarını güncelleme
Google Workspace esnek plan aboneliği, kullanıcı lisanslarını güncellemek için istek gövdesini kullanır. maximumNumberOfSeats değeri, mevcut lisansların ve yeni lisansların toplamıdır. Bu, hesabın sağlayabileceği maksimum kullanıcı lisansı sayısıdır.
{
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 15
}
Başarılı bir yanıt, HTTP 201 durum kodu ve güncellenmiş abonelik lisansı ayarlarını döndürür:
{
"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ütlü aboneliğin yenileme ayarlarını güncellemek 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/changeRenewalSettings
Aşağıdakini değiştirin:
CUSTOMER_ID: Müşterinin birincil alan adı veya müşterinin benzersiz tanımlayıcısı.SUBSCRIPTION_ID: Her müşteri için benzersiz olan abonelik tanımlayıcısı. Bu değeri Tüm bayi aboneliklerini alma yöntemini kullanarak alabilirsiniz.
Aşağıda örnek bir istek metni verilmiştir:
{
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
}
renewalType özelliğinin değeri aşağıdakilerden biri olabilir:
AUTO_RENEW_YEARLY_PAY: Yıllık taahhüt planının aralığı sona erdiğinde abonelik planını aynınumberOfSeatsileANNUAL_YEARLY_PAYolarak otomatik yenileyin.AUTO_RENEW_MONTHLY_PAY: Yıllık taahhüt planının aralığı sona erdiğinde abonelik planını aynınumberOfSeatsile otomatik olarakANNUAL_MONTHLY_PAYşeklinde yenileyin.RENEW_CURRENT_USERS_YEARLY_PAY: Yıllık taahhüt planının aralığının sonunda, abonelik planınıANNUAL_YEARLY_PAYolarak yenileyin ancak mevcut etkin kullanıcı lisanslarının toplam sayısını kullanın. Bu, etkin yıllık taahhüt planları (yıllık ödeme) için varsayılan ayardır.RENEW_CURRENT_USERS_MONTHLY_PAY: Yıllık taahhüt planının aralığının sonunda, abonelik planınıANNUAL_MONTHLY_PAYolarak yenileyin ancak mevcut etkin kullanıcı lisanslarının toplam sayısını kullanın. Bu, etkin yıllık taahhüt planları (aylık ödemeli) için varsayılan ayardır.RENEW_ON_PROPOSED_OFFER: Mevcut taahhüt planının aralığının sonunda, numberOfSeats değeri mevcut etkin kullanıcı lisanslarının sayısı veya önerilen teklif taahhüdü (hangisi daha yüksekse) olacak şekilde en son yenileme teklifiyle yenileyin.SWITCH_TO_PAY_AS_YOU_GO: Yıllık taahhüt planının aralığının sonunda, yıllık taahhüt planını esnek planla değiştirin.CANCEL: Yıllık taahhüt planı aralığının sonunda abonelik askıya alınır. Askıya alma işlemini nasıl kaldıracağınızı öğrenmek için Yönetici Yardım Merkezi'ne bakın.
Başarılı bir yanıtta HTTP 201 durum kodu ve güncellenen abonelik yenileme ayarları döndürülü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"
}
Ücretsiz deneme aboneliğinden ücretli hizmete geçme
30 günlük ücretsiz deneme aboneliğini hemen ücretli hizmet aboneliğine geçirmek için (deneme aboneliği için ödeme planı zaten ayarlanmışsa) 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 adı veya müşterinin benzersiz tanımlayıcısı.SUBSCRIPTION_ID: Her müşteri için benzersiz olan abonelik tanımlayıcısı. Bu değeri Tüm bayi aboneliklerini alma yöntemini kullanarak alabilirsiniz.
Aşağıdaki örnekte customerId değeri C0123456, subscriptionId değeri ise 123'tür:
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, HTTP 201 durum kodu ve güncellenen 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ğin seviyesini yükseltme veya düşürme
Yıllık planların düzeyini, dönemlerinin ortasında düşüremezsiniz ve yenileme ayarlarını kullanarak düşürme planlayamazsınız. Yenileme ayarlarını FLEXIBLE'ya geçecek şekilde ayarlamanızı ve yenileme süresinden sonra planınızı düşürmenizi öneririz.
Bir aboneliği yükseltmek veya düşürmek için yükseltmek ya da düşürmek istediğiniz skuId ile yeni bir abonelik oluşturun.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
Aşağıdakini değiştirin:
CUSTOMER_ID: Müşterinin birincil alan adı veya müşterinin benzersiz tanımlayıcısı.
Bu çağrı, önceki aboneliği sonlandırır ve yeni bir abonelik oluşturur.
Yükseltmeler ve eski sürüme geçişler hakkında daha fazla bilgiyi Ürünler ve SKU'lar sayfasında bulabilirsiniz.