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 alma ve güncellemeyle ilgili farklı yöntemler ele alınmaktadır.
Abonelik alma
Başarıyla sipariş edilen veya aktarılan 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ı. Tüm bayi aboneliklerini alma yöntemini kullanarak bu değeri alabilirsiniz.
Bu işlemde istek gövdesinde parametre yok.
Başarılı bir yanıt, HTTP 200
durum kodunu ve aboneliğin ayarlarını döndürür. Aşağıdaki örnek yanıtta isInTrial
mülkü false
olarak görünüyor ancak trialEndTime
mülkü yok. Bu, müşterinin bu planda hiç 30 günlük ücretsiz deneme kullanmadığı anlamına gelir.
{
"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
:YYYY-MM-DD
biçimindeki başlangıç tarihi.MAX_NUMBER
: Yanıt sayfasında döndürülen maksimum sonuç sayısı.
Bu işlemde 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. Abonelikler 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ılabilen tüm aboneliklerini almak için aşağıdaki GET
HTTP isteğini kullanın ve yetkilendirme jetonunu ekleyin. customerId
zorunludur ve yeniden satılan bir müşterinin hesabı alınırken 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şturacağı 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şturacağı 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ı bir403 "Forbidden"
hatası döndürür.START_DATE
:YYYY-MM-DD
biçimindeki başlangıç tarihi.MAX_NUMBER
: Yanıt sayfasında döndürülen maksimum sonuç sayısı.
Bu işlemde istek gövdesinde parametre yok.
Başarılı bir yanıt, HTTP 200
durum kodu ve müşterinin aktarılabilir aboneliklerinin listesini (aktarımı yapan jetonun son kullanma tarihi ve aktarım siparişinde gereken minimum koltuk sayısıyla birlikte) döndürür. Müşteriler, 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. Her aboneliği tek tek aktarmak hatayla sonuçlanır. Ayrıca toplu işlem yalnızca ACTIVE
durumu olan abonelikleri aktarır. Daha fazla bilgi için Abonelik aktarma başlıklı makaleyi inceleyin.
Tüm bayi aboneliklerini alma
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ş harfi.TOKEN
: Sunucunun döndürmesi gereken belirli bir sonuç sayfasını tanımlayan bir jeton.MAX_NUMBER
: Yanıt sayfasında döndürülen maksimum sonuç sayısı.
Bu işlem, OAuth salt okuma erişimi kapsamını kullanabilir. customerNamePrefix
, pageToken
ve maxResults
isteğe bağlı sorgu dizeleridir.
Aşağıdaki örnekte, bir bayinin adı "exam" ile başlayan müşterilere ait tüm abonelikleri alını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 değişiklik gösterir. Bir planı güncellemeden önce aşağıdakileri göz önünde bulundurun:
Bir abonelik oluşturduğunuzda ve müşteri gerekli niteliklere sahip olduğunda aboneliğin planı 30 günlük deneme olabilir. Hem esnek hem de yıllık taahhütlü ödeme planları 30 günlük ücretsiz deneme sürümü olabilir. Deneme süresi boyunca, aboneliğin ödeme planını gerektiği kadar sık esnek veya yıllık taahhüt planlarıyla değiştirebilirsiniz. Ancak deneme süresi sona erip plan etkin hale geldikten 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ü hakkında daha fazla bilgi ve müşteri uygunluk kuralları için yönetim yardım merkezine göz atın.
Esnek planı yıllık taahhütlü plana güncelleyebilirsiniz.
Yıllık taahhüt planlarını güncelleyemezsiniz.
Bazı planlar bazı ürünlerde kullanılamaz. Bu planların hangi ürünleri kullandığı hakkında daha fazla bilgi için Ürünler ve SKU'lar başlıklı makaleyi inceleyin.
30 günlük deneme planı veya esnek plan aboneliğini yıllık taahhüt planına 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/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ı. Tüm bayi aboneliklerini alma yöntemini kullanarak bu değeri alabilirsiniz.
Aşağıdaki örnekte, abonelik 123 değerine sahip subscriptionId
ile güncellenmektedir. customerId
, C0123456.
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 kodu ve güncellenmiş 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 koltuk sayısı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 koltuk sayısı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ı. Tüm bayi aboneliklerini alma yöntemini kullanarak bu değeri alabilirsiniz.
Aşağıdaki örnekte, abonelik 123 subscriptionId
ile güncellenmektedir. customerId
, C0123456. İsteğin gövdesi, plan türüne bağlı olarak farklılık gösterir:
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ı lisanslarının 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 varsa ve 5 yeni lisans için müşteri siparişiniz varsa isteğin gövdesinde numberOfSeats
için toplam sayı 15'tir (aşağıdaki örnekte gösterildiği gibi):
{
"kind": "subscriptions#seats",
"numberOfSeats": 15
}
Esnek plan aboneliğinin koltuk sayısı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üt aboneliğinin 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ı. Tüm bayi aboneliklerini alma yöntemini kullanarak bu değeri alabilirsiniz.
Aşağıda örnek bir istek metni verilmiştir:
{
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
}
renewalType
mülkünün değeri aşağıdakilerden 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 olarak yenileyin.AUTO_RENEW_MONTHLY_PAY
: Yıllık taahhüt planının aralığının sonunda, aboneliklerin planını aynınumberOfSeats
ileANNUAL_MONTHLY_PAY
olarak otomatik olarak yenileyin.RENEW_CURRENT_USERS_YEARLY_PAY
: Yıllık taahhüt planının aralığının sonunda, aboneliğin planınıANNUAL_YEARLY_PAY
olarak 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 ödemeli) için varsayılan ayardır.RENEW_CURRENT_USERS_MONTHLY_PAY
: Yıllık taahhüt planının aralığının sonunda, aboneliğin planınıANNUAL_MONTHLY_PAY
olarak 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, mevcut etkin kullanıcı lisanslarının sayısı veya önerilen teklif taahhütünün hangisi daha yüksekse onu kullanarak en son yenileme teklifinde yenileme yapın.SWITCH_TO_PAY_AS_YOU_GO
: Yıllık taahhüt planının süresinin sonunda yıllık taahhüt planını esnek plana değiştirin.CANCEL
: Yıllık taahhüt planı aralığının sonunda abonelik askıya alınır. Askıya alma durumunu nasıl kaldıracağınızı öğrenmek için yönetim yardım merkezine göz atın.
Başarılı bir yanıt, HTTP 201
durum kodu ve güncellenmiş 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"
}
Ücretli hizmeti ücretsiz deneme aboneliğinden başlatma
30 günlük ücretsiz deneme aboneliğini hemen ücretli bir hizmet aboneliğine taşımak için, deneme aboneliği için önceden bir ödeme planı 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ı. Tüm bayi aboneliklerini alma yöntemini kullanarak bu değeri 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şlemde istek gövdesinde parametre yok.
Başarılı bir yanıt, 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"
}
Abonelik düzeyini yükseltme veya düşürme
Yıllık planların düzeyini sürelerinin ortasında düşüremez ve yenileme ayarlarını kullanarak plan düzeyini düşürme planı oluşturamazsınız. Yenileme ayarlarını FLEXIBLE
'e geçmek için ayarlayıp 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ükseltme ve düşürme hakkında daha fazla bilgiyi Ürünler ve SKU'lar sayfasında bulabilirsiniz.