Method: subscriptions.changePlan

Bir abonelik planını günceller. Bu yöntemi kullanarak 30 günlük deneme planını veya esnek plan aboneliğini aylık ya da yıllık ödemelerle yıllık taahhüt planına güncelleyebilirsiniz.

Bir planın nasıl güncelleneceği, plana ve ürünlere göre değişiklik gösterir. Daha fazla bilgi için abonelikleri yönetme bölümündeki açıklamaya bakın.

HTTP isteği

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Bu, müşterinin birincil alan adı veya müşterinin benzersiz tanımlayıcısı olabilir. Bir müşterinin alan adı değişirse müşteriye erişmek için eski alan adı kullanılamaz ancak müşterinin benzersiz tanımlayıcısı (API tarafından döndürüldüğü şekliyle) her zaman kullanılabilir. Benzersiz tanımlayıcıyı, uygun olduğu durumlarda sistemlerinizde depolamanızı öneririz.
subscriptionId

string

Bu zorunlu bir özelliktir. subscriptionId, abonelik tanımlayıcısıdır ve her müşteri için benzersizdir. Abonelik güncellendiğinde subscriptionId değiştiğinden kalıcı veriler için bu kimliği anahtar olarak kullanmamanızı öneririz. subscriptionId, tüm bayi aboneliklerini al yöntemi kullanılarak da bulunabilir.

İstek içeriği

İstek metni, ChangePlanRequest öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılıysa yanıt metni, Subscription öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/apps.order

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.

ChangePlanRequest

abonelikleriniz.changePlan rpc isteği için JSON şablonu.

JSON gösterimi 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
Alanlar
kind

string

Kaynağı bir abonelik değişiklik planı isteği olarak tanımlar. Değer: subscriptions#changePlanRequest
planName

string

planName özelliği zorunludur. Bu, aboneliğin ödeme planının adıdır. Google ödeme planları hakkında daha fazla bilgi için API kavramları başlıklı makaleyi inceleyin.

Olası değerler şunlardır:

  • ANNUAL_MONTHLY_PAY - Aylık ödemeleri olan yıllık taahhüt planı
  • ANNUAL_YEARLY_PAY - Yıllık ödemelerle yıllık taahhüt planı
  • FLEXIBLE - Esnek plan
  • TRIAL - 30 günlük ücretsiz deneme planı

seats

object (Seats)

Bu zorunlu bir özelliktir. Lisanslar özelliği, kullanıcı lisansı lisanslarının sayısıdır.
purchaseOrderId

string

Bu, isteğe bağlı bir özelliktir. Bu satın alma siparişi (PO) bilgileri, bayilerin şirket izleme kullanımları için kullanmaları içindir. purchaseOrderId değeri verilirse bu değer API yanıtlarında görünür ve faturada gösterilir. Tesiste en fazla 80 düz metin karakteri kabul edilir.
dealCode

string

Abonelik planlarında indirimli fiyatlar için Google tarafından verilen kod (en fazla 100 karakter). İndirimli ücret alabilmek için changePlan isteğine fırsat kodunun dahil edilmesi gerekir. Bu özellik isteğe bağlıdır. Bir aboneliğe fırsat kodu zaten eklenmişse bu mülk boş bırakılabilir ve mevcut indirimli fiyat geçerli olmaya devam eder (boş değilse yalnızca abonelikte mevcut olan fırsat kodunu sağlayın). Fırsat kodu bir aboneliğe hiç eklenmemişse ve bu mülk boş bırakılmışsa normal fiyatlandırma uygulanır.