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 के काेड में दिखाना
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
लागू किए जाने वाले स्टेट ट्रांज़िशन का टाइप. इनमें से सिर्फ़ एक को सेट किया जाना चाहिए. यहां उन फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

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

cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

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

deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

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

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

CancelOneTimeProductOfferRequest

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

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

string

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

productId

string

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

purchaseOptionId

string

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

offerId

string

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

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)

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