Method: advertisers.adAssets.list

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

यह सिर्फ़ AdAssetType AD_ASSET_TYPE_YOUTUBE_VIDEO की ऐसेट को वापस पाने की सुविधा देता है.

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

GET https://displayvideo.googleapis.com/v4/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 देखें.