AssetGroup

مجموعة مواد عرض. يتمّ استخدام AssetGroupAsset لربط مادة عرض بمجموعة مواد العرض. يتمّ استخدام AssetGroupSignal لربط إشارة بمجموعة مواد عرض.

تمثيل JSON 
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "primaryStatus": enum (AssetGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AssetGroupPrimaryStatusReason)
  ],
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
الحقول
resourceName

string

غير قابل للتغيير. اسم المورد لمجموعة مواد العرض. تكون أسماء موارد مجموعة مواد العرض على النحو التالي:

customers/{customerId}/assetGroups/{asset_group_id}
id

string (int64 format)

النتائج فقط. رقم تعريف مجموعة مواد العرض.
campaign

string

غير قابل للتغيير. الحملة التي ترتبط بها مجموعة مواد العرض هذه. مادة العرض المرتبطة بمجموعة مواد العرض.
name

string

مطلوبة. اسم مجموعة مواد العرض مطلوبة. يجب أن يبلغ طولها 1 كحد أدنى و128 طولاً كحد أقصى. ويجب أن يكون فريدًا ضمن أي حملة.
finalUrls[]

string

قائمة بعناوين URL النهائية بعد جميع عمليات إعادة التوجيه عبر النطاقات. في حملات "الأداء الأفضل"، تكون عناوين URL تلقائيًا مؤهَّلة للتوسيع ما لم يتم إيقافها.
finalMobileUrls[]

string

قائمة بعناوين URL النهائية للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه عبر النطاقات. في حملات "الأداء الأفضل"، تكون عناوين URL تلقائيًا مؤهَّلة للتوسيع ما لم يتم إيقافها.
status

enum (AssetGroupStatus)

حالة مجموعة مواد العرض.
primaryStatus

enum (AssetGroupPrimaryStatus)

النتائج فقط. الحالة الأساسية لمجموعة مواد العرض. تقدِّم إحصاءات عن سبب عدم ظهور إعلانات مجموعة مواد عرض أو عدم عرضها على النحو الأمثل.
primaryStatusReasons[]

enum (AssetGroupPrimaryStatusReason)

النتائج فقط. توضيح أسباب عدم ظهور مجموعة مواد عرض أو عدم عرضها على النحو الأمثل وستكون هذه المجموعة فارغة عند عرض مجموعة مواد العرض بدون مشاكل.
path1

string

الجزء الأول من النص الذي قد يظهر مُلحقًا بعنوان URL المعروض في الإعلان
path2

string

الجزء الثاني من النص الذي قد يظهر مُلحقًا بعنوان URL المعروض في الإعلان لا يمكن ضبط هذا الحقل إلا عند ضبط المسار 1.
adStrength

enum (AdStrength)

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

AssetGroupStatus

الحالات المحتملة لمجموعة مواد عرض.

عمليات التعداد
UNSPECIFIED لم يتمّ تحديد الحالة.
UNKNOWN القيمة المُستلَمة غير معروفة في هذا الإصدار.
ENABLED تم تفعيل مجموعة مواد العرض.
PAUSED تم إيقاف مجموعة مواد العرض مؤقتًا.
REMOVED تتم إزالة مجموعة مواد العرض.

AssetGroupPrimaryStatus

رقم يصف الحالة الأساسية لمجموعة مواد العرض المحتملة. تقدِّم إحصاءات عن سبب عدم ظهور إعلانات مجموعة مواد عرض أو عدم عرضها على النحو الأمثل.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ELIGIBLE تكون مجموعة مواد العرض مؤهَّلة للعرض.
PAUSED تم إيقاف مجموعة مواد العرض مؤقتًا.
REMOVED تتم إزالة مجموعة مواد العرض.
NOT_ELIGIBLE مجموعة مواد العرض غير مؤهَّلة لعرض الإعلانات.
LIMITED إمكانية عرض مجموعة مواد العرض محدودة.
PENDING مجموعة مواد العرض في انتظار الموافقة وقد يتم عرضها في المستقبل.

AssetGroupPrimaryStatusReason

يشير عمود التعداد إلى أسباب الحالة الأساسية المحتملة لمجموعة مواد العرض. توضيح أسباب عدم ظهور مجموعة مواد عرض أو عدم عرضها على النحو الأمثل وستكون هذه المجموعة فارغة عند عرض مجموعة مواد العرض بدون مشاكل.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ASSET_GROUP_PAUSED حالة مجموعة مواد العرض التي حدّدها المستخدِم متوقفة مؤقتًا.
ASSET_GROUP_REMOVED تتم إزالة حالة مجموعة مواد العرض التي يحدِّدها المستخدِم.
CAMPAIGN_REMOVED تتمّ إزالة حالة الحملة التي حدّدها المستخدِم.
CAMPAIGN_PAUSED حالة الحملة التي يحدِّدها المستخدِم متوقفة مؤقتًا.
CAMPAIGN_PENDING يقع الوقت الذي يحدِّده المستخدم لبدء هذه الحملة في المستقبل.
CAMPAIGN_ENDED لقد انقضى الوقت الذي حدّده المستخدم لانتهاء هذه الحملة.
ASSET_GROUP_LIMITED تمّت الموافقة على مجموعة مواد العرض، ولكنّها لا تظهر إلّا بسعة محدودة بسبب السياسات.
ASSET_GROUP_DISAPPROVED تم وضع علامة على مجموعة مواد العرض بأنّها مرفوضة.
ASSET_GROUP_UNDER_REVIEW لم تكمل مجموعة مواد العرض عملية التحقّق من الالتزام بالسياسات.