REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

منبع: YoutubeAssetAssociation

ارتباط بین یک منبع و یک محتوای یوتیوب.

نمایش 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 )

الزامی. نوع محتوای یوتیوب مرتبط با منبع.

linkedYoutubeAsset

object ( LinkedYouTubeAsset )

الزامی. محتوای یوتیوب مرتبط با منبع.

یوتیوبنوع دارایی

انواع احتمالی دارایی‌های یوتیوب.

این محتواها در حین نمایش، اطلاعات اضافی را در کنار تبلیغات نشان می‌دهند.

انوم‌ها
YOUTUBE_ASSET_TYPE_UNSPECIFIED نوع دارایی یوتیوب در این نسخه مشخص نشده یا ناشناخته است.
YOUTUBE_ASSET_TYPE_LOCATION دارایی موقعیت مکانی.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION دارایی موقعیت مکانی وابسته.

دارایی لینکدینیوتیوب

یک محتوای یوتیوب که به منبعی در YoutubeAssetAssociation لینک شده است.

نمایش 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.
}
فیلدها
فیلد Union به youtube_asset . دارایی یوتیوب. youtube_asset فقط می‌تواند یکی از موارد زیر باشد:
locationAssetFilter

object ( LocationAssetFilter )

فیلتر دارایی‌های مکانی.

این فقط زمانی قابل تنظیم است که youtubeAssetType YOUTUBE_ASSET_TYPE_LOCATION باشد.

affiliateLocationAssetFilter

object ( AffiliateLocationAssetFilter )

فیلتر دارایی‌های مربوط به موقعیت مکانی وابسته.

این فقط زمانی قابل تنظیم است که youtubeAssetType برابر با YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION باشد.

فیلتر دارایی موقعیت مکانی

فیلتر دارایی که دارایی‌های مکان واجد شرایط برای ارائه خدمات را مطابقت می‌دهد.

نمایش JSON 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
فیلدها
locationMatchingType

enum ( LocationMatchingType )

الزامی. نوع تطبیق این فیلتر دارایی مکان.

assetSetId

string ( int64 format)

فقط خروجی. شناسه مجموعه دارایی که با دارایی‌های مکانی واجد شرایط ارائه مطابقت دارد.

locationMatchingFunction

object ( LocationMatchingFunction )

اختیاری. تابع تطبیق که نشان می‌دهد فیلتر دارایی مکان چگونه با دارایی‌های مکان مطابقت دارد.

این فیلد الزامی است و فقط در صورتی قابل تنظیم است که locationMatchingType FILTER یا SELECTED_ASSETS باشد.

نوع تطبیق موقعیت مکانی

انواع تطبیق احتمالی که تصمیم می‌گیرند کدام دارایی‌های مکانی واجد شرایط ارائه خدمات هستند.

انوم‌ها
LOCATION_MATCHING_TYPE_UNSPECIFIED نوع تطبیق مکان در این نسخه مشخص نشده یا ناشناخته است.
SELECT_ALL تمام دارایی‌های مکانی موجود واجد شرایط ارائه خدمت هستند.
FILTER دارایی‌های مکانی که با نام کسب‌وکار و/یا فیلترهای برچسب ارائه شده مطابقت دارند، می‌توانند ارائه شوند.
SELECTED_ASSETS فقط دارایی‌های مکان انتخاب‌شده می‌توانند سرویس‌دهی کنند.
DISABLED هیچ دارایی مکانی نمی‌تواند خدمت‌رسانی کند.

تابع تطبیق موقعیت مکانی

تابع تطبیق برای فیلتر دارایی‌های مکانی.

نمایش JSON 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
فیلدها
labels[]

string

اختیاری. برچسبی که باید با آن مطابقت داده شود.

برچسب‌ها به صورت منطقی با هم OR می‌شوند.

این فیلد اختیاری است و فقط در صورتی قابل تنظیم است که locationMatchingType FILTER باشد.

locationAssetIds[]

string ( int64 format)

اختیاری. شناسه‌های دارایی مکان انتخاب‌شده.

اگر locationMatchingType SELECTED_ASSETS باشد، این فیلد الزامی است.

business

string

اختیاری. نام تجاری که باید با آن مطابقت داشته باشد.

این فیلد اختیاری است و فقط در صورتی قابل تنظیم است که locationMatchingType FILTER باشد.

فیلتر دارایی موقعیت مکانی وابسته

فیلتر دارایی که دارایی‌های واجد شرایط موقعیت مکانی وابسته را برای ارائه خدمات مطابقت می‌دهد.

نمایش JSON 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
فیلدها
affiliateLocationMatchingType

enum ( AffiliateLocationMatchingType )

الزامی. نوع منطبق با فیلتر دارایی‌های موقعیت مکانی وابسته.

assetSetId

string ( int64 format)

فقط خروجی. شناسه مجموعه دارایی که با دارایی‌های مکان وابسته واجد شرایط ارائه خدمات مطابقت دارد.

affiliateLocationMatchingFunction

object ( AffiliateLocationMatchingFunction )

اختیاری. تابع تطبیق که نشان می‌دهد چگونه فیلتر دارایی‌های مکان وابسته با دارایی‌های مکان وابسته مطابقت دارد.

این فیلد الزامی است و فقط در صورتی قابل تنظیم است که affiliateLocationMatchingType SELECTED_CHAINS باشد.

نوع تطبیق موقعیت مکانی وابسته

انواع تطبیق احتمالی که تصمیم می‌گیرند کدام دارایی‌های مکانی وابسته واجد شرایط ارائه خدمات هستند.

انوم‌ها
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED نوع تطبیق مکان وابسته در این نسخه مشخص نشده یا ناشناخته است.
SELECT_ALL تمام دارایی‌های موجود در مکان‌های وابسته واجد شرایط ارائه خدمات هستند.
SELECTED_CHAINS دارایی‌های مکان وابسته انتخاب‌شده می‌توانند خدمت‌رسانی کنند.
DISABLED هیچ دارایی مکانی وابسته‌ای نمی‌تواند خدمت‌رسانی کند.

تابع تطبیق موقعیت مکانی وابسته

تابع تطبیق برای فیلتر دارایی‌های مکانی وابسته.

نمایش JSON 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
فیلدها
chains[]

object ( AffiliateLocationChain )

اختیاری. شناسه‌های زنجیره مکان وابسته انتخاب‌شده.

اگر affiliateLocationMatchingType SELECTED_CHAINS باشد، این فیلد الزامی است.

زنجیره موقعیت مکانی وابسته

زنجیره‌ای از مکان‌های وابسته.

نمایش JSON 
{
  "chainId": string
}
فیلدها
chainId

string ( int64 format)

الزامی. شناسه زنجیره مکان‌های وابسته.

دارایی پیوند سایت

یک دارایی لینک سایت.

نمایش JSON 
{
  "assetId": string
}
فیلدها
assetId

string ( int64 format)

الزامی. شناسه‌ی سایت‌لینک.

روش‌ها

create

 یک ارتباط جدید بین منبع شناسایی شده و یک محتوای یوتیوب ایجاد می‌کند.

delete

 ارتباط موجود بین منبع شناسایی‌شده و یک محتوای یوتیوب را حذف می‌کند.

list

 فهرستی از منابع یوتیوب مرتبط با منبع داده شده را نشان می‌دهد.