Method: accounts.promotions.list

यह डायलॉग बॉक्स आपके Merchant Center खाते में प्रमोशन की जानकारी देता है. जवाब में, pageSize में बताए गए आइटम से कम आइटम हो सकते हैं. और आइटम का अनुरोध किया जाना है या नहीं, यह पता करने के लिए pageToken पर भरोसा करें.

प्रमोशन को शामिल या अपडेट करने के बाद, प्रोसेस किए गए अपडेट किए गए प्रमोशन को वापस पाने में कुछ मिनट लग सकते हैं.

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

GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. वह खाता जिसके लिए प्रोसेस किए गए प्रमोशन की सूची बनानी है. फ़ॉर्मैट: accounts/{account}

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

सिर्फ़ आउटपुट के लिए. लौटाए जाने वाले प्रमोशन की ज़्यादा से ज़्यादा संख्या. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए. ज़्यादा से ज़्यादा वैल्यू 250 हो सकती है. 250 से ज़्यादा वैल्यू को 250 मान लिया जाएगा. अगर कोई वैल्यू सबमिट नहीं की जाती है, तो ज़्यादा से ज़्यादा प्रमोशन दिखाए जाएंगे.
pageToken

string

सिर्फ़ आउटपुट के लिए. पेज टोकन, जो पिछले promotions.list कॉल से मिला था. अगले पेज को वापस पाने के लिए, यह जानकारी दें.

पेजेशन करते समय, promotions.list के लिए दिए गए सभी अन्य पैरामीटर, उस कॉल से मेल खाने चाहिए जिसने पेज टोकन दिया था.

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

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

promotions.list तरीके के लिए रिस्पॉन्स मैसेज.

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

JSON के काेड में दिखाना 
{
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
promotions[]

object (Promotion)

बताए गए खाते से प्रोसेस किए गए प्रमोशन.
nextPageToken

string

अगला पेज पाने के लिए, pageToken के तौर पर भेजा जा सकने वाला टोकन. अगर इस फ़ील्ड को हटा दिया जाता है, तो इसके बाद कोई पेज नहीं होता.

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

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

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.