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

YoutubeAssetAssociation में मौजूद किसी संसाधन से लिंक की गई YouTube ऐसेट.

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 से जुड़े होते हैं.

यह फ़ील्ड भरना ज़रूरी नहीं है. इसे सिर्फ़ तब सेट किया जा सकता है, जब 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 ऐसेट असोसिएशन की सूची दिखाता है.