Method: purchases.subscriptionsv2.scheduleplantransition

Bir abonelik için plan geçişi planlayın.

HTTP isteği

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition

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

Yol parametreleri

Parametreler
packageName

string

Zorunlu. Bu aboneliğin satın alındığı uygulamanın paketi (örneğin, "com.some.thing").

token

string

Zorunlu. Abonelik satın alındığında kullanıcının cihazına sağlanan jeton.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "productId": string,
  "earliestTransitionEffectiveTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "definiteTransition": {
    object (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
Alanlar
productId

string

Zorunlu. Geçişin planlanması gereken abonelik ürünü (ör. "premium_plan").

earliestTransitionEffectiveTime

string (Timestamp format)

Zorunlu. Plan geçişinin geçerlilik kazanabileceği en erken zaman. Asıl geçiş, bu tarihte veya bu tarihten sonraki yenileme sırasında gerçekleşir.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

[Zorunlu] Plan geçişi modu. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
definiteTransition

object (DefiniteTransition)

Bu mod kullanıldığında kullanıcının yeni plana geçişi kesindir ve iptal edilemez.

tentativeTransition

object (TentativeTransition)

Bu mod kullanıldığında kullanıcının yeni plana geçişi geçicidir ve iptal edilebilir.

Birbirini hariç tutan alanların sonu.
etag

string

Bu değer ayarlanırsa ve etag, bu aboneliğin en son etag'iyle eşleşmezse API başarısız olur. Etag, purchases.subscriptionsv2.get adresinden alınır: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

Yanıt metni

purchases.subscriptionsv2.schedulePlanTransition API'sinin yanıtı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  }
}
Alanlar
planTransitionDetails

object (PlanTransitionDetails)

Abonelik öğesinin plan geçişi ayrıntıları.

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/androidpublisher

DefiniteTransition

Bu türün alanı yok.

Plan geçişinin kesin olduğunu belirtmek için kullanılır.

TentativeTransition

Bu türün alanı yok.

Plan geçişinin geçici olduğunu belirtmek için kullanılır.