Method: advertisers.creatives.list

यह किसी विज्ञापन देने वाले में क्रिएटिव की सूची बनाता है.

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

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

GET https://displayvideo.googleapis.com/v1beta2/advertisers/{advertiserId}/creatives

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. विज्ञापन देने वाले का वह आईडी जिसके लिए क्रिएटिव को सूची में शामिल करना है.

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

पैरामीटर
pageSize

integer

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

string

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

string

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

  • creativeId (डिफ़ॉल्ट)
  • createTime
  • mediaDuration
  • dimensions (पहले चौड़ाई के अनुसार, फिर ऊंचाई के अनुसार क्रम से लगाता है)

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

string

यह क्रिएटिव प्रॉपर्टी के हिसाब से फ़िल्टर करने की अनुमति देता है.

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

  • फ़िल्टर एक्सप्रेशन में एक या ज़्यादा पाबंदियां होती हैं.
  • एक ही फ़ील्ड के लिए प्रतिबंध को OR के हिसाब से जोड़ा जाना चाहिए.
  • अलग-अलग फ़ील्ड के लिए सीमाओं को AND के हिसाब से जोड़ा जाना चाहिए.
  • ( से ) के बीच, किसी एक फ़ील्ड के लिए सिर्फ़ OR के हिसाब से पाबंदियां लगाई जा सकती हैं.
  • पाबंदी {field} {operator} {value} में होती है.
  • इन फ़ील्ड के लिए, ऑपरेटर EQUALS (=) होना चाहिए:
    • entityStatus
    • creativeType.
    • dimensions
    • minDuration
    • maxDuration
    • approvalStatus
    • exchangeReviewStatus
    • dynamic
    • creativeId
  • इन फ़ील्ड के लिए, ऑपरेटर HAS (:) होना चाहिए:
    • lineItemIds
  • इन फ़ील्ड के लिए, ऑपरेटर GREATER THAN OR EQUAL TO (>=) या LESS THAN OR EQUAL TO (<=) होना चाहिए:
    • updateTime (ISO 8601 फ़ॉर्मैट में इनपुट करें या YYYY-MM-DDTHH:MM:SSZ में डालें)
  • entityStatus, minDuration, maxDuration, updateTime, और dynamic के लिए, ज़्यादा से ज़्यादा एक पाबंदी हो सकती है.
  • dimensions के लिए, इसकी वैल्यू "{width}x{height}" के तौर पर होती है.
  • exchangeReviewStatus के लिए, इसकी वैल्यू {exchange}-{reviewStatus} के तौर पर होती है.
  • minDuration और maxDuration के लिए, यह वैल्यू "{duration}s" के तौर पर होती है. मिलीसेकंड में जानकारी इस्तेमाल करने पर, सिर्फ़ कुछ सेकंड ही काम करते हैं.
  • updateTime के लिए, क्रिएटिव संसाधन के फ़ील्ड की वैल्यू से पता चलता है कि क्रिएटिव को पिछली बार कब अपडेट किया गया था.इसमें सिस्टम से किए गए अपडेट भी शामिल होते हैं. जैसे, क्रिएटिव की समीक्षा से जुड़े अपडेट.
  • एक से ज़्यादा संभावित लाइन आइटम आईडी के आधार पर खोज करने के लिए, lineItemIds की एक से ज़्यादा पाबंदियां हो सकती हैं.
  • एक से ज़्यादा क्रिएटिव आईडी के ख़िलाफ़ खोज करने पर, creativeId की कई पाबंदियां हो सकती हैं.

उदाहरण:

  • सभी नेटिव क्रिएटिव: creativeType="CREATIVE_TYPE_NATIVE"
  • 300x400 या 50x100 डाइमेंशन वाले सभी चालू क्रिएटिव: entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400" OR dimensions="50x100")
  • वे सभी डाइनैमिक क्रिएटिव जिन्हें AdX या AppNexus से मंज़ूरी मिली है. इनकी कम से कम अवधि 5 सेकंड और 200 मि॰से॰ होनी चाहिए. dynamic="true" AND minDuration="5.2s" AND (exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED" OR exchangeReviewStatus="EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED") अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  • लाइन आइटम आईडी 1 या 2: creativeType="CREATIVE_TYPE_VIDEO" AND (lineItemIds:1 OR lineItemIds:2) से जुड़े सभी वीडियो क्रिएटिव
  • एक से ज़्यादा क्रिएटिव आईडी के आधार पर क्रिएटिव ढूंढें: creativeId=1 OR creativeId=2

  • वे सभी क्रिएटिव जिनका अपडेट होने का समय 2020-11-04T18:54:47Z (format of ISO 8601) या इससे ज़्यादा है: updateTime>="2020-11-04T18:54:47Z" इस फ़ील्ड में 500 से ज़्यादा वर्ण नहीं होने चाहिए.

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

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

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

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

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

object (Creative)

क्रिएटिव की सूची.

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

string

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

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

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

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

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