REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

संसाधन: YoutubeAssetAssociation

किसी संसाधन और YouTube ऐसेट के बीच का असोसिएशन.

JSON के काेड में दिखाना
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
फ़ील्ड
name

string

आइडेंटिफ़ायर. असोसिएशन का संसाधन नाम.

लाइन आइटम-लेवल के असोसिएशन के लिए: नाम का पैटर्न advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId} है.

विज्ञापन ग्रुप-लेवल के ऐसेट ग्रुप के लिए: नाम का पैटर्न advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId} है.

YOUTUBE_ASSET_TYPE_LOCATION और YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION असोसिएशन के लिए: youtubeAssetAssociationId, लिंक किए गए ऐसेट सेट का आईडी है. अगर locationMatchingType या affiliateLocationMatchingType DISABLED है, तो यह 0 होता है.

YOUTUBE_ASSET_TYPE_SITELINK असोसिएशन के लिए: youtubeAssetAssociationId, लिंक की गई साइटलिंक ऐसेट का आईडी होगा.

youtubeAssetType

enum (YoutubeAssetType)

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

linkedYoutubeAsset

object (LinkedYouTubeAsset)

ज़रूरी है. संसाधन से जुड़ी YouTube ऐसेट.

YoutubeAssetType

YouTube ऐसेट के संभावित टाइप.

ये ऐसेट, विज्ञापन दिखाने के दौरान विज्ञापनों के साथ अतिरिक्त जानकारी दिखाती हैं.

Enums
YOUTUBE_ASSET_TYPE_UNSPECIFIED इस वर्शन में, YouTube ऐसेट टाइप के बारे में नहीं बताया गया है या इसकी जानकारी नहीं है.
YOUTUBE_ASSET_TYPE_LOCATION लोकेशन ऐसेट.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION अफ़िलिएट लोकेशन ऐसेट.

LinkedYouTubeAsset

YouTube ऐसेट, जो YoutubeAssetAssociation में मौजूद किसी संसाधन से लिंक होती है.

JSON के काेड में दिखाना
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
YouTube ऐसेट. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
locationAssetFilter

object (LocationAssetFilter)

लोकेशन ऐसेट फ़िल्टर.

इसे सिर्फ़ तब सेट किया जा सकता है, जब youtubeAssetType YOUTUBE_ASSET_TYPE_LOCATION हो.

affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

अफ़िलिएट लोकेशन ऐसेट फ़िल्टर.

इसे सिर्फ़ तब सेट किया जा सकता है, जब youtubeAssetType YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION हो.

एक-दूसरे से अलग फ़ील्ड के आखिर में.

LocationAssetFilter

ऐसा ऐसेट फ़िल्टर जो विज्ञापन दिखाने के लिए ज़रूरी शर्तों को पूरा करने वाली लोकेशन ऐसेट से मेल खाता हो.

JSON के काेड में दिखाना
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
फ़ील्ड
locationMatchingType

enum (LocationMatchingType)

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

assetSetId

string (int64 format)

सिर्फ़ आउटपुट के लिए. उस ऐसेट सेट का आईडी जो विज्ञापन दिखाने के लिए ज़रूरी शर्तों को पूरा करने वाली जगह की ऐसेट से मेल खाता है.

locationMatchingFunction

object (LocationMatchingFunction)

ज़रूरी नहीं. मैचिंग फ़ंक्शन, यह तय करता है कि लोकेशन ऐसेट फ़िल्टर, लोकेशन ऐसेट से कैसे मैच करता है.

यह फ़ील्ड भरना ज़रूरी है. इसे सिर्फ़ तब सेट किया जा सकता है, जब locationMatchingType FILTER या SELECTED_ASSETS हो.

LocationMatchingType

मैचिंग के संभावित टाइप, जिनसे यह तय होता है कि कौनसी लोकेशन ऐसेट दिखाने के लिए ज़रूरी शर्तें पूरी करती हैं.

Enums
LOCATION_MATCHING_TYPE_UNSPECIFIED इस वर्शन में, लोकेशन मैचिंग टाइप की जानकारी नहीं दी गई है या इसके बारे में पता नहीं है.
SELECT_ALL उपलब्ध सभी लोकेशन ऐसेट को दिखाया जा सकता है.
FILTER कारोबार के नाम और/या लेबल के लिए दिए गए फ़िल्टर से मेल खाने वाली लोकेशन ऐसेट दिखाई जा सकती हैं.
SELECTED_ASSETS सिर्फ़ चुनी गई लोकेशन ऐसेट दिखाई जा सकती हैं.
DISABLED कोई भी लोकेशन ऐसेट नहीं दिखाई जा सकती.

LocationMatchingFunction

लोकेशन ऐसेट फ़िल्टर के लिए मैचिंग फ़ंक्शन.

JSON के काेड में दिखाना
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
फ़ील्ड
labels[]

string

ज़रूरी नहीं. जिन लेबल से मैच करना है.

लेबल को लॉजिकल OR'ed के साथ जोड़ा जाता है.

यह फ़ील्ड भरना ज़रूरी नहीं है. इसे सिर्फ़ तब सेट किया जा सकता है, जब locationMatchingType को FILTER पर सेट किया गया हो.

locationAssetIds[]

string (int64 format)

ज़रूरी नहीं. चुनी गई लोकेशन ऐसेट के आईडी.

अगर locationMatchingType SELECTED_ASSETS है, तो यह फ़ील्ड भरना ज़रूरी है.

business

string

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

यह फ़ील्ड भरना ज़रूरी नहीं है. इसे सिर्फ़ तब सेट किया जा सकता है, जब locationMatchingType को FILTER पर सेट किया गया हो.

AffiliateLocationAssetFilter

ऐसेट फ़िल्टर, जो विज्ञापन दिखाने के लिए ज़रूरी शर्तों को पूरा करने वाली अफ़िलिएट लोकेशन ऐसेट से मेल खाता हो.

JSON के काेड में दिखाना
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
फ़ील्ड
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

ज़रूरी है. अफ़िलिएट लोकेशन ऐसेट के इस फ़िल्टर का मैचिंग टाइप.

assetSetId

string (int64 format)

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

affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

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

यह फ़ील्ड भरना ज़रूरी है. इसे सिर्फ़ तब सेट किया जा सकता है, जब affiliateLocationMatchingType SELECTED_CHAINS हो.

AffiliateLocationMatchingType

मिलान के संभावित टाइप, जिनसे यह तय होता है कि कौनसी अफ़िलिएट लोकेशन ऐसेट दिखाने की ज़रूरी शर्तें पूरी करती हैं.

Enums
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED इस वर्शन में, अफ़िलिएट लोकेशन मैचिंग टाइप की जानकारी नहीं दी गई है या इसकी जानकारी उपलब्ध नहीं है.
SELECT_ALL उपलब्ध सभी अफ़िलिएट लोकेशन ऐसेट को दिखाया जा सकता है.
SELECTED_CHAINS चुनी गई अफ़िलिएट लोकेशन ऐसेट दिखाई जा सकती हैं.
DISABLED कोई अफ़िलिएट लोकेशन ऐसेट नहीं दिखाई जा सकती.

AffiliateLocationMatchingFunction

अफ़िलिएट लोकेशन ऐसेट फ़िल्टर के लिए मैचिंग फ़ंक्शन.

JSON के काेड में दिखाना
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
फ़ील्ड
chains[]

object (AffiliateLocationChain)

ज़रूरी नहीं. चुनी गई अफ़िलिएट लोकेशन चेन के आईडी.

अगर affiliateLocationMatchingType SELECTED_CHAINS है, तो यह फ़ील्ड भरना ज़रूरी है.

AffiliateLocationChain

अफ़िलिएट लोकेशन की चेन.

JSON के काेड में दिखाना
{
  "chainId": string
}
फ़ील्ड
chainId

string (int64 format)

ज़रूरी है. अफ़िलिएट लोकेशन चेन का आईडी.

SitelinkAsset

साइटलिंक ऐसेट.

JSON के काेड में दिखाना
{
  "assetId": string
}
फ़ील्ड
assetId

string (int64 format)

ज़रूरी है. साइटलिंक ऐसेट का आईडी.

तरीके

create

इस तरीके से, पहचानी गई संसाधन और YouTube ऐसेट के बीच नया लिंक बनाया जाता है.

delete

इस तरीके का इस्तेमाल करके, पहचाने गए संसाधन और YouTube ऐसेट के बीच मौजूद असोसिएशन को मिटाया जा सकता है.

list

इस तरीके से, दिए गए संसाधन से लिंक किए गए YouTube ऐसेट असोसिएशन की सूची मिलती है.