हर नए लाइन आइटम को यह एलान करना होगा कि वह यूरोपियन यूनियन (ईयू) में राजनैतिक विज्ञापन दिखाएगा या नहीं. Display & Video 360 API और एसडीएफ़ अपलोड करने की उन कार्रवाइयों को पूरा नहीं किया जा सकेगा जिनमें घोषणाएं नहीं की गई हैं. ज़्यादा जानकारी के लिए, हमारा समर्थन नहीं होने या रुकने का पेज देखें.
विज्ञापन देने वाले व्यक्ति या कंपनी के क्रिएटिव की सूची बनाता है.
क्रम, orderBy पैरामीटर से तय होता है. अगर entityStatus by entityStatus की जानकारी नहीं दी गई है, तो ENTITY_STATUS_ARCHIVED वाले क्रिएटिव को नतीजों में शामिल नहीं किया जाएगा.filter
एचटीटीपी अनुरोध
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/creatives
ज़रूरी है. विज्ञापन देने वाले उस व्यक्ति या कंपनी का आईडी जिसके क्रिएटिव की सूची बनानी है.
क्वेरी पैरामीटर
पैरामीटर
pageSize
integer
अनुरोध किया गया पेज साइज़. 1 और 200 के बीच होना चाहिए. अगर इसे तय नहीं किया गया है, तो डिफ़ॉल्ट रूप से 100 लागू हो जाएगा. अगर कोई अमान्य वैल्यू दी जाती है, तो गड़बड़ी कोड INVALID_ARGUMENT दिखाता है.
pageToken
string
यह एक टोकन है. इससे नतीजों के उस पेज की पहचान होती है जिसे सर्वर को दिखाना चाहिए. आम तौर पर, यह nextPageToken की वह वैल्यू होती है जो creatives.list तरीके को पिछली बार कॉल करने पर मिली थी. अगर इसे तय नहीं किया जाता है, तो नतीजों का पहला पेज दिखेगा.
orderBy
string
वह फ़ील्ड जिसके हिसाब से सूची को क्रम से लगाना है. इन वैल्यू का इस्तेमाल किया जा सकता है:
creativeId (डिफ़ॉल्ट)
createTime
mediaDuration
dimensions (चौड़ाई के हिसाब से पहले और फिर लंबाई के हिसाब से क्रमबद्ध करता है)
डिफ़ॉल्ट रूप से, क्रम बढ़ते हुए क्रम में होता है. किसी फ़ील्ड के लिए घटते क्रम को तय करने के लिए, फ़ील्ड के नाम में "desc" प्रत्यय जोड़ना चाहिए. उदाहरण: createTime desc.
filter
string
इससे क्रिएटिव फ़ील्ड के हिसाब से फ़िल्टर करने की अनुमति मिलती है.
इस्तेमाल किया जा सकने वाला सिंटैक्स:
फ़िल्टर एक्सप्रेशन, एक या उससे ज़्यादा पाबंदियों से मिलकर बने होते हैं.
पाबंदियों को AND या OR लॉजिकल ऑपरेटर के साथ जोड़ा जा सकता है. पाबंदियों के क्रम में, AND का इस्तेमाल किया जाता है.
पाबंदी {field} {operator} {value} के फ़ॉर्म में होती है.
lineItemIds फ़ील्ड में, HAS (:) ऑपरेटर का इस्तेमाल किया जाना चाहिए.
updateTime फ़ील्ड में, GREATER THAN OR EQUAL TO (>=) या LESS THAN OR EQUAL TO (<=) ऑपरेटर का इस्तेमाल किया जाना चाहिए.
अन्य सभी फ़ील्ड में EQUALS (=) ऑपरेटर का इस्तेमाल किया जाना चाहिए.
entityStatus, minDuration, maxDuration, updateTime, और dynamic फ़ील्ड के लिए, ज़्यादा से ज़्यादा एक पाबंदी हो सकती है.
इन फ़ील्ड के लिए डेटा ट्रांसफ़र किया जा सकता है:
approvalStatus
creativeId
creativeType
dimensions ({width}x{height} के तौर पर इनपुट)
dynamic
entityStatus
exchangeReviewStatus ({exchange}-{reviewStatus} के तौर पर इनपुट)
lineItemIds
maxDuration (इनपुट {duration}s के तौर पर. सिर्फ़ सेकंड में वैल्यू डाली जा सकती है)
minDuration (इनपुट {duration}s के तौर पर. सिर्फ़ सेकंड में वैल्यू डाली जा सकती है)
updateTime (ISO 8601 फ़ॉर्मैट में इनपुट या YYYY-MM-DDTHH:MM:SSZ)
ध्यान दें:
updateTime के लिए, क्रिएटिव रिसॉर्स के फ़ील्ड की वैल्यू से पता चलता है कि क्रिएटिव को आखिरी बार कब अपडेट किया गया था.इसमें सिस्टम की ओर से किए गए अपडेट भी शामिल हैं. जैसे, क्रिएटिव की समीक्षा से जुड़े अपडेट.
उदाहरण:
सभी नेटिव क्रिएटिव: creativeType="CREATIVE_TYPE_NATIVE"
300x400 या 50x100 डाइमेंशन वाले सभी चालू क्रिएटिव: entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400"
OR dimensions="50x100")
AdX या AppNexus से मंज़ूरी पा चुके सभी डाइनैमिक क्रिएटिव, जिनकी अवधि कम से कम पांच सेकंड और 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 (आईएसओ 8601 फ़ॉर्मैट) से ज़्यादा या इसके बराबर है: updateTime>="2020-11-04T18:54:47Z"
इस फ़ील्ड में 500 से ज़्यादा वर्ण नहीं होने चाहिए.
नतीजों का अगला पेज पाने के लिए टोकन. नतीजों का अगला पेज पाने के लिए, ListCreativesRequest तरीके को किए जाने वाले अगले कॉल में, pageToken फ़ील्ड में यह वैल्यू पास करें. अगर यह फ़ील्ड शून्य है, तो इसका मतलब है कि यह आखिरी पेज है.
[null,null,["आखिरी बार 2025-09-09 (UTC) को अपडेट किया गया."],[[["\u003cp\u003eLists creatives, ordered by \u003ccode\u003ecreativeId\u003c/code\u003e, \u003ccode\u003ecreateTime\u003c/code\u003e, \u003ccode\u003emediaDuration\u003c/code\u003e, or \u003ccode\u003edimensions\u003c/code\u003e, for a given advertiser.\u003c/p\u003e\n"],["\u003cp\u003eFilter creatives by \u003ccode\u003eapprovalStatus\u003c/code\u003e, \u003ccode\u003ecreativeId\u003c/code\u003e, \u003ccode\u003ecreativeType\u003c/code\u003e, \u003ccode\u003edimensions\u003c/code\u003e, \u003ccode\u003edynamic\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, \u003ccode\u003eexchangeReviewStatus\u003c/code\u003e, \u003ccode\u003elineItemIds\u003c/code\u003e, \u003ccode\u003emaxDuration\u003c/code\u003e, \u003ccode\u003eminDuration\u003c/code\u003e, or \u003ccode\u003eupdateTime\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eArchived creatives are excluded unless explicitly filtered for.\u003c/p\u003e\n"],["\u003cp\u003eResults are paginated, with control over page size and retrieval of subsequent pages using tokens.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,[]]
