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 के काेड में दिखाना
{

  // Union field youtube_asset can be only one of the following:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of list of possible types for union field youtube_asset.
}
फ़ील्ड
यूनियन फ़ील्ड youtube_asset. YouTube ऐसेट. youtube_asset इनमें से सिर्फ़ एक हो सकता है:
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 ऐसेट असोसिएशन की सूची मिलती है.