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, abonelikleri alıp güncellemenin farklı yolları ele alınmaktadı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 Tüm bayi aboneliklerini alma yöntemini kullanarak 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üresini hiç kullanmadığı 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 value&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ıç tarihi,YYYY-MM-DD
biçiminde.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ıtta HTTP 200
durum kodu ve müşterinin aboneliklerinin ve ayarlarının listesi döndürülür. Abonelik listesi, Bayi API'sinin bu sürümünde yönetilmeyen ürünleri içerebilir.
Bu 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 tarafından oluşturulduktan 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 tarafından oluşturulduktan 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. Bu değer geçerli değilse veya süresi dolmuşsa API yanıtı403 "Forbidden"
hatası döndürür.START_DATE
: Başlangıç tarihi,YYYY-MM-DD
biçiminde.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 döndürür. Bu listede, aktarım jetonunun son kullanma tarihi ve aktarım sırasına göre gereken minimum koltuk sayısı yer alır. Müşterinin aktarılamayan ek abonelikleri 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. Her aboneliği 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 okunur erişim kapsamı kullanılabilir. customerNamePrefix
, pageToken
ve maxResults
isteğe bağlı sorgu dizeleridir.
Aşağıdaki örnek, adları "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üt planlarına değiştirebilirsiniz. Ancak deneme süresi sona erip plan etkinleştirildikten sonra planın güncellenmesi, diğer aboneliklerin etkin planlarıyla aynı kurallara tabidir. 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önetim Yardım Merkezi'ne göz atın.
Esnek bir planı yıllık taahhütlü plana güncelleyebilirsiniz.
Yıllık taahhütlü planları güncelleyemezsiniz.
Bazı planlar bazı ü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, subscriptionId
ile abonelik 123 değeriyle güncellenir. 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ıt, HTTP 201
durum kodunu ve güncellenen abonelik planı 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": 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. İsteğin gövdesi, plan türüne bağlı olarak 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ği, kullanıcı lisansı sayısını güncellemek için bu istek gövdesini kullanır. numberOfSeats
değeri toplamdır. Örneğin, daha önce 10 kullanıcı lisansınız vardı ve 5 yeni lisans için müşteri siparişiniz var. Bu durumda, aşağıdaki örnekte gösterildiği gibi, isteğin gövdesindeki numberOfSeats
toplamı 15 olur:
{
"kind": "subscriptions#seats",
"numberOfSeats": 15
}
Esnek plan aboneliğinin koltuklarını güncelleme
Google Workspace esnek plan aboneliğinde, kullanıcı lisanslarını güncellemek için istek gövdesi kullanılı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 herhangi biri olabilir:
AUTO_RENEW_YEARLY_PAY
: Yıllık taahhüt planının aralığının sonunda, aboneliğin planını aynınumberOfSeats
ileANNUAL_YEARLY_PAY
olarak otomatik yenileyin.AUTO_RENEW_MONTHLY_PAY
: Yıllık taahhüt planının aralığı sona erdiğinde abonelik planını aynınumberOfSeats
ileANNUAL_MONTHLY_PAY
olarak otomatik yenileyin.RENEW_CURRENT_USERS_YEARLY_PAY
: Yıllık taahhüt planının aralığının sonunda, abonelik planınıANNUAL_YEARLY_PAY
olarak yenileyin ancak toplam etkin kullanıcı lisansı 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_PAY
olarak yenileyin ancak toplam etkin kullanıcı lisansı sayısını kullanın. Bu, etkin yıllık taahhüt planları (aylık ödeme) için varsayılan ayardır.RENEW_ON_PROPOSED_OFFER
: Mevcut taahhüt planının aralığının sonunda, numberOfSeats parametresini mevcut etkin kullanıcı lisanslarının sayısı veya önerilen teklif taahhüdü (hangisi daha yüksekse) olarak kullanarak 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ıt, HTTP 201
durum kodu ve güncellenen abonelik yenileme 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"
}
Ücretsiz deneme aboneliğinden ücretli hizmete geçiş
30 günlük ücretsiz deneme aboneliğini ücretli hizmet aboneliğine hemen taşımak 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 plan düşürme işlemi planlayamazsınız. Yenileme ayarlarını FLEXIBLE
'ya geçecek şekilde ayarlamanızı ve yenileme süresinden sonra sürümü 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.