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 هو معرّف مجموعة مواد العرض المرتبطة، أو 0 إذا كان locationMatchingType أو affiliateLocationMatchingType هو DISABLED.

بالنسبة إلى عمليات الربط في YOUTUBE_ASSET_TYPE_SITELINK: يجب أن يكون youtubeAssetAssociationId هو رقم تعريف مادة عرض رابط إلى قسم الموقع المرتبطة.
youtubeAssetType

enum (YoutubeAssetType)

الحقل مطلوب. نوع مادة العرض على YouTube المرتبطة بالمورد
linkedYoutubeAsset

object (LinkedYouTubeAsset)

الحقل مطلوب. تمثّل هذه السمة مادة العرض على YouTube المرتبطة بالمورد.

YoutubeAssetType

أنواع مواد العرض المحتملة على YouTube

ستعرض مواد العرض هذه معلومات إضافية بجانب الإعلانات أثناء عرضها.

عمليات التعداد
YOUTUBE_ASSET_TYPE_UNSPECIFIED لم يتم تحديد نوع مادة عرض على YouTube أو أنّه غير معروف في هذا الإصدار.
YOUTUBE_ASSET_TYPE_LOCATION مادة عرض الموقع الجغرافي
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION مادة عرض المواقع الجغرافي لشريك تابع

LinkedYouTubeAsset

مادة عرض على YouTube مرتبطة بمورد في 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.
}
الحقول
حقل الربط 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

أنواع المطابقة المحتملة التي تحدّد مواد عرض المواقع الجغرافية المؤهَّلة للعرض

عمليات التعداد
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

أنواع المطابقة المحتملة التي تحدّد مواد عرض مواقع المعلِنين الجغرافية المؤهَّلة للعرض

عمليات التعداد
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 المرتبطة بالمورد المحدّد.