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 
{

  // 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

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

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