REST Resource: advertisers.adGroupAds

المورد: AdGroupAd

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of mutually exclusive fields.
}
الحقول
name

string

النتائج فقط. اسم مصدر الإعلان
advertiserId

string (int64 format)

النتائج فقط. المعرّف الفريد للمعلِن الذي ينتمي إليه الإعلان.
adGroupAdId

string (int64 format)

النتائج فقط. المعرّف الفريد للإعلان. يتمّ تخصيصه من قِبل النظام.
adGroupId

string (int64 format)

الحقل مطلوب. غير قابل للتغيير المعرّف الفريد للمجموعة الإعلانية التي ينتمي إليها الإعلان.
displayName

string

الحقل مطلوب. الاسم المعروض للإعلان

يجب أن يكون الترميز UTF-8 وبحجم 255 بايت كحد أقصى.
adPolicy

object (AdPolicy)

النتائج فقط. حالة الموافقة على سياسة الإعلان.
entityStatus

enum (EntityStatus)

الحقل مطلوب. تمثّل هذه السمة حالة الإعلان.
adUrls[]

object (AdUrl)

النتائج فقط. قائمة بعناوين URL المستخدَمة في الإعلان
dcmTrackingInfo

object (DcmTrackingInfo)

اختيارية: معلومات إعلان التتبُّع في "مدير الحملة على DoubleClick"، وهي صالحة فقط لـ "إعلانات زيادة الطلب"

لإزالة معلومات الإعلان المتتبّع في "إدارة الحملة على DoubleClick"، يُرجى ترك هذا الحقل فارغًا.
تفاصيل الإعلان في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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)

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

object (DemandGenVideoAd)

تفاصيل إعلان فيديو لزيادة الطلب
demandGenImageAd

object (DemandGenImageAd)

تفاصيل إعلان مصوّر لزيادة الطلب
demandGenProductAd

object (DemandGenProductAd)

تفاصيل إعلان حملة زيادة الطلب
نهاية الحقول التي يستبعد كلّ منها الآخر

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),
  "videoAssetId": string
}
الحقول
id

string

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

enum (VideoUnavailableReason)

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

string (int64 format)

الحقل مطلوب. معرّف مادة عرض الفيديو على YouTube هذا هو adAssetId لمورد AdAsset.

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,
  "assetId": string
}
الحقول
mimeType

string

النتائج فقط. نوع MIME الخاص بمادة عرض الصورة.
fullSize

object (Dimensions)

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

string (int64 format)

النتائج فقط. حجم ملف مادة عرض الصورة بالبايت.
assetId

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

BumperAd

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

تمثيل 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

تفاصيل عن إعلان Video Discovery

تمثيل 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)

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

DemandGenVideoAd

تفاصيل عن إعلان فيديو لزيادة الطلب

تمثيل JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
الحقول
finalUrl

string

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

string

النتائج فقط. عنوان URL الذي يتم تحميله في الخلفية لأغراض التتبُّع
userSpecifiedTrackingUrl

string

اختيارية: عنوان URL للتتبُّع يحدّده المستخدم يدويًا.
callToAction

enum (CallToAction)

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

القيم المسموح بها هي:

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

الحقل مطلوب. قائمة العناوين المعروضة في الإعلان
longHeadlines[]

string

الحقل مطلوب. قائمة العناوين الطويلة المعروضة على الإعلان
descriptions[]

string

الحقل مطلوب. قائمة الأوصاف المعروضة في الإعلان
displayUrlBreadcrumb1

string

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

string

اختيارية: الجزء الثاني بعد النطاق في عنوان URL المعروض
videos[]

object (YoutubeVideoDetails)

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

map (key: string, value: string)

اختيارية: المَعلمات المخصّصة والقيم المصاحبة التي ستتم إضافتها إلى عنوان URL للتتبّع

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

object (ImageAsset)

اختيارية: إعلان البانر المصاحب المستخدَم في هذا الإعلان
finalMobileUrl

string

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

string

اختيارية: اللاحقة التي سيتم إلحاقها بعناوين URL الخاصة بالصفحات المقصودة
businessName

string

اختيارية: اسم المؤسسة المعروض في الإعلان

هذا الإعداد مطلوب ما لم يتم ضبط قيمة تلقائية على مستوى المعلِن. في حال عدم ضبطها، سيتم تطبيق القيمة التلقائية.

CallToAction

القيم المحتملة لعبارات الحث على اتّخاذ إجراء في "إعلانات المنتجات" و"إعلانات الفيديو" لحملة زيادة الطلب

عمليات التعداد
CALL_TO_ACTION_UNSPECIFIED غير محدّد أو غير معروف
AUTOMATED آلية
LEARN_MORE مزيد من المعلومات
GET_QUOTE الحصول على عرض أسعار
APPLY_NOW قدِّم طلبًا الآن.
SIGN_UP الاشتراك.
CONTACT_US يُرجى التواصل معنا.
SUBSCRIBE اشتراك.
DOWNLOAD تنزيل.
BOOK_NOW احجز الآن.
SHOP_NOW يمكنك بدء التسوّق الآن.
BUY_NOW اشترِ الآن.
DONATE_NOW التبرّع الآن
ORDER_NOW اطلب الآن.
PLAY_NOW العب الآن.
SEE_MORE المزيد
START_NOW ابدأ الآن.
VISIT_SITE زيارة الموقع الإلكتروني
WATCH_NOW مشاهدة الآن.

DemandGenImageAd

تفاصيل عن إعلان مصوّر لزيادة الطلب

تمثيل JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
الحقول
finalUrl

string

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

string

النتائج فقط. عنوان URL الذي يتم تحميله في الخلفية لأغراض التتبُّع
userSpecifiedTrackingUrl

string

اختيارية: عنوان URL للتتبُّع يحدّده المستخدم يدويًا.
callToAction

string

الحقل مطلوب. زر عبارة الحث على اتّخاذ إجراء المعروض في الإعلان
headlines[]

string

الحقل مطلوب. قائمة العناوين المعروضة في الإعلان
descriptions[]

string

الحقل مطلوب. قائمة الأوصاف المعروضة في الإعلان
customParameters

map (key: string, value: string)

اختيارية: المَعلمات المخصّصة والقيم المصاحبة التي ستتم إضافتها إلى عنوان URL للتتبّع

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

string

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

string

اختيارية: اللاحقة التي سيتم إلحاقها بعناوين URL الخاصة بالصفحات المقصودة
businessName

string

اختيارية: اسم المؤسسة المعروض في الإعلان

هذا الإعداد مطلوب ما لم يتم ضبط قيمة تلقائية على مستوى المعلِن. في حال عدم ضبطها، سيتم تطبيق القيمة التلقائية.
marketingImages[]

object (ImageAsset)

قائمة الصور التسويقية المعروضة في الإعلان
squareMarketingImages[]

object (ImageAsset)

قائمة الصور التسويقية المربّعة المعروضة في الإعلان
portraitMarketingImages[]

object (ImageAsset)

قائمة بالصور التسويقية العمودية المعروضة على الإعلان
logoImages[]

object (ImageAsset)

قائمة صور الشعارات المعروضة على الإعلان.

هذا الإعداد مطلوب ما لم يتم ضبط قيمة تلقائية على مستوى المعلِن. في حال عدم ضبطها، سيتم تطبيق القيمة التلقائية.

DemandGenCarouselAd

تفاصيل عن إعلان متبدّل لزيادة الطلب

تمثيل JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
الحقول
finalUrl

string

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

string

الحقل مطلوب. عنوان الإعلان.
description

string

الحقل مطلوب. تمثّل هذه السمة وصف الإعلان.
cards[]

object (CarouselCard)

الحقل مطلوب. قائمة البطاقات المعروضة في الإعلان
finalUrlSuffix

string

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

string

النتائج فقط. عنوان URL الذي يتم تحميله في الخلفية لأغراض التتبُّع
userSpecifiedTrackingUrl

string

اختيارية: عنوان URL للتتبُّع يحدّده المستخدم يدويًا.
businessName

string

اختيارية: اسم المؤسسة المعروض في الإعلان

هذا الإعداد مطلوب ما لم يتم ضبط قيمة تلقائية على مستوى المعلِن. في حال عدم ضبطها، سيتم تطبيق القيمة التلقائية.
customParameters

map (key: string, value: string)

اختيارية: المَعلمات المخصّصة والقيم المصاحبة التي ستتم إضافتها إلى عنوان URL للتتبّع

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

CarouselCard

تفاصيل عن بطاقة لوحة العرض الدوّارة لـ "الحملة لزيادة الطلب"

تمثيل JSON 
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
الحقول
finalUrl

string

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

string

اختيارية: عنوان URL لصفحة الويب التي يصل إليها المستخدمون بعد النقر على البطاقة على جهاز جوّال.
headline

string

الحقل مطلوب. تمثّل هذه السمة عنوان البطاقة.
callToAction

string

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

يجب استخدام 10 أحرف أو أقل.
marketingImage

object (ImageAsset)

اختيارية: الصورة التسويقية المعروضة على البطاقة
squareMarketingImage

object (ImageAsset)

اختيارية: الصورة التسويقية المربّعة المعروضة على البطاقة
portraitMarketingImage

object (ImageAsset)

اختيارية: الصورة التسويقية الرأسية المعروضة على البطاقة

DemandGenProductAd

تفاصيل عن إعلان حملة زيادة الطلب

تمثيل JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
الحقول
finalUrl

string

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

string

الحقل مطلوب. عنوان الإعلان.
description

string

الحقل مطلوب. تمثّل هذه السمة وصف الإعلان.
finalUrlSuffix

string

اختيارية: اللاحقة التي سيتم إلحاقها بعناوين URL الخاصة بالصفحات المقصودة
callToAction

enum (CallToAction)

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

القيم المسموح بها هي:

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

النتائج فقط. عنوان URL الذي يتم تحميله في الخلفية لأغراض التتبُّع
userSpecifiedTrackingUrl

string

اختيارية: عنوان URL للتتبُّع يحدّده المستخدم يدويًا.
businessName

string

اختيارية: اسم المؤسسة المعروض في الإعلان

هذا الإعداد مطلوب ما لم يتم ضبط قيمة تلقائية على مستوى المعلِن. في حال عدم ضبطها، سيتم تطبيق القيمة التلقائية.
customParameters

map (key: string, value: string)

اختيارية: المَعلمات المخصّصة والقيم المصاحبة التي ستتم إضافتها إلى عنوان URL للتتبّع

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

string

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

string

اختيارية: الجزء الثاني بعد النطاق في عنوان URL المعروض

AdPolicy

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

تمثيل JSON 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
الحقول
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

حالة الموافقة على السياسة للإعلان، ما يشير إلى قرار الموافقة
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

حالة مراجعة سياسة الإعلان، والتي تشير إلى المرحلة التي وصل إليها الإعلان في عملية المراجعة.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

الإدخالات الخاصة بكل موضوع من مواضيع السياسات التي تم تحديدها على أنّها مرتبطة بالإعلان يتضمّن كل إدخال الموضوع ومستوى القيود وإرشادات حول كيفية حلّ المشاكل المتعلقة بالسياسات.

AdPolicyApprovalStatus

الحالات المحتملة للموافقة على سياسة الإعلانات

عمليات التعداد
AD_POLICY_APPROVAL_STATUS_UNKNOWN غير معروف أو غير محدّد
DISAPPROVED لن يتم عرض إعلانات من هذه الحملة.
APPROVED_LIMITED سيتم عرضها مع فرض قيود.
APPROVED سيتم عرضها بدون قيود.
AREA_OF_INTEREST_ONLY لن يتم عرض الإعلان في البلدان المستهدَفة، ولكن قد يتم عرضه للمستخدمين الذين يبحثون عن معلومات حول هذه البلدان.

AdPolicyReviewStatus

الحالات المحتملة لمراجعة سياسات الإعلانات

عمليات التعداد
AD_POLICY_REVIEW_STATUS_UNKNOWN غير معروف أو غير محدّد
REVIEW_IN_PROGRESS قيد المراجعة حاليًا
REVIEWED اكتملت المراجعة الأساسية. قد تكون المراجعات الأخرى لا تزال قيد التقدّم.
UNDER_APPEAL تمت إعادة إرسالها للموافقة عليها أو تم تقديم طلب لإعادة النظر في قرار بموجب السياسة.
ELIGIBLE_MAY_SERVE يُعتبر مؤهَّلاً وقد يكون معروضًا. قد يتم إجراء مراجعة إضافية لاحقًا.

AdPolicyTopicEntry

إدخال يوضّح كيف تم تحديد أنّ الإعلان مرتبط بإحدى سياسات الإعلانات

تمثيل JSON 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
الحقول
policyTopic

string

موضوع السياسة

وتشمل الأمثلة "العلامات التجارية" و"الكحول" وما إلى ذلك.
policyLabel

string

نص التصنيف المترجَم للسياسة

وتشمل الأمثلة "علامات تجارية في النص" و"يحتوي على كحول" وما إلى ذلك.
policyTopicDescription

string

تمثّل هذه السمة ملخّصًا موجزًا لوصف موضوع السياسة.
policyTopicType

enum (AdPolicyTopicEntryType)

كيف سيتأثر عرض الإعلانات بسبب العلاقة بموضوع سياسة الإعلانات
policyDecisionType

enum (AdPolicyDecisionType)

مصدر القرار بموجب السياسة
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

وسائل تنفيذ السياسة المستخدَمة في مراجعة السياسة
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

الأدلة المستخدَمة في القرار بموجب السياسة.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

قيود العرض ذات الصلة بالقرار بموجب السياسة
appealInfo

object (AdPolicyTopicAppealInfo)

معلومات عن كيفية تقديم طلب بإعادة النظر في قرار بموجب السياسة

AdPolicyTopicEntryType

التأثيرات المحتملة لعرض الإعلانات في موضوع إحدى سياسات الإعلانات

عمليات التعداد
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN غير معروف أو غير محدّد
PROHIBITED لن يتم عرض المرجع.
FULLY_LIMITED لن يتم عرض المرجع في جميع البلدان المستهدَفة.
LIMITED لا يمكن عرض المرجع في بعض البلدان.
DESCRIPTIVE يمكن عرض المرجع.
BROADENING يمكن أن يقدّم المورد خدماته، وقد يقدّمها خارج نطاق التغطية العادي.
AREA_OF_INTEREST_ONLY المصدر محظور في جميع البلدان المستهدَفة، ولكن قد يظهر للمستخدمين الذين يبحثون عن معلومات حول البلدان المستهدَفة.

AdPolicyDecisionType

مصادر محتملة لقرار بموجب السياسة

عمليات التعداد
AD_POLICY_DECISION_TYPE_UNKNOWN غير معروف أو غير محدّد
PURSUANT_TO_NOTICE تم اتّخاذ القرار بناءً على إشعار قانوني أو أمر محكمة أو شكوى من مالك محتوى علامة تجارية مسجّلة، وما إلى ذلك.
GOOGLE_INVESTIGATION القرار صادر عن تحقيق أجرته Google.

AdPolicyEnforcementMeans

وسائل تنفيذ السياسة المحتملة المستخدَمة في مراجعة السياسة

عمليات التعداد
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN غير معروف أو غير محدّد
AUTOMATED كانت عملية التنفيذ مبرمَجة بالكامل.
HUMAN_REVIEW كان هناك شخص مشارك جزئيًا أو كليًا في عملية تنفيذ القرار.

AdPolicyTopicEvidence

معلومات المستندات الثبوتية المستخدَمة في قرار بموجب السياسة

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of mutually exclusive fields.
}
الحقول
دليل القرار بموجب السياسة في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
textList

object (TextList)

قائمة بالمستندات الثبوتية التي تم العثور عليها في نص الإعلان
websiteList

object (WebsiteList)

قائمة بالمواقع الإلكترونية المرتبطة بالإعلان
httpCode

integer

رمز HTTP الذي تم إرجاعه عند الزحف إلى عنوان URL النهائي
languageCode

string

اللغة التي تم رصد الإعلان على أنّه مكتوب بها.

يستخدم هذا الحقل علامات اللغة التابعة لفريق هندسة الإنترنت (IETF)، مثل "en-US".
destinationTextList

object (DestinationTextList)

النص في وجهة الإعلان الذي يتسبّب في انتهاك السياسة
destinationMismatch

object (DestinationMismatch)

عدم تطابق بين عناوين URL لوجهة الإعلان
destinationNotWorking

object (DestinationNotWorking)

معلومات عن أخطاء HTTP أو DNS المتعلّقة بوجهة الإعلان
trademark

object (Trademark)

عبارات العلامات التجارية المسجّلة التي أدّت إلى مخالفة السياسة
legalRemoval

object (LegalRemoval)

فرض اللوائح التنظيمية ذات الصلة بالقانون الذي أدّى إلى انتهاك السياسة
counterfeit

object (Counterfeit)

إجراء التنفيذ المتعلق بالتزوير الذي أدّى إلى انتهاك السياسة
regionalRequirements

object (RegionalRequirements)

إجراءات التنفيذ الاستباقية التي اتّخذها فريق "الثقة والأمان" وأدّت إلى انتهاك السياسة
نهاية الحقول التي يستبعد كلّ منها الآخر

TextList

قائمة بمقتطفات من النص الذي يخالف السياسة

تمثيل JSON 
{
  "texts": [
    string
  ]
}
الحقول
texts[]

string

أجزاء النص من المرجع الذي تسبّب في مخالفة السياسة.

WebsiteList

قائمة بالمواقع الإلكترونية التي انتهكت السياسة

تمثيل JSON 
{
  "websites": [
    string
  ]
}
الحقول
websites[]

string

المواقع الإلكترونية التي أدّت إلى رصد انتهاك للسياسة

DestinationTextList

قائمة بنصوص الوجهات التي انتهكت السياسة

تمثيل JSON 
{
  "destinationTexts": [
    string
  ]
}
الحقول
destinationTexts[]

string

نص الوجهة الذي أدّى إلى مخالفة السياسة

DestinationMismatch

تفاصيل حول عدم تطابق بين أنواع عناوين URL المقصودة

تمثيل JSON 
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
الحقول
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

مجموعة عناوين URL غير المتطابقة يمكن أن تتضمّن القائمة نوعًا واحدًا أو عدّة أنواع من معرّفات الموارد المنتظمة.

المثال 1: [DISPLAY_URL, FINAL_URL] يعني أنّ عنوان URL المعروض للإعلان لا يتطابق مع عنوان URL النهائي للإعلان.

المثال 2: [FINAL_URL] يعني أنّ عنوان URL النهائي للإعلان لم يتطابق مع عنوان URL الذي تم الزحف إليه، ويُعدّ ذلك أيضًا عدم تطابق الوجهة.

AdPolicyTopicEvidenceDestinationMismatchUrlType

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

عمليات التعداد
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN غير محدّد أو غير معروف
DISPLAY_URL عنوان URL المعروض
FINAL_URL عنوان URL النهائي.
FINAL_MOBILE_URL عنوان URL النهائي للأجهزة الجوّالة.
TRACKING_URL عنوان URL للتتبُّع
MOBILE_TRACKING_URL عنوان URL للتتبُّع على الأجهزة الجوّالة

DestinationNotWorking

تفاصيل حول أخطاء HTTP أو نظام أسماء النطاقات (DNS) المرتبطة بوجهة الإعلان

تمثيل JSON 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of mutually exclusive fields.
}
الحقول
expandedUri

string

عنوان URL الكامل الذي لم يعمل
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

الجهاز الذي أدّت زيارة عنوان URL عليه إلى حدوث الخطأ
lastCheckedTime

string (Timestamp format)

آخر مرة ظهر فيها الخطأ عند الانتقال إلى عنوان URL

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
خطأ HTTP أو خطأ في نظام أسماء النطاقات في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

نوع الخطأ في نظام أسماء النطاقات
httpErrorCode

string (int64 format)

رمز خطأ HTTP
نهاية الحقول التي يستبعد كلّ منها الآخر

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

أنواع الأخطاء المحتملة في نظام أسماء النطاقات

عمليات التعداد
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN غير محدّد أو غير معروف
HOSTNAME_NOT_FOUND لم يتم العثور على اسم المضيف في نظام أسماء النطاقات (DNS) عند جلب الصفحة المقصودة.
GOOGLE_CRAWLER_DNS_ISSUE تعذّر على Google الزحف إلى الصفحة المقصودة عند التواصل مع نظام أسماء النطاقات (DNS).

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

الأجهزة المحتمَلة التي ظهرت فيها رسالة خطأ عند الانتقال إلى عنوان URL

عمليات التعداد
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN غير محدّد أو غير معروف
DESKTOP جهاز كمبيوتر مكتبي
ANDROID جهاز Android
IOS جهاز iOS

العلامة التجارية

عبارات العلامات التجارية المسجّلة التي أدّت إلى مخالفة السياسة

تمثيل JSON 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
الحقول
owner

string

مالك المحتوى الذي يتضمّن العلامة التجارية
term

string

تمثّل هذه السمة العلامة التجارية المسجّلة.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

البلدان التي يكون فيها انتهاك السياسة ذا صلة

AdPolicyCriterionRestriction

تمثّل هذه السمة قيودًا على البلد.

تمثيل JSON 
{
  "countryCriterionId": string,
  "countryLabel": string
}
الحقول
countryCriterionId

string (int64 format)

رقم تعريف معيار البلد
countryLabel

string

الاسم المترجَم للبلد قد يكون فارغًا.

LegalRemoval

فرض اللوائح التنظيمية ذات الصلة بالقانون، سواء بموجب قانون الألفية الجديدة لحقوق طبع ونشر المواد الرقمية أو اللوائح التنظيمية القانونية المحلية

تمثيل JSON 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of mutually exclusive fields.
}
الحقول
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

نوع الشكوى التي أدّت إلى الإزالة لأسباب قانونية
countryRestrictions[]

object (AdPolicyCriterionRestriction)

البلدان التي تم حظرها بسبب الإزالة لأسباب قانونية.
restrictedUris[]

string

عناوين URL المحظورة بسبب الإزالة لأسباب قانونية
تفاصيل حول نوع الإزالة لأسباب قانونية في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
dmca

object (Dmca)

تفاصيل حول الإزالة لأسباب قانونية بموجب قانون الألفية الجديدة لحقوق طبع ونشر المواد الرقمية
نهاية الحقول التي يستبعد كلّ منها الآخر

قانون الألفية الجديدة لحقوق طبع ونشر المواد الرقمية

تفاصيل شكوى بموجب قانون الألفية الجديدة لحقوق طبع ونشر المواد الرقمية

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

string

الجهة التي قدّمت الشكوى القانونية

LocalLegal

تفاصيل التنظيم القانوني المحلي

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

string

نوع القانون الذي ينطبق على الإشعار القانوني

AdPolicyTopicEvidenceLegalRemovalComplaintType

أنواع الشكاوى المحتمَلة لطلب الإزالة لأسباب قانونية

عمليات التعداد
COPYRIGHT

حقوق الطبع والنشر.

ينطبق ذلك على قانون الألفية الجديدة لحقوق طبع ونشر المواد الرقمية فقط.
COURT_ORDER

أمر محكمة

ينطبق ذلك على القوانين المحلية فقط.

التزوير

تفاصيل حول إجراءات التنفيذ المتعلّقة بالتزوير والتي أدّت إلى انتهاك السياسة

تمثيل JSON 
{
  "owners": [
    string
  ]
}
الحقول
owners[]

string

مالكو المحتوى أو المنتجات الذين قدّموا شكوى

RegionalRequirements

فرض سياسات استباقي من فريق الثقة والأمان (T&S) بهدف تلبية المتطلبات الإقليمية يُعدّ هذا الإجراء تحقيقًا تملكه Google بدلاً من إشعار تنظيمي لأنّه إجراء استباقي لفرض بنود الخدمة.

تمثيل JSON 
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
الحقول
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

قائمة بالمتطلبات الإقليمية

RegionalRequirementsEntry

تفاصيل انتهاك القانون الإقليمي على مستوى السياسة

تمثيل JSON 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
الحقول
legalPolicy

string

السياسة القانونية التي يتم انتهاكها
countryRestrictions[]

object (AdPolicyCriterionRestriction)

البلدان التي تم حظرها بسبب السياسة القانونية

AdPolicyTopicConstraint

تفاصيل عن قيود عرض الإعلانات

تمثيل JSON 
{
  "requestCertificateFormLink": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of mutually exclusive fields.
}
الحقول
شرط العرض في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
countryConstraint

object (AdPolicyCountryConstraintList)

البلدان التي لا يمكن عرض الإعلان فيها
resellerConstraint

object (AdPolicyResellerConstraint)

قيود المورّد
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

البلدان التي يجب فيها تقديم شهادة اعتماد لتقديم الخدمة
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

البلدان التي لا يغطي فيها النطاق الخاص بالمرجع الشهادات المرتبطة به
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

يجب تقديم شهادة لعرض الإعلانات في أي بلد.
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

يجب الحصول على شهادة اعتماد لعرض الإعلانات في أي بلد، ولا تغطّي شهادة الاعتماد الحالية نطاق الإعلان.
نهاية الحقول التي يستبعد كلّ منها الآخر

AdPolicyCountryConstraintList

قائمة بالبلدان التي لا يمكن عرض الإعلان فيها بسبب قيود السياسة

تمثيل JSON 
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
الحقول
countries[]

object (AdPolicyCriterionRestriction)

البلدان التي لا يمكن عرض الإعلان فيها

AdPolicyResellerConstraint

لا يحتوي هذا النوع على أي حقول.

تم تقييد موضوع السياسة بسبب رفض الموقع الإلكتروني لأغراض إعادة البيع.

AdPolicyGlobalCertificateMissingConstraint

لا يحتوي هذا النوع على أي حقول.

يجب تقديم شهادة لعرض الإعلانات في أي بلد.

AdPolicyGlobalCertificateDomainMismatchConstraint

لا يحتوي هذا النوع على أي حقول.

يجب الحصول على شهادة اعتماد لعرض الإعلانات في أي بلد، ولا تغطّي شهادة الاعتماد الحالية نطاق الإعلان.

AdPolicyTopicAppealInfo

معلومات حول كيفية تقديم طلب بإعادة النظر في قرار بموجب السياسة

تمثيل JSON 
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
الحقول
appealType

enum (AdPolicyAppealType)

تُظهر هذه السمة ما إذا كان يمكن طلب إعادة النظر في القرار من خلال طلب إعادة نظر ذاتي الخدمة أو نموذج طلب إعادة النظر.

AdPolicyAppealType

أنواع طلبات إعادة النظر المحتملة

عمليات التعداد
AD_POLICY_APPEAL_TYPE_UNKNOWN غير معروف أو غير محدّد
SELF_SERVICE_APPEAL يمكن طلب إعادة النظر في القرار من خلال طلب إعادة النظر الذاتي الخدمة.
APPEAL_FORM يمكن طلب إعادة النظر في القرار باستخدام نموذج طلب إعادة النظر.

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 بكسل تتبُّع بحجم 1x1 لإرسال إشارة ping عند عرض مرّة ظهور لتصميم إعلان
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION إشارة ظهور قابلة للتوسعة في "إدارة حملة DoubleClick" وعند العرض، يتم توسيعه ليشمل عدّة إشارات.
AD_URL_TYPE_BEACON_CLICK عنوان URL للتتبُّع يتم إرسال إشارة إليه عند بدء حدث ناتج عن النقر.
AD_URL_TYPE_BEACON_SKIP عنوان URL للتتبُّع يتم إرسال إشارة إليه عند بدء حدث التخطّي.

DcmTrackingInfo

تفاصيل حول التتبُّع في "حملة DoubleClick"

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

string (int64 format)

الحقل مطلوب. تمثّل هذه السمة رقم تعريف موضع الإعلان في "مدير الحملة".
trackingAdId

string (int64 format)

الحقل مطلوب. رقم تعريف إعلان التتبُّع في "مدير الحملة"
creativeId

string (int64 format)

الحقل مطلوب. رقم تعريف تصميم الإعلان في "مدير الحملة"

الطُرق

create

 تُنشئ هذه الطريقة إعلانًا على مستوى المجموعة الإعلانية.

delete

 تحذف هذه الطريقة إعلانًا في مجموعة إعلانية.

get

 تعرض هذه السمة إعلانًا ضمن مجموعة إعلانية.

list

 تعرض هذه السمة إعلانات المجموعة الإعلانية.

patch

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