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)
  },

  // 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)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // 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 بايت كحدّ أقصى.
adPolicy

object (AdPolicy)

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

enum (EntityStatus)

الحقل مطلوب. حالة عنصر الإعلان.
adUrls[]

object (AdUrl)

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

object (DcmTrackingInfo)

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

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

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

object (DemandGenVideoAd)

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

object (DemandGenImageAd)

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

object (DemandGenProductAd)

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

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 
{

  // Union field value can be only one of the following:
  "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 list of possible types for union field value.
}
الحقول
حقل الربط value دليل على القرار بموجب السياسة يمكن أن يكون التعليق value إحدى القيم التالية فقط:
textList

object (TextList)

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

object (WebsiteList)

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

integer

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

string

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

يستخدم هذا الحقل رموز اللغة وفق معيار IETF، مثل "ar-SA".
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,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
الحقول
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".
حقل الربط reason خطأ HTTP أو خطأ في نظام أسماء النطاقات يمكن أن يكون التعليق reason إحدى القيم التالية فقط:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

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

string (int64 format)

رمز خطأ HTTP

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

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

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

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
  ],

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
الحقول
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

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

object (AdPolicyCriterionRestriction)

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

string

عناوين URL التي تم حظرها بسبب الإزالة القانونية
حقل الربط type تفاصيل حول نوع الإزالة القانونية يمكن أن يكون التعليق type إحدى القيم التالية فقط:
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,

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
الحقول
حقل الربط constraint شرط العرض يمكن أن يكون التعليق constraint إحدى القيم التالية فقط:
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 يمكن تقديم طلب إعادة نظر في القرار باستخدام نموذج طلب إعادة النظر.

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

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

تمثيل 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 المعروض

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)

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

string (int64 format)

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

string (int64 format)

الحقل مطلوب. رقم تعريف تصميم الإعلان في "DoubleClick Campaign Manager"

الطُرق

create

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

delete

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

get

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

list

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

patch

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