Method: advertisers.insertionOrders.list

विज्ञापन देने वाले के लिस्ट इंसर्शन ऑर्डर की सूची दिखाता है.

यह क्रम, orderBy पैरामीटर से तय होता है. अगर filter और entityStatus की जानकारी नहीं दी जाती है, तो ENTITY_STATUS_ARCHIVED वाले इंसर्शन ऑर्डर, नतीजों में शामिल नहीं किए जाएंगे.

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

GET https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/insertionOrders

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. विज्ञापन देने वाले उस व्यक्ति या कंपनी का आईडी जिसके इंसर्शन ऑर्डर की सूची बनानी है.

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

पैरामीटर
pageSize

integer

अनुरोध किए गए पेज का साइज़. यह 1 और 100 के बीच होना चाहिए. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू 100 होती है. अगर कोई अमान्य वैल्यू दी जाती है, तो गड़बड़ी का कोड INVALID_ARGUMENT दिखता है.
pageToken

string

नतीजों के पेज की पहचान करने वाला टोकन, जिसे सर्वर को दिखाना चाहिए. आम तौर पर, यह nextPageToken की वह वैल्यू होती है जो insertionOrders.list तरीके को किए गए पिछले कॉल से मिलती है. अगर इसे तय नहीं किया जाता है, तो नतीजों का पहला पेज दिखेगा.
orderBy

string

वह फ़ील्ड जिसके हिसाब से सूची को क्रम से लगाना है. ये वैल्यू डाली जा सकती हैं:

  • "displayName" (डिफ़ॉल्ट)
  • "entityStatus"
  • "updateTime"

डिफ़ॉल्ट रूप से, डेटा को बढ़ते क्रम में लगाया जाता है. किसी फ़ील्ड के लिए घटते क्रम को तय करने के लिए, फ़ील्ड के नाम में सफ़िक्स "desc" जोड़ना चाहिए. उदाहरण: displayName desc.
filter

string

इंसर्शन ऑर्डर के फ़ील्ड के हिसाब से फ़िल्टर करने की अनुमति देता है.

इस्तेमाल किया जा सकने वाला सिंटैक्स:

  • फ़िल्टर एक्सप्रेशन, एक या उससे ज़्यादा पाबंदियों से बने होते हैं.
  • पाबंदियों को AND या OR लॉजिकल ऑपरेटर के साथ जोड़ा जा सकता है. पाबंदियों का क्रम, साफ़ तौर पर AND का इस्तेमाल करता है.
  • पाबंदी का फ़ॉर्मैट {field} {operator} {value} है.
  • updateTime फ़ील्ड में, GREATER THAN OR EQUAL TO (>=) या LESS THAN OR EQUAL TO (<=) ऑपरेटर का इस्तेमाल करना ज़रूरी है.
  • अन्य सभी फ़ील्ड में EQUALS (=) ऑपरेटर का इस्तेमाल करना ज़रूरी है.

इस्तेमाल किए जा सकने वाले फ़ील्ड:

  • campaignId
  • displayName
  • entityStatus
  • updateTime (आईएसओ 8601 फ़ॉर्मैट या YYYY-MM-DDTHH:MM:SSZ में इनपुट)

उदाहरण:

  • किसी कैंपेन के तहत सभी इंसर्शन ऑर्डर: campaignId="1234"
  • विज्ञापन देने वाले किसी व्यक्ति या कंपनी के सभी ENTITY_STATUS_ACTIVE या ENTITY_STATUS_PAUSED इंसर्शन ऑर्डर: (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED")
  • वे सभी इंसर्शन ऑर्डर जिन्हें 2020-11-04T18:54:47Z (ISO 8601 का फ़ॉर्मैट) या इससे पहले अपडेट किया गया है: updateTime<="2020-11-04T18:54:47Z"
  • वे सभी इंसर्शन ऑर्डर जिन्हें 2020-11-04T18:54:47Z (ISO 8601 का फ़ॉर्मैट) या इसके बाद अपडेट किया गया है: updateTime>="2020-11-04T18:54:47Z"

इस फ़ील्ड में 500 से ज़्यादा वर्ण नहीं होने चाहिए.

ज़्यादा जानकारी के लिए, LIST अनुरोधों को फ़िल्टर करना गाइड देखें.

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

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

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

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "insertionOrders": [
    {
      object (InsertionOrder)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
insertionOrders[]

object (InsertionOrder)

इंसर्शन ऑर्डर की सूची.

अगर सूची खाली है, तो यह नहीं दिखेगी.
nextPageToken

string

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

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

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/display-video

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