Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

इस तरीके का इस्तेमाल करके, एक बार के प्रॉडक्ट ऑफ़र की स्थितियों के बैच को अपडेट किया जा सकता है.

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

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates

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

पाथ पैरामीटर

पैरामीटर
packageName

string

ज़रूरी है. अपडेट किए गए वन-टाइम प्रॉडक्ट ऑफ़र का पैरंट ऐप्लिकेशन (पैकेज का नाम).
productId

string

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

string

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

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

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

JSON के काेड में दिखाना 
{
  "requests": [
    {
      object (UpdateOneTimeProductOfferStateRequest)
    }
  ]
}
फ़ील्ड
requests[]

object (UpdateOneTimeProductOfferStateRequest)

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

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

offers.batchUpdateStates के लिए रिस्पॉन्स मैसेज.

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

JSON के काेड में दिखाना 
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
फ़ील्ड
oneTimeProductOffers[]

object (OneTimeProductOffer)

वन-टाइम प्रॉडक्ट के अपडेट किए गए ऑफ़र की सूची. यह सूची, अनुरोध के क्रम में ही होती है.

अनुमति के स्कोप

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

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

UpdateOneTimeProductOfferStateRequest

वन-टाइम प्रॉडक्ट ऑफ़र की स्थिति को अपडेट करने के लिए अनुरोध मैसेज.

JSON के काेड में दिखाना 
{

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

object (ActivateOneTimeProductOfferRequest)

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

object (CancelOneTimeProductOfferRequest)

किसी ऑफ़र को रद्द करता है. सदस्यता रद्द करने के बाद, यह ऑफ़र लोगों के लिए उपलब्ध नहीं होता. इस ऑफ़र से जुड़े सभी लंबित ऑर्डर रद्द कर दिए जाएंगे. यह स्थिति में बदलाव, सिर्फ़ पहले से ऑर्डर करने के लिए होता है.
deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

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

CancelOneTimeProductOfferRequest

ऑफ़र रद्द करने के लिए मैसेज का अनुरोध करें.

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

string

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

string

ज़रूरी है. जिस ऑफ़र को रद्द करना है उसका पैरंट वन-टाइम प्रॉडक्ट (आईडी).
purchaseOptionId

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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

DeactivateOneTimeProductOfferRequest

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

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

string

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

string

ज़रूरी है. जिस ऑफ़र को बंद करना है उसका पैरंट वन-टाइम प्रॉडक्ट (आईडी).
purchaseOptionId

string

ज़रूरी है. बंद किए जाने वाले ऑफ़र के लिए, खरीदारी का मुख्य विकल्प (आईडी).
offerId

string

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

enum (ProductUpdateLatencyTolerance)

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