REST Resource: advertisers.youtubeAdGroupAds

{
  "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.
}

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

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

enum (EntityStatus)

حالة الكيان للإعلان.

object (AdUrl)

قائمة عناوين URL التي يستخدمها الإعلان.

object (DisplayVideoSourceAd)

تفاصيل إعلان مصدره "الشبكة الإعلانية" تصميم إعلان الفيديو 360.

object (MastheadAd)

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

object (InStreamAd)

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

object (NonSkippableAd)

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

object (BumperAd)

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

object (AudioAd)

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

object (VideoDiscoveryAd)

تفاصيل إعلان يروّج لفيديو يظهر في أماكن العثور على المحتوى.

object (VideoPerformanceAd)

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

{
  "creativeId": string
}

string (int64 format)

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

{
  "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)
    }
  ]
}

object (YoutubeVideoDetails)

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

string

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

string

وصف الإعلان.

enum (VideoAspectRatio)

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

string (int64 format)

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

string (Duration format)

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

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

string

النص الموجود على زر عبارة الحث على اتخاذ إجراء.

string

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

string

عنوان URL لمتابعة الأداء لزر الحث على اتخاذ إجراء.

boolean

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

object (YoutubeVideoDetails)

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

{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}

string

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

enum (VideoUnavailableReason)

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

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object (CommonInStreamAttribute)

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

map (key: string, value: string)

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

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

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}

string

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

string

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

string

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

string

النص الموجود على زر عبارة الحث على اتخاذ إجراء.

string

العنوان الرئيسي لبانر الحث على اتخاذ إجراء.

object (YoutubeVideoDetails)

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

object (ImageAsset)

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

{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}

string

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

object (Dimensions)

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

string (int64 format)

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

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object (CommonInStreamAttribute)

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

map (key: string, value: string)

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

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

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}

object (CommonInStreamAttribute)

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

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}

string

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

string

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

string

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

object (YoutubeVideoDetails)

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

{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}

string

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

string

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

string

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

object (YoutubeVideoDetails)

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

enum (Thumbnail)

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

{
  "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)
    }
  ]
}

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

object (YoutubeVideoDetails)

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

map (key: string, value: string)

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

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

object (ImageAsset)

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

{
  "type": enum (AdUrlType),
  "url": string
}

enum (AdUrlType)

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

string

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