Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

सदस्यता के ऑफ़र की स्थितियों के बैच को अपडेट करता है.

अपडेट की ज़्यादा से ज़्यादा क्षमता हासिल करने के लिए, नेस्ट किए गए अनुरोधों के इंतज़ार के समय के फ़ील्ड को PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT पर सेट करें.

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

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdateStates

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

पाथ के पैरामीटर

पैरामीटर
packageName

string

ज़रूरी है. अपडेट किए गए सदस्यता ऑफ़र के पैरंट ऐप्लिकेशन (पैकेज का नाम).

अपडेट किए गए सभी SubscriptionOffer संसाधनों के PackageName फ़ील्ड के बराबर होना चाहिए.

productId

string

ज़रूरी है. अगर अपडेट किए गए सभी ऑफ़र एक ही सदस्यता से जुड़े हैं, तो पैरंट सदस्यता का प्रॉडक्ट आईडी. अगर यह अनुरोध एक से ज़्यादा सदस्यताओं के लिए किया जा रहा है, तो इस फ़ील्ड को "-" पर सेट करें. इस फ़ील्ड को सेट करना ज़रूरी है.

basePlanId

string

ज़रूरी है. वह पैरंट प्लान (आईडी) जिसके लिए ऑफ़र अपडेट किए जाने चाहिए. एक से ज़्यादा बुनियादी प्लान के ऑफ़र अपडेट करने के लिए, इसे '-' के तौर पर दिखाया जा सकता है.

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

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

जेएसओएन के काेड में दिखाना
{
  "requests": [
    {
      object (UpdateSubscriptionOfferStateRequest)
    }
  ]
}
फ़ील्ड
requests[]

object (UpdateSubscriptionOfferStateRequest)

ज़रूरी है. अपडेट के अनुरोध वाले 100 एलिमेंट की सूची. सभी अनुरोधों में अलग-अलग ऑफ़र अपडेट होने चाहिए.

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

Offer.batchUpdateStates के लिए जवाब वाला मैसेज.

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

जेएसओएन के काेड में दिखाना
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
फ़ील्ड
subscriptionOffers[]

object (SubscriptionOffer)

सदस्यता के ऑफ़र की अपडेट की गई सूची.

अनुमति देने के दायरे

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

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

UpdateSubscriptionOfferStateRequest

सदस्यता के ऑफ़र की स्थिति अपडेट करने के लिए, मैसेज का अनुरोध करें.

जेएसओएन के काेड में दिखाना
{

  // Union field state_transition_type can be only one of the following:
  "activateSubscriptionOfferRequest": {
    object (ActivateSubscriptionOfferRequest)
  },
  "deactivateSubscriptionOfferRequest": {
    object (DeactivateSubscriptionOfferRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
फ़ील्ड
यूनियन फ़ील्ड state_transition_type. लागू करने के लिए स्टेट ट्रांज़िशन का टाइप, सटीक तौर पर एक को सेट किया जाना चाहिए. state_transition_type इनमें से सिर्फ़ एक हो सकता है:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

इससे ऑफ़र चालू होता है. चालू होने के बाद, यह ऑफ़र नए सदस्यों के लिए उपलब्ध हो जाएगा.

deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

इससे ऑफ़र बंद हो जाता है. बंद होने के बाद, यह ऑफ़र नए सदस्यों के लिए उपलब्ध नहीं होगा. हालांकि, मौजूदा सदस्यों की सदस्यता बनी रहेगी

ActivateSubscriptionOfferRequest

ActivateSubscriptionOffer के लिए अनुरोध का मैसेज.

जेएसओएन के काेड में दिखाना
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
फ़ील्ड
packageName

string

ज़रूरी है. ऑफ़र के पैरंट ऐप्लिकेशन (पैकेज का नाम) को चालू करना है.

productId

string

ज़रूरी है. चालू करने के लिए ऑफ़र की पैरंट सदस्यता (आईडी).

basePlanId

string

ज़रूरी है. जिस ऑफ़र को चालू करना है उसका पैरंट बुनियादी प्लान (आईडी).

offerId

string

ज़रूरी है. चालू किए जाने वाले ऑफ़र का यूनीक ऑफ़र आईडी.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

ज़रूरी नहीं. इस प्रॉडक्ट से जुड़े अपडेट को लागू करने में लगने वाले समय की कम से कम सीमा. डिफ़ॉल्ट रूप से, यह वैल्यू 'इंतज़ार का समय' पर सेट होती है.

DeactivateSubscriptionOfferRequest

Offer.deactivate के लिए अनुरोध का मैसेज.

जेएसओएन के काेड में दिखाना
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
फ़ील्ड
packageName

string

ज़रूरी है. उस ऑफ़र के पैरंट ऐप्लिकेशन (पैकेज का नाम) जिसे बंद करना है.

productId

string

ज़रूरी है. बंद किए जाने वाले ऑफ़र की पैरंट सदस्यता (आईडी).

basePlanId

string

ज़रूरी है. जिस ऑफ़र को बंद करना है उसका पैरंट बुनियादी प्लान (आईडी).

offerId

string

ज़रूरी है. बंद किए जाने वाले ऑफ़र का यूनीक ऑफ़र आईडी.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

ज़रूरी नहीं. इस प्रॉडक्ट से जुड़े अपडेट को लागू करने में लगने वाले समय की कम से कम सीमा. डिफ़ॉल्ट रूप से, यह वैल्यू 'इंतज़ार का समय' पर सेट होती है.