Method: advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.list

यह फ़ंक्शन, दिए गए संसाधन से जुड़े YouTube ऐसेट असोसिएशन की सूची दिखाता है.

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

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems/{linkedEntity.lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. विज्ञापन देने वाले उस व्यक्ति या कंपनी का आईडी जिससे लिंक की गई इकाई जुड़ी है.
यूनियन पैरामीटर entity. वह इकाई जिसे YouTube ऐसेट के साथ जोड़ना है. entity इनमें से सिर्फ़ एक हो सकता है:
linkedEntity.lineItemId

string (int64 format)

लाइन आइटम का आईडी.
youtubeAssetType

enum (YoutubeAssetType)

ज़रूरी है. YouTube की उस ऐसेट का टाइप जिसे संसाधन से जोड़ा जा रहा है.

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

पैरामीटर
यूनियन पैरामीटर entity. वह इकाई जिसे YouTube ऐसेट के साथ जोड़ना है. entity इनमें से सिर्फ़ एक हो सकता है:
linkedEntity.adGroupId

string (int64 format)

विज्ञापन ग्रुप का आईडी.
pageSize

integer

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

string

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

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

string

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

सिर्फ़ ये वैल्यू इस्तेमाल की जा सकती हैं:

  • linkedYoutubeAsset.locationAssetFilter.assetSetId,
  • linkedYoutubeAsset.affiliateLocationAssetFilter.assetSetId,
  • linkedYoutubeAsset.sitelinkAsset.assetId

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

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

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

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में ListYoutubeAssetAssociationsResponse का एक इंस्टेंस शामिल किया जाता है.

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

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

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

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