Method: subscriptions.changePlan

Abonelik planını günceller. 30 günlük deneme planını 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şir. Daha fazla bilgi için Abonelikleri yönetme başlıklı makaledeki 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 benzersiz tanımlayıcısıdır. 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üğü şekilde) her zaman kullanılabilir. Uygun olduğu durumlarda benzersiz tanımlayıcıyı sistemlerinizde saklamanızı öneririz.
subscriptionId

string

Bu zorunlu bir özelliktir. subscriptionId, abonelik tanımlayıcısıdır ve her müşteri için benzersizdir. subscriptionId, abonelik güncellendiğinde 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 bakın.

ChangePlanRequest

subscriptions.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 planı değişikliği 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 için API kavramları bölümüne bakın.

Olası değerler:

  • ANNUAL_MONTHLY_PAY: Aylık ödemeli 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. seats mülkü, kullanıcı koltuğu 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 kullanması amacıyla sağlanmıştır. purchaseOrderId değeri verilirse API yanıtlarında ve faturada gösterilir. Özellik, en fazla 80 düz metin karakteri kabul eder.
dealCode

string

Abonelik planlarında indirimli fiyatlandırma için Google tarafından verilen kod (maks. 100 karakter). İndirimli fiyattan yararlanmak için fırsat kodu changePlan isteğine eklenmelidir. Bu özellik isteğe bağlıdır. Bir aboneliğe daha önce fırsat kodu eklenmişse bu özellik boş bırakılabilir ve mevcut indirimli fiyat geçerli olmaya devam eder (boş değilse yalnızca abonelikte mevcut olan fırsat kodunu girin). Bir aboneliğe hiç anlaşma kodu eklenmediyse ve bu özellik boş bırakılırsa normal fiyat uygulanır.