Bir abonelik aldıktan sonra, aboneliğin durumunu değiştirmek veya aboneliği güncellemek için başarılı yanıttaki bilgileri kullanabilirsiniz. Bu sayfada, abonelik almak ve güncellemek için kullanabileceğiniz farklı yöntemler ele alınmaktadır.
Abonelik alma
Başarıyla sıralanan 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 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, bir HTTP 200
durum kodu ve abonelik ayarlarını döndürür. Aşağıdaki örnek yanıtta, isInTrial
özelliği false
şeklindedir ancak trialEndTime
özelliği yoktur. Yani bu müşteri, bu planla hiç 30 günlük ücretsiz deneme süresinde bulunmamıştır.
{
"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"
}
Müşterinin tüm aboneliklerini al
Belirli bir bayi müşterisinin başarıyla sipariş edilen veya aktarılan 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 benzersiz tanımlayıcısı.START_DATE
:YYYY-MM-DD
biçiminde başlangıç tarihi.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 kodunun yanı sıra müşterinin abonelikleri ve ayarlarının bir listesini döndürür. Abonelik listesi, Bayi API'sinin bu sürümünde yönetilmeyen ürünler içerebilir.
Siz yönetmiyorsanız bu müşteriyi yönetmiyorsanız 403 "Forbidden"
hatası döndürülür.
Bir müşterinin tüm aktarılabilir aboneliklerini al
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ış yapılan 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, bayi kimliğinize özel bir aktarım jetonudur. Müşteri tarafından oluşturulduktan sonra
30 gün geçerlidir. Müşterilerin jetonu nasıl oluşturduğu hakkında daha fazla bilgi için Google Workspace hesabınızı bayiye aktarma başlıklı makaleye göz atı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 adı veya benzersiz tanımlayıcısı.AUTH_TOKEN
: Müşteriniz tarafından sağlanan, bayi kimliğinize özel bir aktarım jetonu. Müşteri tarafından oluşturulduktan 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ı 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
:YYYY-MM-DD
biçiminde başlangıç tarihi.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 kodunun yanı sıra aktarım jetonunun sona erme tarihi ve aktarım siparişinde gereken minimum lisans sayısı ile birlikte müşterinin aktarılabilir aboneliklerinin bir listesini döndürür. Bir 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şlemi kullanarak aktarmayı planlıyorsanız tüm abonelikleri aktarın. Her aboneliğin tek tek aktarılması hataya neden olur. Ayrıca, toplu işlem yalnızca ACTIVE
durumuna sahip abonelikleri aktarır. Daha fazla bilgi edinmek için Aboneliği aktarma başlıklı makaleyi inceleyin.
Tüm bayi aboneliklerini al
Bir bayinin başarıyla sipariş edilen veya aktarılan aboneliklerinin tümünü geri 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 sonuçların belirli bir sayfasını tanımlayan bir jeton.MAX_NUMBER
: Bir yanıt sayfasında döndürülen maksimum sonuç sayısı.
Bu işlem, OAuth salt okuma erişim kapsamını kullanabilir. customerNamePrefix
, pageToken
ve maxResults
isteğe bağlı sorgu dizeleridir.
Aşağıdaki örnek, bir bayinin adı "sınav" ile başlayan müşterilere ait tüm abonelikleri 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 bağlı olarak değişiklik gösterir. Bir planı güncellemeden önce şunları göz önünde bulundurun:
Bir abonelik oluşturduğunuzda ve müşteri gerekli niteliklere sahipse aboneliğin planı 30 günlük bir deneme süresi olabilir. Hem esnek hem de yıllık taahhüt ödeme planları 30 günlük ücretsiz deneme şeklinde olabilir. Deneme süresi boyunca aboneliğin ödeme planını gerektiğinde esnek veya yıllık taahhüt planı olarak değiştirebilirsiniz. Ancak deneme süresi sona erdikten ve plan etkin hale geldikten sonra, plan güncellenirken diğer aboneliklerin etkin planlarıyla aynı kurallar uygulanır. 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 yeterliliği kuralları için yönetim yardım merkezine bakın.
Esnek bir planı yıllık taahhüt planına güncelleyebilirsiniz.
Yıllık taahhüt planını güncelleyemezsiniz.
Her plan her ürünle uyumlu değildir. Bu planların kullandığı ürünler hakkında daha fazla bilgi için Ürünler ve SKU'lar bölümüne bakın.
30 günlük deneme sürümüne veya esnek plan aboneliğine yönelik yıllık taahhüt planı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/changePlan
Aşağıdakini değiştirin:
CUSTOMER_ID
: Müşterinin birincil alan adı veya 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 örnek, aboneliği subscriptionId
değeriyle 123 değeriyle günceller. customerId
numarası C0123456.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changePlan
İstek 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 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"
}
Bir aboneliğin lisans sayısını güncelleme
Yıllık taahhütlü plan aboneliğinin güncellenmesi, Google Workspace esnek planının aboneliğinin güncellenmesinden farklı abonelik özellikleri kullanır.
Yıllık plan aboneliğinin lisansı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 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 örnek, aboneliği 123 subscriptionId
ile günceller. customerId
, C0123456'dır. İsteğin içeriği, plan türüne göre değişiklik gösterir:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changeSeats
Google Workspace yıllık taahhüt planının 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 numberOfSeats
için isteğin gövdesindeki toplam tutar 15 olur:
{
"kind": "subscriptions#seats",
"numberOfSeats": 15
}
Esnek plan aboneliği için lisansları güncelleme
Google Workspace esnek planlarının 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, bir 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 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 gövdesi verilmiştir:
{
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
}
renewalType
özelliğinin değeri şunlardan herhangi biri olabilir:
AUTO_RENEW_YEARLY_PAY
: Yıllık taahhüt planı aralığının sonunda abonelik planını aynınumberOfSeats
ileANNUAL_YEARLY_PAY
olarak otomatik olarak yenileyin.AUTO_RENEW_MONTHLY_PAY
: Yıllık taahhüt planının aralık süresinin sonunda abonelik planını aynınumberOfSeats
ile otomatik olarakANNUAL_MONTHLY_PAY
olarak yenileyin.RENEW_CURRENT_USERS_YEARLY_PAY
: Yıllık taahhüt planının aralıkları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 olarak ödenen) için varsayılan ayardır.RENEW_CURRENT_USERS_MONTHLY_PAY
: Yıllık taahhüt planının aralıkları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 olarak ödenen) için varsayılan ayardır.RENEW_ON_PROPOSED_OFFER
: Mevcut taahhüt planının süresinin sonunda mevcut etkin kullanıcı lisansı sayısı veya önerilen teklif taahhüdü (hangisi daha yüksekse) olarak numberOfSeats şeklinde en yeni yenileme teklifini yenileyin.SWITCH_TO_PAY_AS_YOU_GO
: Yıllık taahhüt planının zaman 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 durumunu nasıl kaldıracağınızı öğrenmek için yönetim yardım merkezine bakın.
Başarılı bir yanıt, bir 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"
}
Ücretsiz deneme aboneliğinden ücretli hizmeti başlatma
30 günlük ücretsiz deneme aboneliğini hemen ücretli hizmet aboneliğine taşımak istiyorsanız deneme aboneliği için daha önce ödeme planı oluşturulmuş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 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
olarak C0123456, subscriptionId
değeri ise 123 olarak verilmiştir:
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ğin seviyesini yükseltme veya düşürme
Yıllık planlarınızı dönem ortasında alt sürüme geçiremezsiniz ve yenileme ayarlarını kullanarak bir alt sürüme geçiş işlemi planlayamazsınız. Yenileme ayarlarını FLEXIBLE
seçeneğine geçiş yapacak şekilde ayarlamanızı ve yenileme zamanından sonra eski sürüme geçmenizi öneririz.
Bir aboneliğin düzeyini yükseltmek veya düşürmek için 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 benzersiz tanımlayıcısı.
Bu çağrı, önceki aboneliği sonlandırır ve yeni bir abonelik oluşturur.
Ürünler ve SKU'lar sayfasında yeni sürüme ve eski sürüme geçişler hakkında daha fazla bilgi edinebilirsiniz.