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