Method: advertisers.adAssets.list

विज्ञापन देने वाले के आईडी के तहत, विज्ञापन की ऐसेट की सूची दिखाता है.

सिर्फ़ AdAssetType AD_ASSET_TYPE_YOUTUBE_VIDEO की ऐसेट को वापस लाया जा सकता है.

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

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

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. विज्ञापन देने वाले उस व्यक्ति या कंपनी का आईडी जिससे विज्ञापन की ऐसेट जुड़ी हैं.

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

पैरामीटर
pageSize

integer

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

string

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

string

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

  • entityStatus
  • youtubeVideoAsset.youtubeVideoId
  • adAssetId (डिफ़ॉल्ट)

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

string

ज़रूरी नहीं. विज्ञापन की ऐसेट के फ़ील्ड के हिसाब से नतीजों को फ़िल्टर करने की अनुमति देता है.

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

  • पाबंदी का फ़ॉर्मैट {field} {operator} {value} है.
  • सभी फ़ील्ड में EQUALS (=) ऑपरेटर का इस्तेमाल करना ज़रूरी है.

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

  • youtubeVideoAsset.youtubeVideoId
  • entityStatus

उदाहरण:

  • विज्ञापन देने वाले किसी व्यक्ति या कंपनी के खाते में मौजूद, YouTube वीडियो विज्ञापन की सभी चालू ऐसेट: entityStatus=ENTITY_STATUS_ACTIVE

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

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

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

adAssets.list के लिए जवाब वाला मैसेज.

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

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

object (AdAsset)

विज्ञापन की ऐसेट की सूची. सूची में सिर्फ़ AdAssetType AD_ASSET_TYPE_YOUTUBE_VIDEO की ऐसेट शामिल होंगी.

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

string

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

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

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

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

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