Method: subscriptions.changePlan

Bir abonelik planını günceller. Bir planı 30 günlük deneme sürümüne veya esnek plan aboneliğini aylık ya da yıllık ödemeli yıllık taahhüt planına güncellemek için bu yöntemi kullanın.

Bir planın güncellenme şekli 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ülen) her zaman kullanılabilir. Uygun olduğu durumlarda, benzersiz tanımlayıcıyı 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. Bir abonelik güncellendiğinde subscriptionId değiştiğinden bu kimliği kalıcı veriler için anahtar olarak kullanmamanızı öneririz. subscriptionId ise tüm bayi aboneliklerini alma yöntemi kullanılarak 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ılavuzuna göz atın.

ChangePlanRequest

subscription.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ğı abonelik değişikliği planı isteği olarak tanımlar. Değer: subscriptions#changePlanRequest
planName

string

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

Olası değerler:

  • ANNUAL_MONTHLY_PAY - Aylık ödeme yapılan yıllık taahhüt planı
  • ANNUAL_YEARLY_PAY - Yıllık ödeme yapılan yıllık taahhüt planı
  • FLEXIBLE - Esnek plan
  • TRIAL - 30 günlük ücretsiz deneme planı

seats

object (Seats)

Bu zorunlu bir özelliktir. Lisans özelliği, kullanıcı başına lisans sayısıdır.
purchaseOrderId

string

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

string

Abonelik planlarında indirimli fiyat için Google tarafından verilen kod (maksimum 100 karakter). İndirimli fiyattan yararlanmak için fırsat kodu changePlan isteğine dahil edilmelidir. Bu özellik isteğe bağlıdır. Aboneliğe halihazırda bir fırsat kodu eklenmişse bu mülk boş bırakılabilir ve mevcut indirimli fiyat geçerli olmaya devam eder. (Boş değer boş bırakılmadan yalnızca abonelikte mevcut olan fırsat kodunu sağlayın). Aboneliğe daha önce fırsat kodu eklenmemişse ve bu mülk boş bırakılırsa normal fiyatlandırma uygulanır.