Method: purchases.subscriptionsv2.scheduleplantransition

किसी सदस्यता के लिए, प्लान ट्रांज़िशन शेड्यूल करना.

एचटीटीपी अनुरोध

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

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
packageName

string

ज़रूरी है. उस ऐप्लिकेशन का पैकेज जिसके लिए यह सदस्यता खरीदी गई थी. उदाहरण के लिए, 'com.some.thing'.

token

string

ज़रूरी है. सदस्यता खरीदने पर, उपयोगकर्ता के डिवाइस को दिया गया टोकन.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "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
}
फ़ील्ड
productId

string

ज़रूरी है. शुल्क लेकर सदस्यता देने वाला वह प्रॉडक्ट (उदाहरण के लिए, 'premium_plan') जिसके लिए ट्रांज़िशन शेड्यूल करना ज़रूरी है.

earliestTransitionEffectiveTime

string (Timestamp format)

ज़रूरी है. वह समय जब प्लान ट्रांज़िशन सबसे पहले लागू हो सकता है. यह बदलाव, रिन्यूअल के समय या इसके बाद लागू होगा.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

[ज़रूरी है] प्लान बदलने का मोड. यहां उन फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
definiteTransition

object (DefiniteTransition)

इस मोड का इस्तेमाल करने पर, उपयोगकर्ता को नए प्लान पर स्विच करना ही होगा. इसे रद्द नहीं किया जा सकता.

tentativeTransition

object (TentativeTransition)

इस मोड का इस्तेमाल करने पर, उपयोगकर्ता का नए प्लान पर ट्रांज़िशन अस्थायी होता है और इसे रद्द किया जा सकता है.

एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.
etag

string

अगर यह पैरामीटर सेट है, तो एपीआई काम नहीं करेगा. ऐसा तब होगा, जब etag इस सदस्यता के लिए सबसे नए etag से मैच नहीं करेगा. ईटैग को purchases.subscriptionsv2.get से वापस पाया जाता है: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

जवाब का मुख्य भाग

purchases.subscriptionsv2.schedulePlanTransition API के लिए रिस्पॉन्स.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है
{
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  }
}
फ़ील्ड
planTransitionDetails

object (PlanTransitionDetails)

सदस्यता वाले आइटम के प्लान ट्रांज़िशन की जानकारी.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

DefiniteTransition

इस टाइप में कोई फ़ील्ड नहीं है.

इसका इस्तेमाल यह बताने के लिए किया जाता है कि प्लान ट्रांज़िशन तय है.

TentativeTransition

इस टाइप में कोई फ़ील्ड नहीं है.

इसका इस्तेमाल यह बताने के लिए किया जाता है कि प्लान ट्रांज़िशन अस्थायी है.