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)
  },
  "containsSyntheticMedia": boolean,
  "parentCreativeId": string,

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

اختيارية: معلومات إعلان التتبُّع في DCM

لإزالة معلومات إعلان التتبُّع في DCM، يُرجى ترك هذا الحقل فارغًا.
containsSyntheticMedia

boolean

اختيارية: يشير ذلك إلى ما إذا كان الإعلان يحتوي على وسائط معدَّلة أو اصطناعية.

يجب ضبط هذه السمة فقط للإعلانات التي ينشئها معلِنون تم التحقّق من أهليتهم لعرض إعلانات انتخابية. هذا العرض صالح فقط للإعلانات على YouTube.
parentCreativeId

string (int64 format)

للعرض فقط. رقم تعريف تصميم الإعلان في "مساحة العرض والفيديو 360" المستخدَم لإنشاء هذا الإعلان

لن تتم تعبئة هذا الحقل إلا للإعلانات التي يتم إنشاؤها من تصاميم الإعلانات المخصّصة للمجموعة الإعلانية الرئيسية.
تفاصيل الإعلان في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
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,
  "userSpecifiedTrackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
الحقول
displayUrl

string

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

string

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

string

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

في الإصدار 4 والإصدارات الأقدم، يمثّل هذا الحقل عنوان URL للتتبُّع الذي حدّده المستخدم يدويًا. يمكن العثور على هذا في userSpecifiedTrackingUrl في الإصدار 5.
userSpecifiedTrackingUrl

string

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

string

اختيارية: النص الذي يظهر على زر الحث على اتخاذ إجراء

يجب ضبط هذه السمة في حال ضبط actionHeadline.
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,
  "userSpecifiedTrackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
الحقول
displayUrl

string

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

string

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

string

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

في الإصدار 4 والإصدارات الأقدم، يمثّل هذا الحقل عنوان URL للتتبُّع الذي حدّده المستخدم يدويًا. يمكن العثور على هذا في userSpecifiedTrackingUrl في الإصدار 5.
userSpecifiedTrackingUrl

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,
  "userSpecifiedTrackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ],
  "businessName": string,
  "logo": {
    object (ImageAsset)
  }
}
الحقول
finalUrl

string

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

string

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

في الإصدار 4 والإصدارات الأقدم، يمثّل هذا الحقل عنوان URL للتتبُّع الذي حدّده المستخدم يدويًا. يمكن العثور على هذا في userSpecifiedTrackingUrl في الإصدار 5.
userSpecifiedTrackingUrl

string

اختيارية: عنوان URL للتتبُّع الذي حدّده المستخدم يدويًا
actionButtonLabels[]

string

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

يجب ضبط هذه السمة في حال ضبط السمة headlines.
headlines[]

string

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

string

اختيارية: قائمة العناوين الطويلة التي تظهر على بانر عبارة الحث على اتخاذ إجراء

يجب ضبط هذا الحقل ما لم تكن قيمة lineItemType في البند الرئيسي هي LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE، وفي هذه الحالة لا يمكن ضبط هذا الحقل.
descriptions[]

string

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

يجب ضبط هذا الحقل ما لم تكن قيمة lineItemType للبند الرئيسي هي LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE، وفي هذه الحالة لا يمكن ضبط هذا الحقل.
displayUrlBreadcrumb1

string

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

string

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

لا يمكن ضبط هذه السياسة إلا إذا تم ضبط سياسة displayUrlBreadcrumb1 أيضًا.
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)

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

string

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

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

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 تنزيل إلى جانب قائمة تشغيل أو ألبوم في تطبيق YouTube Music.
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

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

وتشمل الأمثلة "TRADEMARKS" و"ALCOHOL" وما إلى ذلك.
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 غير المتطابقة يمكن أن تتضمّن القائمة أنواعًا فردية أو متعددة من معرّفات الموارد المنتظمة (URI).

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

DcmTrackingInfo

تفاصيل حول تتبُّع DCM

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

string (int64 format)

الحقل مطلوب. رقم تعريف موضع الإعلان في DCM
trackingAdId

string (int64 format)

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

string (int64 format)

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

الطُرق

create

 تنشئ إعلانًا في مجموعة إعلانية.

delete

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

get

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

list

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

patch

 تعديل إعلان في مجموعة إعلانية