SearchAds360Row

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}

string

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

customers/{customerId}/adGroups/{ad_group_id}

enum (AdGroupStatus)

حالة المجموعة الإعلانية.

enum (AdGroupType)

نوع المجموعة الإعلانية.

enum (AdGroupAdRotationMode)

وضع عرض الإعلانات بالتناوب بالمجموعة الإعلانية.

string

الطابع الزمني لوقت إنشاء هذه المجموعة الإعلانية. يظهر الطابع الزمني في المنطقة الزمنية للعميل بالتنسيق "yyyy-MM-dd HH:mm:ss" .

object (TargetingSetting)

إعداد لاستهداف الميزات ذات الصلة.

string

أسماء موارد التصنيفات المرفقة بهذه المجموعة الإعلانية.

string

رقم تعريف المجموعة الإعلانية في حساب محرّك البحث الخارجي. هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan وMicrosoft وBidu وما إلى ذلك. وبالنسبة إلى كيان "إعلانات Google"، استخدِم "adGroup.id" بدلاً من ذلك.

string

التاريخ الذي تبدأ فيه هذه المجموعة الإعلانية في عرض الإعلانات. بشكلٍ تلقائي، تبدأ المجموعة الإعلانية الآن أو تاريخ بدء المجموعة الإعلانية، أيهما أبعد. إذا تم ضبط هذا الحقل، تبدأ المجموعة الإعلانية من بداية التاريخ المحدّد في المنطقة الزمنية للعميل. لا يتوفّر هذا الحقل إلا لحسابات بوابة Microsoft Advertising وFacebook.

التنسيق: YYYY-MM-DD مثال: 14-03-2019

string

تاريخ انتهاء المجموعة الإعلانية عن عرض الإعلانات. بشكل تلقائي، تنتهي المجموعة الإعلانية في تاريخ انتهاء المجموعة الإعلانية. وفي حال ضبط هذا الحقل، تنتهي المجموعة الإعلانية في نهاية التاريخ المحدّد في المنطقة الزمنية للعميل. لا يتوفّر هذا الحقل إلا لحسابات بوابة Microsoft Advertising وFacebook.

التنسيق: YYYY-MM-DD مثال: 14-03-2019

string

لغة الإعلانات والكلمات الرئيسية في المجموعة الإعلانية. هذا الحقل متاح فقط لحسابات Microsoft Advertising. مزيد من التفاصيل: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على هذه المجموعة الإعلانية. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

string (int64 format)

رقم تعريف المجموعة الإعلانية.

string

اسم المجموعة

هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء مجموعات إعلانية جديدة.

يجب أن يحتوي النص على أقل من 255 حرفًا بالعرض الكامل لترميز UTF-8.

يجب ألا يحتوي على أي أحرف فارغة (نقطة رمز 0x0) أو خلاصة سطر غير مكتوب (نقطة رمز 0xA) أو أحرف رجوع إلى أول السطر (نقطة الرمز 0xD).

string (int64 format)

عرض السعر الأقصى للنقرة.

enum (AdGroupEngineStatus)

حالة المحرّك للمجموعة الإعلانية.

{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}

object (TargetRestriction)

إعداد السمة لكل استهداف لتقييد مدى وصول حملتك أو مجموعتك الإعلانية.

{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}

enum (TargetingDimension)

سمة الاستهداف التي تنطبق عليها هذه الإعدادات.

boolean

يشير إلى ما إذا كان سيتم تقييد عرض إعلاناتك فقط للمعايير التي اخترتها لبُعد الاستهداف هذا، أو استهداف جميع القيم لسمة الاستهداف هذه وعرض الإعلانات استنادًا إلى استهدافك في أبعاد الاستهداف الأخرى. وتعني القيمة true أنّ هذه المعايير لن تطبّق سوى معدِّلات عروض الأسعار، ولن تؤثر في الاستهداف. وتعني القيمة false أنّ هذه المعايير ستقيّد الاستهداف بالإضافة إلى تطبيق معدِّلات عروض الأسعار.

{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}

string

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

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

enum (AdGroupAdStatus)

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

object (Ad)

الإعلان.

string

الطابع الزمني لوقت إنشاء إعلان المجموعة الإعلانية هذا. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

string

أسماء موارد التصنيفات المرفقة بإعلان المجموعة الإعلانية هذا.

string

رقم تعريف الإعلان في حساب محرّك البحث الخارجي. هذا الحقل مخصّص لحساب "إعلانات شبكة البحث 360" فقط، مثل Yahoo Japan وMicrosoft وBidu وما إلى ذلك. وبالنسبة إلى الكيانات غير التابعة لإعلانات شبكة البحث 360، استخدِم "adGroupAd.ad.id" بدلاً من ذلك.

enum (AdGroupAdEngineStatus)

الحالة الإضافية للإعلان في حساب محرّك البحث الخارجي. تشمل الحالات المحتملة (استنادًا إلى نوع الحساب الخارجي) حالة نشطة، أو مؤهَّلة، أو في انتظار المراجعة، أو غير ذلك.

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على إعلان المجموعة الإعلانية. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "type": enum (AdType),
  "id": string,
  "displayUrl": string,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (SearchAds360TextAdInfo)
  },
  "expandedTextAd": {
    object (SearchAds360ExpandedTextAdInfo)
  },
  "responsiveSearchAd": {
    object (SearchAds360ResponsiveSearchAdInfo)
  },
  "productAd": {
    object (SearchAds360ProductAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (SearchAds360ExpandedDynamicSearchAdInfo)
  }
  // End of list of possible types for union field ad_data.
}

string

اسم مورد الإعلان. وتكون أسماء موارد الإعلانات على النحو التالي:

customers/{customerId}/ads/{adId}

string

قائمة روابط عناوين URL النهائية المحتملة بعد كل عمليات إعادة التوجيه عبر النطاقات للإعلان.

enum (AdType)

نوع الإعلان.

string (int64 format)

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

string

عنوان URL الذي يظهر في وصف الإعلان لبعض أشكال الإعلانات.

string

اسم الإعلان. تُستخدم هذه الطريقة للتعرّف على الإعلان فقط. ولا يُشترط أن تكون فريدة ولا تؤثر في الإعلان المعروض. لا يتوفّر حقل الاسم حاليًا إلا مع DisplayUploadAd وImageAd وShoppingComparisonListingAd وVideoAd.

object (SearchAds360TextAdInfo)

التفاصيل المتعلقة بإعلان نصي.

object (SearchAds360ExpandedTextAdInfo)

التفاصيل المتعلقة بإعلان نصي موسَّع.

object (SearchAds360ResponsiveSearchAdInfo)

التفاصيل المتعلقة بإعلان متجاوب على شبكة البحث.

object (SearchAds360ProductAdInfo)

تفاصيل ذات صلة بإعلان منتج.

object (SearchAds360ExpandedDynamicSearchAdInfo)

التفاصيل المتعلقة بإعلان ديناميكي موسّع على شبكة البحث.

{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}

string

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

string

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

string

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

string

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

string

عنوان URL المعروض للأجهزة الجوّالة للإعلان.

string (int64 format)

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

{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}

string

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

string

العنوان الثاني للإعلان.

string

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

string

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

string

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

string

النص ملحق بعنوان URL المرئي الذي تم إنشاؤه تلقائيًا باستخدام محدِّد.

string

سيتم إلحاق النص بالمسار 1 باستخدام محدِّد.

string (int64 format)

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

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}

object (AdTextAsset)

قائمة مواد العرض النصية للعناوين. عند عرض الإعلانات، سيتم اختيار العناوين من هذه القائمة.

object (AdTextAsset)

قائمة مواد العرض النصية للأوصاف. عند عرض الإعلانات، سيتم اختيار الأوصاف من هذه القائمة.

string

النص ملحق بعنوان URL المرئي الذي تم إنشاؤه تلقائيًا باستخدام محدِّد.

string

سيتم إلحاق النص بالمسار 1 باستخدام محدِّد.

string (int64 format)

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

{
  "text": string
}

string

نص مادة العرض.

{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}

string

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

string

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

string (int64 format)

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

{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}

string

اسم المورد لتصنيف إعلان المجموعة الإعلانية. تكون أسماء موارد تصنيف إعلان المجموعة الإعلانية على النحو التالي: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

string

إعلان المجموعة الإعلانية الذي تم إرفاق التصنيف به.

string

التصنيف المعيَّن لإعلان المجموعة الإعلانية.

{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}

string

اسم المورد لمادة عرض المجموعة الإعلانية وتكون أسماء موارد AdGroupAsset على النحو التالي:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

string

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

string

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

enum (AssetLinkStatus)

حالة مادة عرض المجموعة الإعلانية

{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}

string

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

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

string

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

string

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

enum (AssetSetLinkStatus)

حالة مجموعة مواد العرض في المجموعة الإعلانية. للقراءة فقط.

{
  "resourceName": string
}

string

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

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}

string

اسم المورد لمعدِّل عروض أسعار المجموعة الإعلانية. وتكون أسماء موارد معدِّلات عروض أسعار المجموعة الإعلانية على النحو التالي:

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

number

معدِّل عرض السعر عند تطابق المعيار. يجب أن يكون المُعدَّل في النطاق: 0.1 - 10.0. يتراوح النطاق بين 1.0 و6.0 لـ PreferredContent. استخدِم 0 لإيقاف نوع الجهاز.

object (DeviceInfo)

معيار الجهاز

{
  "type": enum (Device)
}

enum (Device)

نوع الجهاز

{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}

string

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

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

string

الطابع الزمني عند إنشاء معيار المجموعة الإعلانية هذا. يظهر الطابع الزمني في المنطقة الزمنية للعميل بالتنسيق "yyyy-MM-dd HH:mm:ss" .

enum (AdGroupCriterionStatus)

حالة المعيار.

هذه هي حالة كيان معيار المجموعة الإعلانية التي ضبطها العميل. ملاحظة: قد تتضمّن تقارير واجهة المستخدم معلومات إضافية تؤثّر في ما إذا كان المعيار مؤهَّلاً للتشغيل. في بعض الحالات، قد يستمر عرض معيار تمت إزالته في واجهة برمجة التطبيقات على أنّه مفعّل في واجهة المستخدم. على سبيل المثال، تظهر الحملات تلقائيًا للمستخدمين من جميع الفئات العمرية ما لم يتم استبعادها. ستظهَر واجهة المستخدِم على أنّها "مفعَّلة" لكلّ فئة عمرية، لأنّهم مؤهَّلون لرؤية الإعلانات. لكن AdGroupCategory.status ستعرض "تمت الإزالة" بسبب عدم إضافة معيار موجب.

object (QualityInfo)

تمثّل هذه السمة معلومات حول جودة المعيار.

enum (CriterionType)

تمثّل هذه السمة نوع المعيار.

string

أسماء موارد التصنيفات المرفقة بمعيار المجموعة الإعلانية هذا.

object (PositionEstimates)

تقديرات لعروض أسعار المعايير في مواضع مختلفة

string

قائمة روابط عناوين URL النهائية المحتملة بعد كل عمليات إعادة التوجيه عبر النطاقات للإعلان.

string

رقم تعريف معيار المجموعة الإعلانية في حساب محرك البحث الخارجي. هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan وMicrosoft وBidu وما إلى ذلك. وبالنسبة إلى كيان "إعلانات Google"، استخدِم "adGroupcriterion.criterion_id" بدلاً من ذلك.

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على معيار المجموعة الإعلانية هذا. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

string (int64 format)

رقم تعريف المعيار.

string

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

boolean

لتحديد ما إذا كنت تريد استهداف (false) أو استبعاد (true) المعيار.

هذا الحقل غير قابل للتغيير. لتبديل معيار من إيجابي إلى سالب، عليك إزالته ثم إعادة إضافته.

number

معدِّل عرض السعر عند تطابق المعيار. يجب أن يكون المُعدَّل في النطاق: 0.1 - 10.0. تتوافق معظم أنواع المعايير القابلة للاستهداف مع المعدِّلات.

string (int64 format)

عرض سعر النقرة.

string (int64 format)

عرض السعر الفعّال للنقرة.

enum (AdGroupCriterionEngineStatus)

حالة المحرّك لمعيار المجموعة الإعلانية

string

نموذج عنوان URL لإلحاق المَعلمات برابط عنوان URL النهائي

string

نموذج عنوان URL لإنشاء عنوان URL للتتبع.

object (KeywordInfo)

الكلمة الرئيسية.

object (ListingGroupInfo)

مجموعة البيانات.

object (AgeRangeInfo)

الفئة العمرية

object (GenderInfo)

الجنس

object (UserListInfo)

قائمة المستخدمين.

object (WebpageInfo)

صفحة ويب

object (LocationInfo)

الموقع الجغرافي.

{
  "qualityScore": integer
}

integer

نقاط الجودة.

قد لا تتم تعبئة هذا الحقل إذا لم تتوفر لدى Google معلومات كافية لتحديد قيمة.

{
  "topOfPageCpcMicros": string
}

string (int64 format)

تقدير عرض سعر النقرة المطلوب لعرض الإعلان في أعلى الصفحة الأولى من نتائج البحث.

{
  "matchType": enum (KeywordMatchType),
  "text": string
}

enum (KeywordMatchType)

نوع مطابقة الكلمة الرئيسية.

string

نص الكلمة الرئيسية (80 حرفًا و10 كلمات كحد أقصى).

{
  "type": enum (ListingGroupType)
}

enum (ListingGroupType)

نوع مجموعة البيانات.

{
  "type": enum (AgeRangeType)
}

enum (AgeRangeType)

تمثّل هذه السمة نوع الفئة العمرية.

{
  "type": enum (GenderType)
}

enum (GenderType)

تمثّل هذه السمة نوع الجنس.

{
  "userList": string
}

string

اسم مورد "قائمة المستخدمين".

{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}

object (WebpageConditionInfo)

الشروط أو التعبيرات المنطقية لاستهداف صفحة الويب. يتم جمع قائمة شروط استهداف صفحات الويب معًا عند تقييمها للاستهداف. تشير قائمة الشروط الفارغة إلى أن جميع صفحات الموقع الإلكتروني للحملة مستهدفة.

هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE.

number

نسبة تغطية معايير الموقع الإلكتروني. هذه هي النسبة المئوية المحسوبة لتغطية الموقع الإلكتروني استنادًا إلى استهداف الموقع الإلكتروني واستهداف الموقع الإلكتروني السلبي والكلمات الرئيسية السلبية في المجموعة الإعلانية والحملة. على سبيل المثال، عندما تكون التغطية تساوي 1، فإنها تشير إلى أن التغطية تبلغ 100%. هذا الحقل للقراءة فقط.

string

اسم المعيار الذي تحدّده هذه المَعلمة سيتم استخدام قيمة الاسم لتحديد المعايير وترتيبها وتصفيتها باستخدام هذا النوع من المعلمات.

هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE.

{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}

enum (WebpageConditionOperand)

خاص بشروط استهداف صفحة الويب.

enum (WebpageConditionOperator)

مشغِّل شرط استهداف صفحة الويب

string

وسيطة شرط استهداف صفحة الويب.

{
  "geoTargetConstant": string
}

string

اسم المورد الثابت للاستهداف الجغرافي.

{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}

string

اسم المورد لتصنيف معيار المجموعة الإعلانية. تكون أسماء موارد تصنيف معيار المجموعة الإعلانية على النحو التالي: customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

string

معيار المجموعة الإعلانية الذي يتم إرفاق التصنيف به.

string

التصنيف المعيَّن لمعيار المجموعة الإعلانية.

{
  "resourceName": string,
  "adGroup": string,
  "label": string
}

string

اسم المورد لتصنيف المجموعة الإعلانية. تكون أسماء موارد تصنيف المجموعة الإعلانية على النحو التالي: customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}

string

المجموعة الإعلانية التي تم إرفاق التصنيف بها.

string

التصنيف المعيَّن للمجموعة الإعلانية.

{
  "resourceName": string
}

string

اسم المورد لعرض الفئة العمرية. تكون أسماء موارد عرض الفئة العمرية على النحو التالي:

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}

string

اسم المورد لمادة العرض وتكون أسماء موارد مواد العرض على النحو التالي:

customers/{customerId}/assets/{assetId}

enum (AssetType)

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

string

قائمة بعناوين URL النهائية المحتملة بعد جميع عمليات إعادة التوجيه عبر النطاقات.

enum (AssetStatus)

حالة مادة العرض

string

الطابع الزمني لوقت إنشاء مادة العرض هذه يظهر الطابع الزمني في المنطقة الزمنية للعميل بالتنسيق "yyyy-MM-dd HH:mm:ss" .

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على مادة العرض هذه التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

string (int64 format)

رقم تعريف مادة العرض

string

اسم اختياري لمادة العرض

string

نموذج عنوان URL لإنشاء عنوان URL للتتبع.

enum (AssetEngineStatus)

حالة المحرّك لمادة العرض.

object (YoutubeVideoAsset)

مادة عرض فيديو على YouTube

object (ImageAsset)

مادة عرض صورة

object (TextAsset)

مادة عرض نصية

object (UnifiedCalloutAsset)

مادة عرض موحَّدة لوسائل الشرح.

object (UnifiedSitelinkAsset)

مادة عرض موحّدة لرابط أقسام الموقع

object (UnifiedPageFeedAsset)

مادة عرض موحّدة لخلاصة الصفحة

object (MobileAppAsset)

مادة عرض تطبيق للأجهزة الجوّالة

object (UnifiedCallAsset)

مادة عرض مكالمة موحَّدة.

object (CallToActionAsset)

مادة عرض لعبارة الحث على اتخاذ إجراء.

object (UnifiedLocationAsset)

مادة عرض موحَّدة للموقع الجغرافي

{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}

string

عنوان الفيديو على YouTube

string

معرّف الفيديو على YouTube وهي قيمة السلسلة المكونة من 11 حرفًا والمستخدَمة في عنوان URL لفيديو YouTube.

{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}

enum (MimeType)

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

object (ImageDimension)

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

string (int64 format)

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

{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}

string (int64 format)

ارتفاع الصورة.

string (int64 format)

عرض الصورة.

string

تمثّل هذه السمة عنوان URL يعرض الصورة بهذا الارتفاع والعرض.

{
  "text": string
}

string

المحتوى النصي لمادة العرض النصية

{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}

string

نص وسيلة الشرح. يجب أن يكون طول هذه السلسلة بين 1 و25، بشكل شامل.

string

تاريخ البدء عندما تصبح مادة العرض هذه سارية ويمكن أن يبدأ عرضها بالتنسيق yyyy-MM-dd

string

التاريخ الأخير الذي أصبحت فيه مادة العرض هذه سارية ولا تزال قيد العرض، بالتنسيق yyyy-MM-dd

object (AdScheduleInfo)

قائمة بالجداول الزمنية غير المتداخلة التي تحدِّد جميع الفواصل الزمنية التي قد تُعرض خلالها مادة العرض يمكن أن يكون هناك 6 جداول زمنية كحد أقصى في اليوم، وإجمالي 42 جدولاً.

boolean

يمكنك اختيار ما إذا كنت تريد إظهار مادة العرض في المنطقة الزمنية لمستخدم البحث. ينطبق ذلك على Microsoft Ads.

{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}

enum (MinuteOfHour)

دقائق بعد ساعة البدء التي يبدأ فيها هذا الجدول الزمني

هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE.

enum (MinuteOfHour)

دقائق بعد ساعة الانتهاء التي ينتهي فيها هذا الجدول الزمني. لا يشمل الجدول الزمني دقيقة النهاية.

هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE.

enum (DayOfWeek)

يوم من الأسبوع ينطبق عليه الجدول الزمني.

هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE.

integer

ساعة البدء بعد 24 ساعة يجب أن تتراوح قيمة هذا الحقل بين 0 و23، بشكل شامل.

هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE.

integer

ساعة الانتهاء بعد 24 ساعة بينما يشير الرقم 24 إلى نهاية اليوم. يجب أن يكون الرقم ضمنًا بين 0 و24.

هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE.

{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}

string

النص المعروض لعنوان URL لرابط أقسام الموقع. يجب أن يكون طول هذه السلسلة بين 1 و25، بشكل شامل.

string

السطر الأول من وصف رابط أقسام الموقع. وفي حال ضبطها، يجب أن يكون الطول بين 1 و35، ويجب أيضًا ضبط الوصف 2.

string

السطر الثاني من وصف رابط أقسام الموقع. وفي حال ضبطها، يجب أن يكون الطول بين 1 و35، ويجب أيضًا ضبط description1.

string

تاريخ البدء عندما تصبح مادة العرض هذه سارية ويمكن أن يبدأ عرضها بالتنسيق yyyy-MM-dd

string

التاريخ الأخير الذي أصبحت فيه مادة العرض هذه سارية ولا تزال قيد العرض، بالتنسيق yyyy-MM-dd

object (AdScheduleInfo)

قائمة بالجداول الزمنية غير المتداخلة التي تحدِّد جميع الفواصل الزمنية التي قد تُعرض خلالها مادة العرض يمكن أن يكون هناك 6 جداول زمنية كحد أقصى في اليوم، وإجمالي 42 جدولاً.

string (int64 format)

رقم التعريف المستخدَم لتتبُّع النقرات على مادة عرض رابط أقسام الموقع هذا حساب Yahoo! في اليابان فقط.

boolean

يمكنك اختيار ما إذا كنت تريد إظهار مادة عرض رابط أقسام الموقع في المنطقة الزمنية لمستخدم البحث. ينطبق ذلك على Microsoft Ads.

boolean

تحدّد هذه السمة ما إذا كنت تفضّل عرض مادة عرض رابط أقسام الموقع على الأجهزة الجوّالة. ينطبق ذلك على Microsoft Ads.

{
  "pageUrl": string,
  "labels": [
    string
  ]
}

string

صفحة الويب التي يريد المعلنون استهدافها.

string

التصنيفات المستخدمة لتجميع عناوين URL للصفحات.

{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}

string

مطلوب. سلسلة تُعرِّف تطبيقًا للأجهزة الجوّالة بشكلٍ فريد. يجب أن تحتوي فقط على المعرّف الأصلي للنظام الأساسي، مثل "com.android.ebay" لنظام التشغيل Android أو "12345689" لنظام التشغيل iOS.

enum (MobileAppVendor)

مطلوب. متجر التطبيقات الذي يوزّع هذا التطبيق المحدّد.

{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}

string

رمز البلد المكوّن من حرفَين لرقم الهاتف. أمثلة: "الولايات المتحدة" و"الولايات المتحدة".

string

رقم الهاتف الأولي للمعلِن. أمثلة: '1234567890'، '(123)456-7890'

enum (CallConversionReportingState)

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

string

إجراء الإحالة الناجحة الذي يتم تحديد مصدر إحالة ناجحة للمكالمات عليه. وفي حال ترك هذه السياسة بدون ضبط، يتم استخدام إجراء الإحالة الناجحة التلقائي. لن يكون لهذا الحقل أي تأثير إلا في حال ضبط call ConversionReportingState على USE_LOCATION_LEVEL_CALL_CONVERSION_ACTION.

object (AdScheduleInfo)

قائمة بالجداول الزمنية غير المتداخلة التي تحدِّد جميع الفواصل الزمنية التي قد تُعرض خلالها مادة العرض يمكن أن يكون هناك 6 جداول زمنية كحد أقصى في اليوم، وإجمالي 42 جدولاً.

boolean

ما إذا كانت المكالمة تعرض فقط رقم الهاتف بدون رابط إلى الموقع الإلكتروني. ينطبق ذلك على Microsoft Ads.

boolean

لتحديد ما إذا كان ينبغي تفعيل المكالمة على تتبع المكالمات أم لا. ينطبق ذلك على Microsoft Ads.

boolean

تحديد ما إذا كان سيتم عرض إضافة المكالمة في المنطقة الزمنية لمستخدم البحث. ينطبق ذلك على Microsoft Ads.

string

تاريخ البدء عندما تصبح مادة العرض هذه سارية ويمكن أن يبدأ عرضها بالتنسيق yyyy-MM-dd

string

التاريخ الأخير الذي أصبحت فيه مادة العرض هذه سارية ولا تزال قيد العرض، بالتنسيق yyyy-MM-dd

{
  "callToAction": enum (CallToActionType)
}

enum (CallToActionType)

عبارة تحث المستخدم على اتخاذ إجراء.

{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}

string

تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". هذا الحقل فريد لرقم تعريف عميل ونوع مادة عرض محدّدَين. اطّلع على https://developers.google.com/places/web-service/place-id لمعرفة المزيد من المعلومات عن رقم تعريف المكان.

object (BusinessProfileLocation)

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

enum (LocationOwnershipType)

نوع ملكية الموقع الجغرافي. إذا كان النوع هو business_OWNER، فسيتم عرضه كإضافة موقع. إذا كان النوع "شريك تابع"، سيتم عرضه كموقع جغرافي للشركاء التابعين.

{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}

string

التصنيف الذي حدّده المعلن للموقع الجغرافي في حساب "الملف التجاري" وتتم مزامنة هذه البيانات من حساب "الملف التجاري على Google".

string

رمز متجر الملف التجاري الخاص بهذا الموقع الجغرافي وتتم مزامنة هذه البيانات من حساب "الملف التجاري على Google".

string (int64 format)

رقم تعريف النشاط لهذا الموقع الجغرافي في "الملف التجاري" تتم مزامنة هذه البيانات من حساب "الملف التجاري" المرتبط.

{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}

string

اسم المورد لمادة العرض الخاصة بمجموعة مواد العرض يظهر اسم المورد لمواد العرض في مجموعة مواد العرض على النحو التالي:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

string

مجموعة مواد العرض التي تربطها مادة عرض مجموعة مواد العرض هذه

string

مادة العرض التي تربطها مادة عرض مجموعة مواد العرض هذه

enum (AssetFieldType)

وصف لموضع مادة العرض ضمن مجموعة مواد العرض. على سبيل المثال: HEADLINE وYOUTUBE_VIDEO وما إلى ذلك

enum (AssetLinkStatus)

حالة الرابط بين مجموعة مواد عرض ومجموعة مواد عرض.

{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}

string

اسم المورد لإشارة مجموعة مواد العرض يكون اسم مورد إشارة مجموعة مواد العرض بالشكل التالي:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

string

مجموعة مواد العرض التي تنتمي إليها إشارة مجموعة مواد العرض هذه

object (AudienceInfo)

إشارة الجمهور التي ستستخدمها "حملة الأداء الأفضل".

{
  "audience": string
}

string

اسم مورد "الجمهور"

{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}

string

اسم المورد لفلتر مجموعة بيانات مجموعة مواد العرض يكون اسم مورد فلتر مجموعة بيانات مجموعة مواد العرض على النحو التالي:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

string

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

string (int64 format)

رقم تعريف ListingGroupFilter.

enum (ListingGroupFilterType)

نوع عقدة فلتر مجموعة بيانات.

enum (ListingGroupFilterVertical)

القطاع الذي تمثّله شجرة العقدة الحالية يجب أن تنتمي جميع العُقد في الشجرة نفسها إلى موضع الإعلان نفسه.

object (ListingGroupFilterDimension)

قيمة السمة التي تعمل مجموعة البيانات هذه على تحسين عنصرها الرئيسي. غير محدّد للمجموعة الجذر.

string

اسم المورد للقسم الفرعي من مجموعة البيانات الرئيسية. قيمة فارغة في عقدة فلتر مجموعة البيانات الجذر.

object (ListingGroupFilterDimensionPath)

مسار السمات التي تحدّد فلتر مجموعة البيانات هذا.

{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}

object (ProductBiddingCategory)

فئة عروض الأسعار لعرض منتج.

object (ProductBrand)

تمثّل هذه السمة العلامة التجارية لعرض المنتج.

object (ProductChannel)

المنطقة المحلية لعرض المنتج.

object (ProductCondition)

تمثّل هذه السمة حالة عرض المنتج.

object (ProductCustomAttribute)

السمة المخصّصة لعرض منتج.

object (ProductItemId)

معرّف السلعة لعرض منتج

object (ProductType)

تمثّل هذه السمة نوع عرض المنتج.

{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}

enum (ListingGroupFilterBiddingCategoryLevel)

ويشير إلى مستوى الفئة في التصنيف.

string (int64 format)

رقم تعريف فئة عروض أسعار المنتج.

يعادل هذا المعرّف معرّف فئة المنتجات من Google كما هو موضّح في هذه المقالة: https://support.google.com/merchants/answer/6324436

{
  "value": string
}

string

قيمة سلسلة للعلامة التجارية للمنتج

{
  "channel": enum (ListingGroupFilterProductChannel)
}

enum (ListingGroupFilterProductChannel)

قيمة المنطقة المحلية