REST Resource: advertisers.youtubeAdGroupAds

المرجع: YoutubeAdGroupAd

إعلان واحد مرتبط بمجموعة إعلانية على YouTube.

تمثيل JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}
الحقول
name

string

اسم مورد الإعلان.
advertiserId

string (int64 format)

المعرّف الفريد للمعلن الذي ينتمي إليه الإعلان.
adGroupAdId

string (int64 format)

المعرّف الفريد للإعلان. يحدده النظام.
adGroupId

string (int64 format)

المعرّف الفريد للمجموعة الإعلانية التي ينتمي إليها الإعلان.
displayName

string

الاسم المعروض للإعلان.

يجب أن يكون بترميز UTF-8 بحيث لا يزيد حجمه عن 255 بايت.
entityStatus

enum (EntityStatus)

حالة الكيان للإعلان.
adUrls[]

object (AdUrl)

قائمة عناوين URL التي يستخدمها الإعلان.
حقل الربط ad_details تفاصيل الإعلان. يمكن أن يكون ad_details واحدًا فقط مما يلي:
displayVideoSourceAd

object (DisplayVideoSourceAd)

تفاصيل إعلان مصدره من تصميم إعلان على "مساحة العرض والفيديو 360".
mastheadAd

object (MastheadAd)

تفاصيل إعلان معروض على خلاصة الصفحة الرئيسية في YouTube
inStreamAd

object (InStreamAd)

تفاصيل إعلان ضمن البث قابل للتخطّي بعد 5 ثوانٍ، ويُستخدَم لزيادة الوعي بالعلامة التجارية أو تحقيق أهداف التسويق المتعلّقة بالوصول إلى الجمهور
nonSkippableAd

object (NonSkippableAd)

تفاصيل إعلان قصير غير قابل للتخطّي أثناء عرض الفيديو تتراوح مدّته بين 6 ثوانٍ و15 ثانية، ويُستخدَم لتحقيق الأهداف التسويقية
bumperAd

object (BumperAd)

تفاصيل إعلان فيديو قصير غير قابل للتخطّي، وتبلغ مدّته 6 ثوانٍ أو أقل، وتُستخدَم لمدى الوصول.
audioAd

object (AudioAd)

تفاصيل إعلان صوتي يُستخدَم لتحقيق الأهداف التسويقية
videoDiscoverAd

object (VideoDiscoveryAd)

تفاصيل إعلان يروّج لفيديو يظهر في أماكن الاكتشاف
videoPerformanceAd

object (VideoPerformanceAd)

تفاصيل إعلان مستخدَم في حملة فيديو إجرائية لجذب الإجراءات إلى النشاط التجاري أو الخدمة أو المنتج

DisplayVideoSourceAd

الإعلان الذي مصدره من تصميم إعلان في "مساحة العرض والفيديو 360"

تمثيل JSON 
{
  "creativeId": string
}
الحقول
creativeId

string (int64 format)

رقم تعريف تصميم الإعلان المصدر.

MastheadAd

تفاصيل إعلان التسمية الرئيسية

تمثيل JSON 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
الحقول
video

object (YoutubeVideoDetails)

فيديو YouTube الذي يستخدمه الإعلان.
headline

string

عنوان الإعلان.
description

string

وصف الإعلان
videoAspectRatio

enum (VideoAspectRatio)

نسبة العرض إلى الارتفاع لفيديو YouTube الذي يتمّ تشغيله تلقائيًا على إعلان التسمية الرئيسية.
autoplayVideoStartMillisecond

string (int64 format)

مقدار الوقت بالمللي ثانية الذي سيبدأ تشغيل الفيديو بعده.
autoplayVideoDuration

string (Duration format)

المدة الزمنية التي سيتم خلالها تشغيل الفيديو تلقائيًا.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"
callToActionButtonLabel

string

النص الظاهر على زر عبارة الحث على اتّخاذ إجراء
callToActionFinalUrl

string

عنوان URL المقصود لزر عبارة الحث على الشراء.
callToActionTrackingUrl

string

عنوان URL للتتبُّع لزر عبارة الحث على الشراء.
showChannelArt

boolean

لتحديد ما إذا كنت تريد عرض خلفية أو إعلان بانر في أعلى صفحة YouTube.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

الفيديوهات التي تظهر بجانب إعلان التسمية الرئيسية على أجهزة الكمبيوتر المكتبي يجب ألا يزيد عن اثنتين.

YoutubeVideoDetails

تفاصيل فيديو على YouTube

تمثيل JSON 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}
الحقول
id

string

معرّف فيديو YouTube الذي يمكن البحث عنه على صفحة YouTube الإلكترونية.
unavailableReason

enum (VideoUnavailableReason)

سبب عدم توفّر بيانات الفيديو

VideoUnavailableReason

الأسباب المحتملة لعدم توفّر فيديو معيّن.

عمليات التعداد
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED غير معروف أو غير محدّد
VIDEO_UNAVAILABLE_REASON_PRIVATE الفيديو خاص.
VIDEO_UNAVAILABLE_REASON_DELETED تم حذف الفيديو.

VideoAspectRatio

نِسب العرض إلى الارتفاع المحتمَلة لفيديو على YouTube

عمليات التعداد
VIDEO_ASPECT_RATIO_UNSPECIFIED غير محدّد أو غير معروف
VIDEO_ASPECT_RATIO_WIDESCREEN تم تمديد الفيديو واقتصاص الجزء العلوي والسفلي من الفيديو.
VIDEO_ASPECT_RATIO_FIXED_16_9 يستخدم الفيديو نسبة عرض إلى ارتفاع ثابتة تبلغ 16:9.

InStreamAd

تفاصيل الإعلان ضمن البث المباشر.

تمثيل JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
الحقول
commonInStreamAttribute

object (CommonInStreamAttribute)

سمات الإعلان الشائعة
customParameters

map (key: string, value: string)

المَعلمات المخصّصة لتمرير القيم المخصّصة إلى نموذج عنوان URL للتتبّع

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

CommonInStreamAttribute

السمات الشائعة للإعلانات أثناء عرض الفيديو والإعلانات غير القابلة للتخطي وإعلانات الملصقات الصغيرة

تمثيل JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
الحقول
displayUrl

string

هو عنوان صفحة الويب الذي يظهر مع الإعلان.
finalUrl

string

عنوان URL لصفحة الويب التي يصل إليها المستخدِمون بعد أن ينقروا على الإعلان.
trackingUrl

string

عنوان URL الذي تم تحميله في الخلفية لأغراض التتبّع.
actionButtonLabel

string

النص الظاهر على زر عبارة الحث على اتّخاذ إجراء
actionHeadline

string

عنوان بانر عبارة الحث على اتخاذ إجراء.
video

object (YoutubeVideoDetails)

فيديو YouTube للإعلان.
companionBanner

object (ImageAsset)

الصورة التي تظهر بجانب إعلان الفيديو

ImageAsset

البيانات الوصفية لمادة عرض صورة

تمثيل JSON 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}
الحقول
mimeType

string

نوع MIME لمادة عرض الصورة
fullSize

object (Dimensions)

البيانات الوصفية لهذه الصورة بحجمها الأصلي.
fileSize

string (int64 format)

حجم ملف مادة عرض الصورة بالبايت

NonSkippableAd

تفاصيل إعلان غير قابل للتخطّي

تمثيل JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
الحقول
commonInStreamAttribute

object (CommonInStreamAttribute)

سمات الإعلان الشائعة
customParameters

map (key: string, value: string)

المَعلمات المخصّصة لتمرير القيم المخصّصة إلى نموذج عنوان URL للتتبّع

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

إعلان ملصق صغير

تفاصيل إعلان ملصق صغير.

تمثيل JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
الحقول
commonInStreamAttribute

object (CommonInStreamAttribute)

سمات الإعلان الشائعة

AudioAd

تفاصيل إعلان صوتي.

تمثيل JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
الحقول
displayUrl

string

هو عنوان صفحة الويب الذي يظهر مع الإعلان.
finalUrl

string

عنوان URL لصفحة الويب التي يصل إليها المستخدِمون بعد أن ينقروا على الإعلان.
trackingUrl

string

عنوان URL الذي تم تحميله في الخلفية لأغراض التتبّع.
video

object (YoutubeVideoDetails)

فيديو YouTube للإعلان.

VideoDiscoveryAd

تفاصيل إعلان فيديو أثناء التصفّح

تمثيل JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
الحقول
headline

string

عنوان الإعلان.
description1

string

السطر الأول من نص الإعلان.
description2

string

السطر الثاني من الإعلان.
video

object (YoutubeVideoDetails)

فيديو YouTube الذي يروّج له الإعلان.
thumbnail

enum (Thumbnail)

صورة مصغّرة مستخدَمة في الإعلان

الصورة المصغّرة

خيارات الصور المصغّرة المحتمَلة في إعلانات الفيديو أثناء التصفّح

عمليات التعداد
THUMBNAIL_UNSPECIFIED غير معروف أو غير محدّد
THUMBNAIL_DEFAULT الصورة المصغّرة التلقائية يمكن إنشاؤها تلقائيًا أو تحميلها من قِبل المستخدم.
THUMBNAIL_1 الصورة المصغّرة 1، تم إنشاؤها من الفيديو
THUMBNAIL_2 الصورة المصغّرة 2، التي تم إنشاؤها من الفيديو
THUMBNAIL_3 الصورة المصغّرة 3، التي تم إنشاؤها من الفيديو

VideoPerformanceAd

تفاصيل إعلان أداء فيديو

تمثيل JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
الحقول
finalUrl

string

عنوان URL لصفحة الويب التي يصل إليها المستخدِمون بعد أن ينقروا على الإعلان.
trackingUrl

string

عنوان URL الذي تم تحميله في الخلفية لأغراض التتبّع
actionButtonLabels[]

string

قائمة مواد العرض النصية التي تظهر على زر عبارة الحث على اتّخاذ إجراء.
headlines[]

string

قائمة العناوين المعروضة على بانر الحث على اتخاذ إجراء.
longHeadlines[]

string

قائمة العناوين المنفردة المعروضة على بانر الحث على اتخاذ إجراء.
descriptions[]

string

قائمة الأوصاف المعروضة على بانر الحث على اتخاذ إجراء.
displayUrlBreadcrumb1

string

الجزء الأول بعد النطاق في عنوان URL المعروض
displayUrlBreadcrumb2

string

الجزء الثاني بعد النطاق في عنوان URL المعروض
domain

string

نطاق عنوان URL المعروض.
videos[]

object (YoutubeVideoDetails)

قائمة بمواد عرض الفيديو على YouTube التي يستخدمها هذا الإعلان.
customParameters

map (key: string, value: string)

المعلّمات المخصّصة لتمرير القيم المخصّصة إلى نموذج عنوان URL للتتبّع.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
companionBanners[]

object (ImageAsset)

قائمة إعلانات البانر المصاحبة التي يستخدمها هذا الإعلان.

AdUrl

عناوين URL إضافية ذات صلة بالإعلان، بما في ذلك الإشارات.

تمثيل JSON 
{
  "type": enum (AdUrlType),
  "url": string
}
الحقول
type

enum (AdUrlType)

نوع عنوان URL للإعلان.
url

string

قيمة سلسلة عنوان URL

AdUrlType

أنواع عناوين URL المحتملة للإعلانات.

عمليات التعداد
AD_URL_TYPE_UNSPECIFIED غير معروف أو غير محدّد
AD_URL_TYPE_BEACON_IMPRESSION بكسل تتبُّع بحجم 1×1 يتم استخدامه لإرسال إشعار عند ظهور تصميم إعلان.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION إشارة ظهور DCM القابلة للتوسيع. وفي وقت العرض، يتم توسيعه ليشمل عدة إشارات.
AD_URL_TYPE_BEACON_CLICK عنوان URL للتتبُّع الذي يتم إرسال إشعار إليه عند بدء حدث النقر
AD_URL_TYPE_BEACON_SKIP عنوان URL للتتبّع الذي يتم إرسال إشعار إليه عند بدء حدث التخطّي

الطُرق

get

 الحصول على إعلان مجموعة إعلانية على YouTube.

list

 يعرض إعلانات المجموعات الإعلانية على YouTube.