أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Package google.ads.searchads360.v0.resources

الفهرس

AccessibleBiddingStrategy (رسالة)
AccessibleBiddingStrategy.MaximizeConversionValue (رسالة)
AccessibleBiddingStrategy.MaximizeConversions (رسالة)
AccessibleBiddingStrategy.TargetCpa (رسالة)
AccessibleBiddingStrategy.TargetImpressionShare (رسالة)
AccessibleBiddingStrategy.TargetRoas (رسالة)
AccessibleBiddingStrategy.TargetSpend (رسالة)
Ad (رسالة)
AdGroup (رسالة)
AdGroupAd (رسالة)
AdGroupAdEffectiveLabel (رسالة)
AdGroupAdLabel (رسالة)
AdGroupAsset (رسالة)
AdGroupAssetSet (رسالة)
AdGroupAudienceView (رسالة)
AdGroupBidModifier (رسالة)
AdGroupCriterion (رسالة)
AdGroupCriterion.PositionEstimates (رسالة)
AdGroupCriterion.QualityInfo (رسالة)
AdGroupCriterionEffectiveLabel (رسالة)
AdGroupCriterionLabel (رسالة)
AdGroupEffectiveLabel (رسالة)
AdGroupLabel (رسالة)
AgeRangeView (رسالة)
Asset (رسالة)
AssetGroup (رسالة)
AssetGroupAsset (رسالة)
AssetGroupAssetCombinationData (رسالة)
AssetGroupListingGroupFilter (رسالة)
AssetGroupSignal (رسالة)
AssetGroupTopCombinationView (رسالة)
AssetSet (رسالة)
AssetSetAsset (رسالة)
Audience (رسالة)
BiddingStrategy (رسالة)
Campaign (رسالة)
Campaign.DynamicSearchAdsSetting (رسالة)
Campaign.GeoTargetTypeSetting (رسالة)
Campaign.NetworkSettings (رسالة)
Campaign.OptimizationGoalSetting (رسالة)
Campaign.SelectiveOptimization (رسالة)
Campaign.ShoppingSetting (رسالة)
Campaign.TrackingSetting (رسالة)
CampaignAsset (رسالة)
CampaignAssetSet (رسالة)
CampaignAudienceView (رسالة)
CampaignBudget (رسالة)
CampaignCriterion (رسالة)
CampaignEffectiveLabel (رسالة)
CampaignLabel (رسالة)
CartDataSalesView (رسالة)
Conversion (رسالة)
ConversionAction (رسالة)
ConversionAction.AttributionModelSettings (رسالة)
ConversionAction.FloodlightSettings (رسالة)
ConversionAction.ValueSettings (رسالة)
ConversionCustomVariable (رسالة)
ConversionCustomVariable.FloodlightConversionCustomVariableInfo (رسالة)
ConversionTrackingSetting (رسالة)
CustomColumn (رسالة)
Customer (رسالة)
CustomerAsset (رسالة)
CustomerAssetSet (رسالة)
CustomerClient (رسالة)
CustomerManagerLink (رسالة)
DoubleClickCampaignManagerSetting (رسالة)
DynamicSearchAdsSearchTermView (رسالة)
GenderView (رسالة)
GeoTargetConstant (رسالة)
KeywordView (رسالة)
Label (رسالة)
LanguageConstant (رسالة)
ListingGroupFilterDimension (رسالة)
ListingGroupFilterDimension.ProductBiddingCategory (رسالة)
ListingGroupFilterDimension.ProductBrand (رسالة)
ListingGroupFilterDimension.ProductChannel (رسالة)
ListingGroupFilterDimension.ProductCondition (رسالة)
ListingGroupFilterDimension.ProductCustomAttribute (رسالة)
ListingGroupFilterDimension.ProductItemId (رسالة)
ListingGroupFilterDimension.ProductType (رسالة)
ListingGroupFilterDimensionPath (رسالة)
LocationView (رسالة)
ProductBiddingCategoryConstant (رسالة)
ProductGroupView (رسالة)
SearchAds360Field (رسالة)
ShoppingPerformanceView (رسالة)
UserList (رسالة)
UserLocationView (رسالة)
Visit (رسالة)
WebpageView (رسالة)

AccessibleBiddingStrategy

تمثّل عرضًا لـ "استراتيجيات عروض الأسعار" التي يملكها العميل ويشاركها معه.

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

الحقول
`resource_name`	`string` اسم المورد لاستراتيجية عروض الأسعار التي يمكن الوصول إليها تكون أسماء موارد AccessibleServicesStrategy على النحو التالي: `customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}`
`id`	`int64` رقم تعريف استراتيجية عروض الأسعار.
`name`	`string` اسم استراتيجية عروض الأسعار.
`type`	`BiddingStrategyType` نوع استراتيجية عروض الأسعار.
`owner_customer_id`	`int64` الرقم التعريفي للعميل الذي يملك استراتيجية عروض الأسعار.
`owner_descriptive_name`	`string` descriptive_name للعميل الذي يملك استراتيجية عروض الأسعار
حقل الربط `scheme` مخطّط عروض الأسعار يمكن ضبط سمة واحدة فقط. يمكن أن يكون `scheme` واحدًا فقط مما يلي:
`maximize_conversion_value`	`MaximizeConversionValue` استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر قيمة للإحالات الناجحة لحملاتك في حدود ميزانيتك.
`maximize_conversions`	`MaximizeConversions` استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة لحملاتك في حدود ميزانيتك.
`target_cpa`	`TargetCpa` استراتيجية عروض أسعار تحدّد عروض الأسعار للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة وفقًا للتكلفة المستهدَفة للاكتساب التي تحدّدها.
`target_impression_share`	`TargetImpressionShare` استراتيجية عروض أسعار يتم تحسينها تلقائيًا لتحقيق نسبة مئوية محدّدة من مرّات الظهور.
`target_roas`	`TargetRoas` استراتيجية عروض أسعار تساعدك في زيادة الأرباح إلى أقصى حدّ مع احتساب متوسّط عائد إنفاق إعلاني مستهدَف محدّد.
`target_spend`	`TargetSpend` استراتيجية عروض أسعار تحدِّد عروض أسعارك لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.

MaximizeConversionValue

استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر قيمة للإحالات الناجحة لحملاتك في حدود ميزانيتك.

الحقول

الحقول
`target_roas`	`double` خيار عائد الإنفاق الإعلاني المستهدَف وفي حال ضبطها، ستحقّق استراتيجية عروض الأسعار الحد الأقصى من الأرباح مع احتساب متوسط عائد الإنفاق الإعلاني المستهدَف. إذا كان عائد الإنفاق الإعلاني المستهدَف مرتفعًا، قد لا تتمكّن استراتيجية عروض الأسعار من إنفاق الميزانية بالكامل. في حال عدم ضبط عائد الإنفاق الإعلاني المستهدَف، ستعمل استراتيجية عروض الأسعار على تحقيق أعلى عائد إنفاق إعلاني ممكن للميزانية.

target_roas

double

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

MaximizeConversions

استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة لحملاتك في حدود ميزانيتك.

الحقول

الحقول
`target_cpa`	`int64` خيار التكلفة المستهدفة للإجراء هذا هو متوسّط المبلغ الذي تريد إنفاقه لكلّ اكتساب.
`target_cpa_micros`	`int64` خيار التكلفة المستهدفة للإجراء هذا هو متوسّط المبلغ الذي تريد إنفاقه لكلّ اكتساب.

target_cpa

int64

خيار التكلفة المستهدفة للإجراء هذا هو متوسّط المبلغ الذي تريد إنفاقه لكلّ اكتساب.

target_cpa_micros

int64

خيار التكلفة المستهدفة للإجراء هذا هو متوسّط المبلغ الذي تريد إنفاقه لكلّ اكتساب.

TargetCpa

استراتيجية عروض أسعار مُبرمَجة تحدّد عروض الأسعار للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة وفقًا لتكلفة الإجراء المستهدفة (CPA) التي تحدِّدها.

الحقول

الحقول
`target_cpa_micros`	`int64` متوسط التكلفة المستهدَفة للإجراء. يجب أن يكون هذا الهدف أكبر من أو يساوي الحد الأدنى للوحدة القابلة للفوترة استنادًا إلى عملة الحساب.

target_cpa_micros

int64

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

TargetImpressionShare

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

الحقول

الحقول
`location`	`TargetImpressionShareLocation` الموقع الجغرافي المستهدَف في صفحة نتائج البحث
`location_fraction_micros`	`int64` الجزء المحدّد من الإعلانات التي سيتم عرضها في الموقع الجغرافي المستهدَف بالميكرو على سبيل المثال، %1 تساوي 10,000.
`cpc_bid_ceiling_micros`	`int64` أعلى عرض سعر للنقرة يُسمح لنظام عروض الأسعار المبرمَجة بتحديده. هذا حقل مطلوب أدخله المعلِن ويحدّد الحدّ الأقصى ومحددًا بوحدات المايكرو المحلية.

location

TargetImpressionShareLocation

الموقع الجغرافي المستهدَف في صفحة نتائج البحث

location_fraction_micros

int64

الجزء المحدّد من الإعلانات التي سيتم عرضها في الموقع الجغرافي المستهدَف بالميكرو على سبيل المثال، %1 تساوي 10,000.

cpc_bid_ceiling_micros

int64

أعلى عرض سعر للنقرة يُسمح لنظام عروض الأسعار المبرمَجة بتحديده. هذا حقل مطلوب أدخله المعلِن ويحدّد الحدّ الأقصى ومحددًا بوحدات المايكرو المحلية.

TargetRoas

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

الحقول

الحقول
`target_roas`	`double` الأرباح المحدّدة (استنادًا إلى بيانات الإحالات الناجحة) لكل وحدة إنفاق

target_roas

double

الأرباح المحدّدة (استنادًا إلى بيانات الإحالات الناجحة) لكل وحدة إنفاق

TargetSpend

استراتيجية عروض أسعار مبرمَجة تحدِّد عروض أسعارك لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.

الحقول

الحقول
`target_spend_micros (deprecated)`	`int64` تم إيقاف هذا العنصر نهائيًا. الإنفاق المستهدَف الذي يتمّ من خلاله زيادة النقرات إلى أقصى حدّ سيحاول مقدّم عروض أسعار TargetSpend إنفاق القيمة الأصغر من هذه القيمة أو مبلغ الإنفاق الطبيعي الذي تمّ تقييده. في حال عدم تحديدها، يتم استخدام الميزانية كمستهدف الإنفاق. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه. اطّلِع على https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html للاطّلاع على التفاصيل.
`cpc_bid_ceiling_micros`	`int64` الحدّ الأقصى لعروض الأسعار الذي يمكن أن تحدّده استراتيجية عروض الأسعار. وينطبق الحدّ على جميع الكلمات الرئيسية التي تُديرها الاستراتيجية.

target_spend_micros
(deprecated)

int64

الإنفاق المستهدَف الذي يتمّ من خلاله زيادة النقرات إلى أقصى حدّ سيحاول مقدّم عروض أسعار TargetSpend إنفاق القيمة الأصغر من هذه القيمة أو مبلغ الإنفاق الطبيعي الذي تمّ تقييده. في حال عدم تحديدها، يتم استخدام الميزانية كمستهدف الإنفاق. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه. اطّلِع على https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html للاطّلاع على التفاصيل.

cpc_bid_ceiling_micros

int64

الحدّ الأقصى لعروض الأسعار الذي يمكن أن تحدّده استراتيجية عروض الأسعار. وينطبق الحدّ على جميع الكلمات الرئيسية التي تُديرها الاستراتيجية.

الحقول
`resource_name`	`string` اسم مورد الإعلان تكون أسماء موارد الإعلانات على النحو التالي: `customers/{customer_id}/ads/{ad_id}`
`final_urls[]`	`string` قائمة عناوين URL النهائية المحتمَلة بعد كل عمليات إعادة التوجيه عبر النطاقات للإعلان
`type`	`AdType` نوع الإعلان.
`id`	`int64` رقم تعريف الإعلان.
`display_url`	`string` عنوان URL الذي يظهر في وصف الإعلان لبعض أشكال الإعلانات.
`name`	`string` اسم الإعلان. لا يُستخدَم هذا الإجراء إلّا للتعرّف على الإعلان. ولا يلزم أن يكون فريدًا ولا يؤثّر في الإعلان المعروض. لا يتوفّر حقل الاسم حاليًا إلا لأنواع الإعلانات DisplayUploadAd وImageAd وShoppingComparisonListingAd وVideoAd.
حقل الاتحاد `ad_data`. التفاصيل ذات الصلة بنوع الإعلان. يجب ضبط قيمة واحدة بالضبط. يمكن أن يكون `ad_data` واحدًا فقط مما يلي:
`text_ad`	`SearchAds360TextAdInfo` تفاصيل تتعلّق بإعلان نصي
`expanded_text_ad`	`SearchAds360ExpandedTextAdInfo` تفاصيل تتعلّق بإعلان نصي موسّع
`responsive_search_ad`	`SearchAds360ResponsiveSearchAdInfo` تفاصيل تتعلّق بإعلان متجاوب على شبكة البحث
`product_ad`	`SearchAds360ProductAdInfo` تفاصيل ذات صلة بإعلان منتج.
`expanded_dynamic_search_ad`	`SearchAds360ExpandedDynamicSearchAdInfo` التفاصيل المتعلقة بإعلان ديناميكي موسّع على شبكة البحث.

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

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

الحقول
`resource_name`	`string` اسم مورد المجموعة الإعلانية. تكون أسماء موارد المجموعات الإعلانية على النحو التالي: `customers/{customer_id}/adGroups/{ad_group_id}`
`status`	`AdGroupStatus` حالة المجموعة الإعلانية.
`type`	`AdGroupType` نوع المجموعة الإعلانية.
`ad_rotation_mode`	`AdGroupAdRotationMode` وضع عرض الإعلانات بالتناوب للمجموعة الإعلانية.
`creation_time`	`string` الطابع الزمني لوقت إنشاء هذه المجموعة الإعلانية. يظهر الطابع الزمني في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss".
`targeting_setting`	`TargetingSetting` إعداد لاستهداف الميزات ذات الصلة.
`labels[]`	`string` أسماء مصادر التصنيفات المرتبطة بهذه المجموعة الإعلانية.
`effective_labels[]`	`string` أسماء مصادر التصنيفات الفعّالة المرتبطة بهذه المجموعة الإعلانية التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لهذه المجموعة الإعلانية.
`engine_id`	`string` رقم تعريف المجموعة الإعلانية في حساب المحرّك الخارجي. هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan وMicrosoft وBaidu وما إلى ذلك. بالنسبة إلى الكيانات في "إعلانات Google"، استخدِم "ad_group.id" بدلاً من ذلك.
`start_date`	`string` تاريخ بدء عرض الإعلانات في هذه المجموعة الإعلانية. تبدأ المجموعة الإعلانية تلقائيًا الآن أو في تاريخ بدء المجموعة الإعلانية، أيهما لاحق. إذا تم ضبط هذا الحقل، تبدأ المجموعة الإعلانية من بداية التاريخ المحدّد في المنطقة الزمنية للعميل. لا يتوفّر هذا الحقل إلا لحسابات Microsoft Advertising وبوابات Facebook. التنسيق: YYYY-MM-DD، مثال: ‎2019-03-14
`end_date`	`string` تاريخ انتهاء المجموعة الإعلانية عن عرض الإعلانات. تنتهي المجموعة الإعلانية تلقائيًا في تاريخ انتهاء المجموعة الإعلانية. في حال ضبط هذا الحقل، تنتهي المجموعة الإعلانية في نهاية التاريخ المحدّد في المنطقة الزمنية للعميل. لا يتوفّر هذا الحقل إلا لحسابات Microsoft Advertising وبوابات Facebook. التنسيق: YYYY-MM-DD، مثال: ‎2019-03-14
`language_code`	`string` لغة الإعلانات والكلمات الرئيسية في مجموعة إعلانية هذا الحقل متاح فقط لحسابات Microsoft Advertising. مزيد من التفاصيل: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
`last_modified_time`	`string` التاريخ والوقت اللذان تمّ فيهما إجراء آخر تعديل على هذه المجموعة الإعلانية. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
`id`	`int64` رقم تعريف المجموعة الإعلانية.
`name`	`string` اسم المجموعة هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء مجموعات إعلانية جديدة. يجب أن يحتوي على أقل من 255 حرفًا بتنسيق UTF-8 بعرض كامل. يجب ألا يحتوي على أي أحرف فارغة (قيمة موضع الرمز 0x0) أو فواصل أسطر (قيمة موضع الرمز 0xA) أو علامات رجوع إلى أول السطر (قيمة موضع الرمز 0xD).
`cpc_bid_micros`	`int64` عرض السعر الأقصى للنقرة.
`engine_status`	`AdGroupEngineStatus` حالة المحرّك للمجموعة الإعلانية.

AdGroupAd

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

الحقول
`resource_name`	`string` اسم مورد الإعلان. يكون لأسماء موارد الإعلانات للمجموعات الإعلانية الشكل التالي: `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}`
`status`	`AdGroupAdStatus` حالة الإعلان.
`ad`	`Ad` الإعلان.
`creation_time`	`string` الطابع الزمني لوقت إنشاء ad_group_ad هذا. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
`labels[]`	`string` أسماء موارد التصنيفات المرفقة بإعلان المجموعة الإعلانية هذا.
`effective_labels[]`	`string` أسماء موارد التصنيفات الفعّالة المرفقة بهذا الإعلان. التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لهذا الإعلان.
`engine_id`	`string` رقم تعريف الإعلان في حساب محرّك البحث الخارجي هذا الحقل مخصّص لحساب "إعلانات شبكة البحث 360" فقط، مثل Yahoo Japan وMicrosoft وBidu وما إلى ذلك. وبالنسبة إلى الكيانات الأخرى في "إعلانات شبكة البحث 360"، استخدِم "ad_group_ad.ad.id" بدلاً من ذلك.
`engine_status`	`AdGroupAdEngineStatus` حالة إضافية للإعلان في حساب محرّك البحث الخارجي تشمل الحالات المحتملة (حسب نوع الحساب الخارجي) "نشط" و"مؤهّل" و"في انتظار المراجعة" وما إلى ذلك.
`last_modified_time`	`string` التاريخ والوقت اللذان تمّ فيهما إجراء آخر تعديل على إعلان هذه المجموعة الإعلانية. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".

AdGroupAdEffectiveLabel

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

الحقول
`resource_name`	`string` اسم المرجع للتصنيف الفعّال للإعلان في المجموعة الإعلانية يكون شكل أسماء موارد التصنيفات الفعالة للإعلانات في المجموعة الإعلانية على النحو التالي: `customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}`
`ad_group_ad`	`string` إعلان المجموعة الإعلانية الذي تم إرفاق التصنيف الفعال به.
`label`	`string` التصنيف الفعّال الذي تمّ تعيينه لإعلان المجموعة الإعلانية.
`owner_customer_id`	`int64` رقم تعريف العميل الذي يملك التصنيف الفعّال.

AdGroupAdLabel

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

الحقول
`resource_name`	`string` اسم مصدر تصنيف الإعلان للمجموعة الإعلانية. تكون أسماء موارد تصنيفات الإعلانات للمجموعات الإعلانية على النحو التالي: `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}`
`ad_group_ad`	`string` إعلان المجموعة الإعلانية الذي تم إرفاق التصنيف به.
`label`	`string` التصنيف الذي تمّ تعيينه لإعلان المجموعة الإعلانية.
`owner_customer_id`	`int64` رقم تعريف العميل الذي يملك التصنيف.

AdGroupAsset

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

الحقول
`resource_name`	`string` اسم المرجع لمادة عرض المجموعة الإعلانية. تكون أسماء موارد AdGroupAsset على النحو التالي: `customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}`
`ad_group`	`string` مطلوب. المجموعة الإعلانية التي ترتبط بها مادة العرض.
`asset`	`string` مطلوب. مادة العرض المرتبطة بالمجموعة الإعلانية.
`status`	`AssetLinkStatus` حالة مادة عرض المجموعة الإعلانية

AdGroupAssetSet

AdGroupAssetSet هو الرابط بين مجموعة إعلانية ومجموعة مواد عرض. يؤدي إنشاء AdGroupAssetSet إلى ربط مجموعة مواد عرض بمجموعة إعلانية.

الحقول
`resource_name`	`string` اسم المورد لمجموعة مواد عرض المجموعة الإعلانية. يكون لأسماء موارد مجموعة مواد العرض على مستوى المجموعة الإعلانية التنسيق التالي: `customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}`
`ad_group`	`string` المجموعة الإعلانية المرتبطة بمجموعة مواد العرض هذه.
`asset_set`	`string` مجموعة مواد العرض المرتبطة بالمجموعة الإعلانية.
`status`	`AssetSetLinkStatus` حالة مجموعة مواد عرض المجموعة الإعلانية. للقراءة فقط.

AdGroupAudienceView

عرض شريحة جمهور مجموعة إعلانية يتضمّن بيانات الأداء من الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على "الشبكة الإعلانية" و"شبكة YouTube"، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث (RLSA)، ويتم تجميعها على مستوى الجمهور.

الحقول

الحقول
`resource_name`	`string` اسم المورد لعرض جمهور المجموعة الإعلانية. يكون شكل أسماء موارد عرض الجمهور على مستوى المجموعة الإعلانية على النحو التالي: `customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}`

resource_name

string

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

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

تمثّل مُعدِّل عرض سعر المجموعة الإعلانية.

الحقول
`resource_name`	`string` اسم المورد لمعدِّل عروض أسعار المجموعة الإعلانية. يكون شكل أسماء موارد مُعدِّل عروض أسعار المجموعة الإعلانية على النحو التالي: `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}`
`bid_modifier`	`double` المُعدِّل لعرض السعر عند تطابق المعيار يجب أن يكون المُعدِّل في النطاق: 0.1 - 10.0. يتراوح النطاق بين 1.0 و6.0 لعنصر PreferredContent. استخدِم القيمة 0 لإيقاف نوع جهاز.
حقل الربط `criterion` معيار معدِّل عروض أسعار هذه المجموعة الإعلانية. مطلوب في عمليات الإنشاء اعتبارًا من الإصدار 5. يمكن أن يكون `criterion` واحدًا فقط مما يلي:
`device`	`DeviceInfo` معيار الجهاز

AdGroupCriterion

معيار مجموعة إعلانية لا يعرض تقرير ad_group_criterion سوى المعايير التي تمت إضافتها صراحةً إلى المجموعة الإعلانية.

الحقول
`resource_name`	`string` اسم المورد لمعيار المجموعة الإعلانية. تكون أسماء موارد معايير المجموعة الإعلانية على النحو التالي: `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}`
`creation_time`	`string` الطابع الزمني لإنشاء معيار المجموعة الإعلانية هذا. يكون الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل.
`status`	`AdGroupCriterionStatus` حالة المعيار. هذه هي حالة عنصر معيار المجموعة الإعلانية، الذي يضبطه العميل. ملاحظة: قد تتضمّن تقارير واجهة المستخدِم معلومات إضافية تؤثّر في ما إذا كان المعيار مؤهّلاً للتنفيذ. في بعض الحالات، قد يستمر ظهور معيار تمّت إزالته في واجهة برمجة التطبيقات على أنّه مفعّل في واجهة المستخدِم. على سبيل المثال، تظهر الحملات تلقائيًا للمستخدمين من جميع الفئات العمرية ما لم يتم استبعادهم. ستعرض واجهة المستخدم كل فئة عمرية على أنها "مفعَّلة"، بما أنّها مؤهَّلة لمشاهدة الإعلانات، بينما ستعرض واجهة المستخدم AdGroupcriterion.status "تمت الإزالة"، بما أنه لم تتم إضافة معيار إيجابي.
`quality_info`	`QualityInfo` معلومات حول جودة المعيار
`type`	`CriterionType` تمثّل هذه السمة نوع المعيار.
`labels[]`	`string` أسماء موارد التصنيفات المرفقة بمعيار المجموعة الإعلانية هذا.
`effective_labels[]`	`string` أسماء الموارد للتسميات الفعّالة المرتبطة بمعيار المجموعة الإعلانية هذا. التصنيف الفعّال هو تصنيف مكتسب أو تم تعيينه مباشرةً لمعيار المجموعة الإعلانية هذا.
`position_estimates`	`PositionEstimates` تقديرات لعروض أسعار المعايير في مواضع مختلفة
`final_urls[]`	`string` قائمة عناوين URL النهائية المحتمَلة بعد كل عمليات إعادة التوجيه عبر النطاقات للإعلان
`engine_id`	`string` رقم تعريف معيار المجموعة الإعلانية في حساب المحرّك الخارجي هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan وMicrosoft وBidu وما إلى ذلك. وبالنسبة إلى كيان "إعلانات Google"، استخدِم "ad_group_criterion.criterion_id" بدلاً من ذلك.
`last_modified_time`	`string` التاريخ والوقت اللذان تمّ فيهما إجراء آخر تعديل على معيار المجموعة الإعلانية هذا. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
`criterion_id`	`int64` رقم تعريف المعيار.
`ad_group`	`string` المجموعة الإعلانية التي ينتمي إليها المعيار.
`negative`	`bool` لتحديد ما إذا كنت تريد استهداف (`false`) أو استبعاد (`true`) المعيار. هذا الحقل غير قابل للتغيير. لتبديل معيار من موجب إلى سلبي، أزِله ثم أعِد إضافته.
`bid_modifier`	`double` المُعدِّل لعرض السعر عند تطابق المعيار يجب أن يكون المُعدِّل في النطاق: 0.1 - 10.0. تتوافق معظم أنواع المعايير التي يمكن استهدافها مع المُعدِّلات.
`cpc_bid_micros`	`int64` عرض سعر النقرة.
`effective_cpc_bid_micros`	`int64` عرض سعر النقرة الفعّال
`engine_status`	`AdGroupCriterionEngineStatus` حالة المحرّك لمعيار المجموعة الإعلانية.
`final_url_suffix`	`string` نموذج عنوان URL لإلحاق المَعلمات بعنوان URL النهائي
`tracking_url_template`	`string` نموذج عنوان URL لإنشاء عنوان URL للتتبع.
حقل الربط `criterion` معيار المجموعة الإعلانية. يجب تحديد قيمة واحدة فقط. يمكن أن يكون `criterion` واحدًا فقط مما يلي:
`keyword`	`KeywordInfo` الكلمة الرئيسية
`listing_group`	`ListingGroupInfo` مجموعة البيانات
`age_range`	`AgeRangeInfo` الفئة العمرية
`gender`	`GenderInfo` الجنس
`user_list`	`UserListInfo` قائمة المستخدمين
`webpage`	`WebpageInfo` صفحة ويب
`location`	`LocationInfo` الموقع الجغرافي.

تقديرات_المواقع

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

الحقول

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

top_of_page_cpc_micros

int64

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

QualityInfo

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

الحقول

الحقول
`quality_score`	`int32` نقاط الجودة قد لا تتم تعبئة هذا الحقل إذا لم تتوفر لدى Google معلومات كافية لتحديد قيمة.

quality_score

int32

نقاط الجودة

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

AdGroupCriterionEffectiveLabel

علاقة بين معيار مجموعة إعلانية وعلامة فعّالة التصنيف الفعّال هو تصنيف مكتسب أو تم تعيينه مباشرةً لمعيار المجموعة الإعلانية هذا.

الحقول
`resource_name`	`string` اسم المورد للتصنيف الفعال لمعيار المجموعة الإعلانية. تكون أسماء موارد التصنيفات الفعّالة لمعيار المجموعة الإعلانية على النحو التالي: `customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}`.
`ad_group_criterion`	`string` معيار المجموعة الإعلانية الذي تم إرفاق التصنيف الفعال به.
`label`	`string` التصنيف الفعال الذي تم تعيينه لمعيار المجموعة الإعلانية.
`owner_customer_id`	`int64` رقم تعريف العميل الذي يملك التصنيف الساري

AdGroupCriterionLabel

علاقة بين معيار مجموعة إعلانية وعلامة

الحقول
`resource_name`	`string` اسم المرجع لتصنيف معيار المجموعة الإعلانية. تكون أسماء موارد تصنيفات معايير المجموعة الإعلانية على النحو التالي: `customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}`
`ad_group_criterion`	`string` معيار المجموعة الإعلانية الذي يتم إرفاق التصنيف به.
`label`	`string` التصنيف الذي تمّ تعيينه لمعيار المجموعة الإعلانية.
`owner_customer_id`	`int64` رقم تعريف العميل الذي يملك التصنيف.

AdGroupEffectiveLabel

علاقة بين مجموعة إعلانية وعلامة فعّالة التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لهذه المجموعة الإعلانية.

الحقول
`resource_name`	`string` اسم المورد لتصنيف فعّال للمجموعة الإعلانية. يكون شكل أسماء موارد التصنيفات الفعالة للمجموعات الإعلانية على النحو التالي: `customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}`
`ad_group`	`string` المجموعة الإعلانية التي تم إرفاق التصنيف الفعّال بها.
`label`	`string` التصنيف الفعال المعيّن للمجموعة الإعلانية.
`owner_customer_id`	`int64` رقم تعريف العميل الذي يملك التصنيف الفعّال.

AdGroupLabel

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

الحقول
`resource_name`	`string` اسم المورد لتصنيف المجموعة الإعلانية. يكون شكل أسماء موارد تصنيفات المجموعات الإعلانية على النحو التالي: `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}`
`ad_group`	`string` المجموعة الإعلانية التي تم إرفاق التصنيف بها.
`label`	`string` التصنيف الذي تمّ تعيينه للمجموعة الإعلانية.
`owner_customer_id`	`int64` رقم تعريف العميل الذي يملك التصنيف.

AgeRangeView

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

الحقول

الحقول
`resource_name`	`string` اسم المورد لعرض الفئة العمرية تكون أسماء موارد عرض الفئة العمرية على النحو التالي: `customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}`

resource_name

string

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

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

مادة العرض

مادة العرض هي جزء من إعلان يمكن مشاركتها في إعلانات متعددة. يمكن أن تكون صورة (ImageAsset) أو فيديو (YoutubeVideoAsset) أو غير ذلك. إنّ مواد العرض غير قابلة للتغيير ولا يمكن إزالتها. لإيقاف عرض مادة عرض، عليك إزالتها من الكيان الذي يستخدمها.

الحقول
`resource_name`	`string` اسم مورد مادة العرض. تكون أسماء موارد مواد العرض على النحو التالي: `customers/{customer_id}/assets/{asset_id}`
`type`	`AssetType` نوع مادة العرض
`final_urls[]`	`string` قائمة بعناوين URL النهائية المحتمَلة بعد جميع عمليات إعادة التوجيه عبر النطاقات
`status`	`AssetStatus` حالة مادة العرض
`creation_time`	`string` الطابع الزمني لوقت إنشاء مادة العرض هذه يكون الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل.
`last_modified_time`	`string` التاريخ والوقت اللذان تمّ فيهما تعديل مادة العرض هذه آخر مرة يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
`id`	`int64` رقم تعريف مادة العرض
`name`	`string` اسم اختياري لمادة العرض
`tracking_url_template`	`string` نموذج عنوان URL لإنشاء عنوان URL للتتبّع
`engine_status`	`AssetEngineStatus` حالة المحرّك لمادة عرض معيّنة.
حقل الربط `asset_data` النوع المحدّد لمادة العرض. يمكن أن يكون `asset_data` واحدًا فقط مما يلي:
`youtube_video_asset`	`YoutubeVideoAsset` مادة عرض فيديو على YouTube
`image_asset`	`ImageAsset` مادة عرض صورة
`text_asset`	`TextAsset` مادة عرض نصية
`callout_asset`	`UnifiedCalloutAsset` مادة عرض موحَّدة لوسائل الشرح.
`sitelink_asset`	`UnifiedSitelinkAsset` مادة عرض موحّدة لروابط أقسام الموقع
`page_feed_asset`	`UnifiedPageFeedAsset` مادة عرض موحّدة لخلاصة الصفحة
`mobile_app_asset`	`MobileAppAsset` مادة عرض تطبيق متوافق مع الأجهزة الجوّالة
`call_asset`	`UnifiedCallAsset` مادة عرض مكالمات موحّدة
`call_to_action_asset`	`CallToActionAsset` مادة عرض عبارة تحث المستخدم على اتّخاذ إجراء
`location_asset`	`UnifiedLocationAsset` مادة عرض موقع جغرافي موحّدة

AssetGroup

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

الحقول
`resource_name`	`string` اسم المورد لمجموعة مواد العرض تكون أسماء موارد مجموعات مواد العرض على النحو التالي: `customers/{customer_id}/assetGroups/{asset_group_id}`
`id`	`int64` رقم تعريف مجموعة مواد العرض.
`campaign`	`string` الحملة المرتبطة بمجموعة مواد العرض هذه. مادة العرض المرتبطة بمجموعة مواد العرض
`name`	`string` مطلوب. اسم مجموعة مواد العرض. مطلوب. يجب ألا يقل طولها عن 1 حرف وألا يزيد عن 128 حرفًا. يجب أن يكون فريدًا ضمن حملة.
`final_urls[]`	`string` قائمة بعناوين URL النهائية بعد جميع عمليات إعادة التوجيه على جميع النطاقات في "حملات الأداء الأفضل"، تكون عناوين URL مؤهّلة للتوسّع تلقائيًا ما لم يتم إيقاف هذه الميزة.
`final_mobile_urls[]`	`string` قائمة بعناوين URL النهائية للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه عبر النطاقات. في "حملات الأداء الأفضل"، تكون عناوين URL مؤهّلة للتوسّع تلقائيًا ما لم يتم إيقاف هذه الميزة.
`status`	`AssetGroupStatus` حالة مجموعة مواد العرض.
`path1`	`string` الجزء الأول من النص الذي قد يظهر مرفقًا بعنوان URL المعروض في الإعلان.
`path2`	`string` الجزء الثاني من النص الذي قد يظهر مرفقًا بعنوان URL المعروض في الإعلان. يمكن ضبط هذا الحقل فقط عند ضبط path1.
`ad_strength`	`AdStrength` قوة الإعلان الإجمالية لمجموعة مواد العرض هذه.

AssetGroupAsset

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

الحقول
`resource_name`	`string` اسم مصدر مادة عرض مجموعة مواد العرض. يكون اسم المورد لمواد العرض في مجموعة مواد العرض على النحو التالي: `customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}`
`asset_group`	`string` مجموعة مواد العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه.
`asset`	`string` مادة العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه.
`field_type`	`AssetFieldType` وصف لموضع مادة العرض ضمن مجموعة مواد العرض. على سبيل المثال: HEADLINE وYOUTUBE_VIDEO وما إلى ذلك
`status`	`AssetLinkStatus` حالة الرابط بين مادة عرض ومجموعة مواد عرض

AssetGroupAssetCombinationData

بيانات تركيبات مواد عرض مجموعة مواد العرض

الحقول

الحقول
`asset_combination_served_assets[]`	`AssetUsage` مواد العرض المعروضة

asset_combination_served_assets[]

AssetUsage

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

AssetGroupListingGroupFilter

تمثّل AssetGroupListingGroupFilter عُقدة شجرة فلاتر لمجموعة بيانات في مجموعة مواد عرض.

الحقول
`resource_name`	`string` اسم المرجع لفلترة مجموعة بيانات مجموعة مواد العرض يكون اسم مورد فلتر مجموعة بيانات مجموعة مواد العرض على النحو التالي: `customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}`
`asset_group`	`string` مجموعة مواد العرض التي يُعدّ فلتر مجموعة بيانات مجموعة مواد العرض هذا جزءًا منها.
`id`	`int64` رقم تعريف ListingGroupFilter
`type`	`ListingGroupFilterType` نوع عقدة فلتر مجموعة البيانات
`vertical`	`ListingGroupFilterVertical` القطاع الذي تمثّله شجرة العقدة الحالية يجب أن تنتمي جميع العُقد في الشجرة نفسها إلى موضع الإعلان نفسه.
`case_value`	`ListingGroupFilterDimension` قيمة السمة التي تعمل مجموعة البيانات هذه على تحسين العنصر الرئيسي بها. غير محدّد للمجموعة الجذر.
`parent_listing_group_filter`	`string` اسم المورد للقسم الفرعي من مجموعة البيانات الرئيسية. قيمة فارغة في عقدة فلتر مجموعة البيانات الجذر.
`path`	`ListingGroupFilterDimensionPath` مسار السمات التي تحدّد فلتر مجموعة البيانات هذا.

AssetGroupSignal

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

الحقول
`resource_name`	`string` اسم مصدر إشارة مجموعة مواد العرض. يكون اسم مورد إشارة مجموعة مواد العرض على النحو التالي: `customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}`
`asset_group`	`string` مجموعة مواد العرض التي تنتمي إليها إشارة مجموعة مواد العرض هذه.
حقل الاتحاد `signal`. إشارة مجموعة مواد العرض. يمكن أن يكون `signal` واحدًا فقط مما يلي:
`audience`	`AudienceInfo` إشارة الجمهور التي ستستخدمها "حملة الأداء الأفضل".

AssetGroupTopCombinationView

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

الحقول

الحقول
`resource_name`	`string` اسم المورد لعرض أفضل تركيبة لمجموعة مواد العرض. ويكون أسماء موارد عرض النسخة الأفضل في AssetGroup على النحو التالي: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
`asset_group_top_combinations[]`	`AssetGroupAssetCombinationData` أهم مجموعات مواد العرض التي تم عرضها معًا

resource_name

string

اسم المورد لعرض أفضل تركيبة لمجموعة مواد العرض. ويكون أسماء موارد عرض النسخة الأفضل في AssetGroup على النحو التالي: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

asset_group_top_combinations[]

AssetGroupAssetCombinationData

أهم مجموعات مواد العرض التي تم عرضها معًا

AssetSet

مجموعة مواد عرض تمثّل مجموعة من مواد العرض استخدِم AssetSetAsset لربط مادة عرض بمجموعة مواد العرض.

الحقول

الحقول
`id`	`int64` رقم تعريف مجموعة مواد العرض.
`resource_name`	`string` اسم مورد مجموعة مواد العرض. تكون أسماء موارد مجموعة مواد العرض على النحو التالي: `customers/{customer_id}/assetSets/{asset_set_id}`

id

int64

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

resource_name

string

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

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

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

الحقول
`resource_name`	`string` اسم مصدر مادة عرض مجموعة مواد العرض يكون لأسماء موارد مواد عرض مجموعة مواد العرض التنسيق التالي: `customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}`
`asset_set`	`string` مجموعة مواد العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه.
`asset`	`string` مادة العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه.
`status`	`AssetSetAssetStatus` حالة مادة عرض مجموعة مواد العرض للقراءة فقط.

الجمهور

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

الحقول
`resource_name`	`string` اسم مورد شريحة الجمهور. تكون أسماء شرائح الجمهور على النحو التالي: `customers/{customer_id}/audiences/{audience_id}`
`id`	`int64` رقم تعريف شريحة الجمهور
`name`	`string` مطلوب. اسم الجمهور يجب أن يكون فريدًا في جميع شرائح الجمهور. يجب ألا يقلّ طولها عن 1 حرف وألا يزيد عن 255 حرفًا.
`description`	`string` وصف هذا الجمهور

BiddingStrategy

استراتيجية عروض أسعار

الحقول
`resource_name`	`string` اسم المورد لاستراتيجية عروض الأسعار. تكون أسماء موارد استراتيجية عروض الأسعار على النحو التالي: `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}`
`status`	`BiddingStrategyStatus` حالة استراتيجية عروض الأسعار. هذا الحقل للقراءة فقط.
`type`	`BiddingStrategyType` نوع استراتيجية عروض الأسعار. إنشاء استراتيجية عروض أسعار من خلال ضبط نظام عروض الأسعار. هذا الحقل للقراءة فقط.
`currency_code`	`string` العملة المستخدَمة في استراتيجية عروض الأسعار (رمز مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217) بالنسبة إلى استراتيجيات عروض الأسعار في حسابات العملاء المدراء، يمكن ضبط هذه العملة عند الإنشاء، وتكون القيمة التلقائية لها هي عملة حساب العميل الإداري. بالنسبة إلى العملاء الذين يعرضون الإعلانات، لا يمكن ضبط هذا الحقل، لأنّ جميع الاستراتيجيات في العميل الذي يعرض الإعلانات تستخدم ضمنيًا عملة العميل الذي يعرض الإعلانات. في جميع الحالات، يعرض الحقل effective_currency_code العملة المستخدَمة في الاستراتيجية.
`id`	`int64` رقم تعريف استراتيجية عروض الأسعار.
`name`	`string` اسم استراتيجية عروض الأسعار. يجب تسمية جميع استراتيجيات عروض الأسعار ضمن حساب بشكل فريد. يجب أن يتراوح طول هذه السلسلة من 1 إلى 255، بما في ذلك القيم، وبترميز UTF-8 بايت (مقصوص).
`effective_currency_code`	`string` العملة المستخدَمة في استراتيجية عروض الأسعار (الرمز المكوَّن من ثلاثة أحرف وفقًا لمعيار ISO 4217). بالنسبة إلى استراتيجيات عروض الأسعار في العملاء الإداريين، تكون هذه هي العملة التي يحدّدها المعلِن عند إنشاء الاستراتيجية. بالنسبة إلى العملاء، يكون هذا الرمز هو currency_code للعميل. يتم تسجيل مقاييس استراتيجية عروض الأسعار بهذه العملة. هذا الحقل للقراءة فقط.
`campaign_count`	`int64` عدد الحملات المرفقة باستراتيجية عروض الأسعار هذه. هذا الحقل للقراءة فقط.
`non_removed_campaign_count`	`int64` عدد الحملات غير المُزالة المرفقة باستراتيجية عروض الأسعار هذه. هذا الحقل للقراءة فقط.
حقل الربط `scheme` مخطّط عروض الأسعار يمكن ضبط سمة واحدة فقط. يمكن أن يكون `scheme` واحدًا فقط مما يلي:
`enhanced_cpc`	`EnhancedCpc` استراتيجية عروض أسعار ترفع عروض الأسعار للنقرات التي يزداد احتمال أن تؤدي إلى إحالة ناجحة وتخفضها للنقرات التي يقل فيها احتمال حدوثها.
`maximize_conversion_value`	`MaximizeConversionValue` استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر قيمة للإحالات الناجحة لحملاتك في حدود ميزانيتك.
`maximize_conversions`	`MaximizeConversions` استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة لحملاتك في حدود ميزانيتك.
`target_cpa`	`TargetCpa` استراتيجية عروض أسعار تحدّد عروض الأسعار للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة وفقًا للتكلفة المستهدَفة للاكتساب التي تحدّدها.
`target_impression_share`	`TargetImpressionShare` استراتيجية عروض أسعار يتم تحسينها تلقائيًا لزيادة نسبة محدّدة من مرات الظهور.
`target_outrank_share`	`TargetOutrankShare` استراتيجية عروض أسعار تحدّد عروض الأسعار استنادًا إلى الجزء المستهدَف من المزادات التي من المفترض أن يتفوّق فيها المعلِن على منافس معيّن. تم إيقاف العمل بهذا الحقل. لن يتمكّن إنشاء استراتيجية عروض أسعار جديدة باستخدام هذا الحقل أو إرفاق استراتيجيات عروض أسعار تتضمّن هذا الحقل بحملة. يُسمح بإجراء عمليات تحويل إلى الاستراتيجيات التي تمّت تعبئة هذا المخطّط فيها.
`target_roas`	`TargetRoas` استراتيجية عروض أسعار تساعدك في زيادة الأرباح إلى أقصى حدّ مع احتساب متوسّط عائد إنفاق إعلاني مستهدَف محدّد.
`target_spend`	`TargetSpend` استراتيجية عروض أسعار تحدِّد عروض أسعارك لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.

الحملة

حملة.

الحقول
`resource_name`	`string` اسم مورد الحملة. تكون أسماء موارد الحملات على النحو التالي: `customers/{customer_id}/campaigns/{campaign_id}`
`status`	`CampaignStatus` حالة الحملة. عند إضافة حملة جديدة، تكون الحالة التلقائية "مفعّلة".
`serving_status`	`CampaignServingStatus` حالة عرض الإعلانات للحملة.
`bidding_strategy_system_status`	`BiddingStrategySystemStatus` حالة النظام لاستراتيجية عروض أسعار الحملة.
`ad_serving_optimization_status`	`AdServingOptimizationStatus` حالة تحسين عرض الإعلانات للحملة.
`advertising_channel_type`	`AdvertisingChannelType` استهداف العرض الأساسي للإعلانات ضمن الحملة. يمكن تحسين خيارات الاستهداف في `network_settings`. هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء حملات جديدة. لا يمكن ضبطها إلا عند إنشاء الحملات. بعد إنشاء الحملة، لا يمكن تغيير الحقل.
`advertising_channel_sub_type`	`AdvertisingChannelSubType` تصفية اختيارية لـ `advertising_channel_type` يجب أن يكون نوعًا فرعيًا صالحًا لنوع القناة الرئيسي. لا يمكن ضبطها إلا عند إنشاء الحملات. بعد إنشاء الحملة، لا يمكن تغيير الحقل.
`url_custom_parameters[]`	`CustomParameter` قائمة عمليات الربط المستخدَمة لاستبدال علامات المَعلمات المخصّصة في `tracking_url_template` أو `final_urls` أو `mobile_final_urls`
`real_time_bidding_setting`	`RealTimeBiddingSetting` إعدادات عروض الأسعار في الوقت الفعلي، وهي ميزة لا تتوفّر إلا للحملات التي تستهدِف شبكة Ad Exchange.
`network_settings`	`NetworkSettings` إعدادات الشبكة للحملة.
`dynamic_search_ads_setting`	`DynamicSearchAdsSetting` الإعداد للتحكّم في الإعلانات الديناميكية على شبكة البحث
`shopping_setting`	`ShoppingSetting` الإعداد للتحكّم في "حملات Shopping"
`geo_target_type_setting`	`GeoTargetTypeSetting` إعداد الاستهداف الجغرافي للإعلانات
`effective_labels[]`	`string` أسماء موارد التصنيفات الفعالة المرفقة بهذه الحملة. التصنيف الفعّال هو تصنيف مكتسب أو تم تعيينه لهذه الحملة مباشرةً.
`labels[]`	`string` أسماء مصادر التصنيفات المرفقة بهذه الحملة.
`bidding_strategy_type`	`BiddingStrategyType` نوع استراتيجية عروض الأسعار. يمكن إنشاء استراتيجية عروض أسعار من خلال ضبط نظام عروض الأسعار لإنشاء استراتيجية عروض أسعار عادية أو حقل `bidding_strategy` لإنشاء استراتيجية محفظة لعروض الأسعار. هذا الحقل للقراءة فقط.
`accessible_bidding_strategy`	`string` اسم المورد لـ AccessibleBiddingStrategy، وهي طريقة عرض للقراءة فقط للسمات غير المقيّدة لاستراتيجية المحفظة لعروض الأسعار المرفقة التي تم تحديدها من خلال bidding_strategy. فارغ، إذا كانت الحملة لا تستخدم استراتيجية محفظة تتوفّر سمات الاستراتيجيات غير المحظورة لجميع العملاء الذين تتم مشاركة الاستراتيجية معهم، ويمكن الاطّلاع عليها في مرجع AccessibleBudgetStrategy. في المقابل، لا تتوفّر السمات المحظورة إلا لمالك الاستراتيجية ومدراءه. لا يمكن قراءة السمات المحظورة إلا من مورد BiddingStrategy.
`frequency_caps[]`	`FrequencyCapEntry` قائمة تحدّ من عدد مرّات ظهور إعلانات هذه الحملة لكلّ مستخدِم
`selective_optimization`	`SelectiveOptimization` إعداد التحسين الانتقائي لهذه الحملة، والذي يتضمّن مجموعة من إجراءات الإحالات الناجحة لتحسين هذه الحملة من أجلها لا تنطبق هذه الميزة إلّا على حملات التطبيقات التي تستخدِم MULTI_CHANNEL كنوع AdvertisingChannelType وAPP_CAMPAIGN أو APP_CAMPAIGN_FOR_ENGAGEMENT كنوع AdvertisingChannelSubType.
`optimization_goal_setting`	`OptimizationGoalSetting` إعداد هدف التحسين لهذه الحملة، والذي يتضمّن مجموعة من أنواع أهداف التحسين
`tracking_setting`	`TrackingSetting` إعدادات معلومات التتبُّع على مستوى الحملة.
`engine_id`	`string` رقم تعريف الحملة في حساب محرّك البحث الخارجي هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo! Japan وMicrosoft وBaidu وما إلى ذلك. بالنسبة إلى الكيانات في "إعلانات Google"، استخدِم "campaign.id" بدلاً من ذلك.
`excluded_parent_asset_field_types[]`	`AssetFieldType` أنواع حقول مواد العرض التي يجب استبعادها من هذه الحملة. لن تكتسب هذه الحملة من المستوى الأعلى روابط مواد العرض التي تحتوي على أنواع الحقول هذه.
`create_time`	`string` الطابع الزمني لوقت إنشاء هذه الحملة. يتم عرض الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل. سيتم إيقاف create_time نهائيًا في الإصدار 1. استخدِم creation_time بدلاً من ذلك.
`creation_time`	`string` الطابع الزمني لوقت إنشاء هذه الحملة. يكون الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل.
`last_modified_time`	`string` التاريخ والوقت اللذان تمّ فيهما إجراء آخر تعديل على هذه الحملة. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
`id`	`int64` رقم تعريف الحملة.
`name`	`string` اسم الحملة. هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء حملات جديدة. يجب ألا يحتوي على أي أحرف فارغة (قيمة موضع الرمز 0x0) أو فواصل أسطر (قيمة موضع الرمز 0xA) أو علامات رجوع إلى أول السطر (قيمة موضع الرمز 0xD).
`tracking_url_template`	`string` نموذج عنوان URL لإنشاء عنوان URL للتتبّع
`campaign_budget`	`string` اسم المورد لميزانية الحملة.
`start_date`	`string` تاريخ بدء عرض الحملة في المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD
`end_date`	`string` اليوم الأخير من الحملة في عرض المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD. عند الإنشاء، يكون الإعداد التلقائي هو ‎30-12-2037، ما يعني أنّ الحملة ستستمر إلى أجل غير مسمى. لضبط حملة حالية على عرض الإعلانات إلى أجل غير مسمى، اضبط هذا الحقل على ‎30-12-2037.
`final_url_suffix`	`string` اللاحقة المستخدَمة لإلحاق مَعلمات طلبات البحث بالصفحات المقصودة التي يتم عرضها باستخدام التتبّع الموازي
`url_expansion_opt_out`	`bool` يمثّل ذلك إيقاف توسيع عنوان URL ليشمل عناوين URL أكثر استهدافًا. في حال إيقاف هذه الميزة (صحيح)، يتم استهداف عناوين URL النهائية فقط في مجموعة مواد العرض أو عناوين URL المحدّدة في خلاصات Google Merchant Center أو خلاصات بيانات النشاط الإعلاني للمعلِن. في حال تفعيل الميزة (خطأ)، سيتم استهداف النطاق بأكمله. لا يمكن ضبط هذا الحقل إلّا في "حملات الأداء الأفضل"، حيث تكون القيمة التلقائية هي false.
حقل الربط `campaign_bidding_strategy` استراتيجية عروض الأسعار للحملة. يجب أن تكون إما محفظة (تم إنشاؤها من خلال خدمة "استراتيجية عروض الأسعار") أو محفظة عادية مضمّنة في الحملة. يمكن أن يكون `campaign_bidding_strategy` واحدًا فقط مما يلي:
`bidding_strategy`	`string` اسم مصدر استراتيجية عروض أسعار المحفظة المستخدَمة من قِبل الحملة.
`manual_cpa`	`ManualCpa` استراتيجية عروض الأسعار اليدوية العادية للتكلفة المستهدَفة للإجراء استراتيجية عروض الأسعار اليدوية التي تسمح للمعلِن بتحديد عرض السعر لكل إجراء يحدده المعلِن. لا تتوفّر هذه الميزة إلا لحملات "الخدمات المحلّية".
`manual_cpc`	`ManualCpc` استراتيجية عروض أسعار تكلفة النقرة اليدوية العادية عروض الأسعار اليدوية المستندة إلى النقرات التي يدفع فيها المستخدِم لكل نقرة
`manual_cpm`	`ManualCpm` استراتيجية عروض الأسعار اليدوية العادية استنادًا إلى التكلفة لكلّ ألف ظهور عرض أسعار يدوي يستند إلى مرات الظهور، حيث يدفع المستخدم مقابل كل ألف ظهور.
`maximize_conversions`	`MaximizeConversions` استراتيجية عروض أسعار "تحقيق الحد الأقصى من الإحالات الناجحة" العادية تعمل تلقائيًا على زيادة عدد الإحالات الناجحة إلى أقصى حد في حدود ميزانيتك.
`maximize_conversion_value`	`MaximizeConversionValue` استراتيجية عروض أسعار عادية لتحقيق الحد الأقصى من قيمة الإحالات الناجحة تعمل على ضبط عروض الأسعار تلقائيًا لتحقيق الحد الأقصى من الأرباح في حدود ميزانيتك.
`target_cpa`	`TargetCpa` استراتيجية عروض أسعار "التكلفة المستهدَفة للإجراء" العادية التي تحدّد عروض الأسعار تلقائيًا لمساعدتك في الحصول على أكبر عدد ممكن من الإحالات الناجحة بتكلفة الإجراء المستهدَفة التي تحدّدها.
`target_impression_share`	`TargetImpressionShare` استراتيجية عروض أسعار نسبة ظهور الإعلان المستهدَفة استراتيجية عروض أسعار مبرمَجة تحدِّد عروض الأسعار لتحقيق نسبة مئوية محدّدة من مرّات الظهور.
`target_roas`	`TargetRoas` استراتيجية عروض أسعار عادية تستند إلى عائد الإنفاق الإعلاني المستهدَف، وهي تحقّق الحد الأقصى من الأرباح تلقائيًا مع احتساب متوسط عائد إنفاق إعلاني مستهدَف محدّد.
`target_spend`	`TargetSpend` استراتيجية عروض أسعار الإنفاق المستهدَف العادية التي تحدّد عروض أسعارك تلقائيًا لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.
`percent_cpc`	`PercentCpc` استراتيجية عروض الأسعار العادية للنسبة المئوية لتكلفة النقرة، حيث تكون عروض الأسعار جزءًا من السعر المُعلَن عنه لبعض السلع أو الخدمات.
`target_cpm`	`TargetCpm` استراتيجية عروض أسعار تعمل تلقائيًا على تحسين التكلفة لكل ألف مرّة ظهور.

DynamicSearchAdsSetting

الإعداد للتحكّم في الإعلانات الديناميكية على شبكة البحث

الحقول

الحقول
`domain_name`	`string` مطلوب. اسم نطاق الإنترنت الذي يمثّله هذا الإعداد، على سبيل المثال، "google.com" أو "www.google.com".
`language_code`	`string` مطلوب. رمز اللغة الذي يحدّد لغة النطاق، على سبيل المثال، "en".
`use_supplied_urls_only`	`bool` ما إذا كانت الحملة تستخدِم عناوين URL التي يقدّمها المعلِن حصريًا

domain_name

string

مطلوب. اسم نطاق الإنترنت الذي يمثّله هذا الإعداد، على سبيل المثال، "google.com" أو "www.google.com".

language_code

string

مطلوب. رمز اللغة الذي يحدّد لغة النطاق، على سبيل المثال، "en".

use_supplied_urls_only

bool

ما إذا كانت الحملة تستخدِم عناوين URL التي يقدّمها المعلِن حصريًا

GeoTargetTypeSetting

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

الحقول

الحقول
`positive_geo_target_type`	`PositiveGeoTargetType` الإعداد المستخدَم للاستهداف الجغرافي الإيجابي في هذه الحملة المحدّدة.
`negative_geo_target_type`	`NegativeGeoTargetType` الإعداد المستخدَم للاستهداف الجغرافي السلبي في هذه الحملة المحدّدة.

positive_geo_target_type

PositiveGeoTargetType

الإعداد المستخدَم للاستهداف الجغرافي الإيجابي في هذه الحملة المحدّدة.

negative_geo_target_type

NegativeGeoTargetType

الإعداد المستخدَم للاستهداف الجغرافي السلبي في هذه الحملة المحدّدة.

NetworkSettings

إعدادات الشبكة للحملة.

الحقول
`target_google_search`	`bool` ما إذا كان سيتم عرض الإعلانات مع نتائج البحث في google.ae أم لا.
`target_search_network`	`bool` ما إذا كان سيتم عرض الإعلانات على المواقع الإلكترونية للشركاء في "شبكة بحث Google" (يتطلب ذلك ضبط `target_google_search` على `true` أيضًا)
`target_content_network`	`bool` ما إذا كان سيتم عرض الإعلانات في مواضع محددة في شبكة Google الإعلانية. يتم تحديد مواضع الإعلانات باستخدام معيار "موضع الإعلان".
`target_partner_search_network`	`bool` ما إذا كان سيتم عرض الإعلانات على شبكة شركاء Google أم لا. لا يتوفّر هذا الخيار إلا لبعض حسابات شركاء Google المحدّدة.

OptimizationGoalSetting

إعداد هدف التحسين لهذه الحملة، والذي يتضمّن مجموعة من أنواع أهداف التحسين

الحقول

الحقول
`optimization_goal_types[]`	`OptimizationGoalType` قائمة أنواع أهداف التحسين.

optimization_goal_types[]

OptimizationGoalType

قائمة أنواع أهداف التحسين.

SelectiveOptimization

إعداد التحسين الانتقائي لهذه الحملة، والذي يتضمّن مجموعة من إجراءات الإحالات الناجحة لتحسين هذه الحملة من أجلها لا تنطبق هذه الميزة إلا على حملات التطبيقات التي تستخدم MULTI_CHANNEL على أنّها AdvertisingChannelType وAPP_CAMPAIGN أو APP_CAMPAIGN_FOR_ENGAGEMENT بصفتها AdvertisingChannelSubType.

الحقول

الحقول
`conversion_actions[]`	`string` المجموعة المحدّدة من أسماء الموارد لإجراءات الإحالات الناجحة لتحسين هذه الحملة.

conversion_actions[]

string

المجموعة المحدّدة من أسماء الموارد لإجراءات الإحالات الناجحة لتحسين هذه الحملة.

ShoppingSetting

إعداد حملات Shopping. يحدِّد نطاق المنتجات التي يمكن للحملة الإعلان عنها، وكيفية تفاعل هذه الحملة مع "حملات Shopping" الأخرى.

الحقول
`feed_label`	`string` تصنيف الخلاصة للمنتجات المطلوب تضمينها في الحملة لا يمكن ضبط سوى حقل واحد من حقلَي feed_label أو sales_country. إذا تمّ استخدامه بدلاً من sales_country، سيقبل الحقل feed_label رموز البلدان بالتنسيق نفسه، مثل "XX". ويمكن أيضًا أن يكون أي سلسلة مستخدَمة لتصنيف الخلاصة في Google Merchant Center.
`use_vehicle_inventory`	`bool` ما إذا كان سيتم استهداف مستودع بيانات المركبات
`merchant_id`	`int64` رقم تعريف حساب Merchant Center هذا الحقل مطلوب لعمليات الإنشاء. هذا الحقل غير قابل للتغيير في "حملات Shopping".
`sales_country`	`string` بلد بيع المنتجات المطلوب تضمينها في الحملة.
`campaign_priority`	`int32` أولوية الحملة. تكون الحملات ذات الأولويات الأعلى رقميًا لها الأولوية على الحملات ذات الأولويات الأقل. هذا الحقل مطلوب لـ "حملات Shopping"، وتكون قيمه بين 0 و2، بما في ذلك. هذا الحقل اختياري في "حملات Shopping الذكية"، ولكن يجب أن يكون مساويًا لـ 3 في حال ضبطه.
`enable_local`	`bool` تحديد ما إذا كان سيتم تضمين المنتجات المحلية.

TrackingSetting

الإعدادات على مستوى الحملة لمعلومات التتبّع

الحقول

الحقول
`tracking_url`	`string` عنوان URL المستخدَم للتتبّع الديناميكي.

tracking_url

string

عنوان URL المستخدَم للتتبّع الديناميكي.

CampaignAsset

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

الحقول
`resource_name`	`string` اسم مصدر مادة عرض الحملة. يكون لأسماء موارد CampaignAsset الشكل التالي: `customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}`
`status`	`AssetLinkStatus` حالة مادة عرض الحملة
`campaign`	`string` الحملة المرتبطة بمادة العرض.
`asset`	`string` مادة العرض المرتبطة بالحملة.

CampaignAssetSet

CampaignAssetSet هو الرابط بين حملة ومجموعة مواد عرض. تؤدي إضافة CampaignAssetSet إلى ربط مجموعة مواد عرض بحملة.

الحقول
`resource_name`	`string` اسم مصدر مجموعة مواد عرض الحملة. يكون لأسماء موارد مواد عرض مجموعة مواد العرض التنسيق التالي: `customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}`
`campaign`	`string` الحملة المرتبطة بهذه المجموعة من مواد العرض.
`asset_set`	`string` مجموعة مواد العرض المرتبطة بالحملة
`status`	`AssetSetLinkStatus` حالة مادة عرض مجموعة مواد عرض الحملة. للقراءة فقط.

CampaignAudienceView

طريقة عرض جمهور الحملة يتضمّن بيانات الأداء من الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على "الشبكة الإعلانية" و"شبكة YouTube"، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث (RLSA)، ويتم تجميعها حسب معيار الحملة والجمهور. لا يتضمّن هذا العرض سوى شرائح الجمهور المرتبطة على مستوى الحملة.

الحقول

الحقول
`resource_name`	`string` اسم المورد لطريقة عرض الجمهور للحملة. تكون أسماء موارد عرض الجمهور للحملة على النحو التالي: `customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}`

resource_name

string

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

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

ميزانية حملة

الحقول
`resource_name`	`string` اسم المورد لميزانية الحملة تكون أسماء موارد ميزانية الحملة على النحو التالي: `customers/{customer_id}/campaignBudgets/{campaign_budget_id}`
`delivery_method`	`BudgetDeliveryMethod` طريقة العرض التي تحدّد معدّل إنفاق ميزانية الحملة يتم ضبط القيمة تلقائيًا على STANDARD في حال عدم تحديدها في عملية إنشاء.
`period`	`BudgetPeriod` الفترة التي يتم خلالها إنفاق الميزانية. إعداد القيمة التلقائية على "يومي" إذا لم يتم تحديده.
`amount_micros`	`int64` مبلغ الميزانية بالعملة المحلية للحساب. يتم تحديد المبلغ بالوحدات الميكرو، حيث يعادل مليون وحدة واحدة من العملة. ويبلغ الحد الأقصى للإنفاق الشهري 30.4 ضِعف هذا المبلغ.

CampaignCriterion

معيار حملة

الحقول
`resource_name`	`string` اسم المورد لمعيار الحملة. تكون أسماء موارد معايير الحملة على النحو التالي: `customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}`
`display_name`	`string` الاسم المعروض للمعيار يتم تجاهل هذا الحقل في عمليات التعديل.
`type`	`CriterionType` نوع المعيار
`status`	`CampaignCriterionStatus` حالة المعيار
`last_modified_time`	`string` التاريخ والوقت اللذان تمّ فيهما إجراء آخر تعديل على معيار الحملة هذا. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
`criterion_id`	`int64` رقم تعريف المعيار. يتم تجاهل هذا الحقل أثناء إجراء عملية التحويل.
`bid_modifier`	`float` المُعدِّل لعروض الأسعار عند تطابق المعيار يجب أن يكون المُعدِّل في النطاق: 0.1 - 10.0. تتوافق معظم أنواع المعايير القابلة للاستهداف مع المعدِّلات. استخدِم القيمة 0 لإيقاف نوع جهاز.
`negative`	`bool` لتحديد ما إذا كنت تريد استهداف (`false`) أو استبعاد (`true`) المعيار.
حقل الربط `criterion` معيار الحملة. يجب تحديد قيمة واحدة فقط. يمكن أن يكون `criterion` واحدًا فقط مما يلي:
`keyword`	`KeywordInfo` الكلمة الرئيسية.
`location`	`LocationInfo` الموقع الجغرافي.
`device`	`DeviceInfo` الجهاز.
`age_range`	`AgeRangeInfo` الفئة العمرية
`gender`	`GenderInfo` الجنس
`user_list`	`UserListInfo` قائمة المستخدمين
`language`	`LanguageInfo` اللغة
`webpage`	`WebpageInfo` صفحة ويب.
`location_group`	`LocationGroupInfo` مجموعة المواقع الجغرافية

CampaignEffectiveLabel

تمثّل هذه السمة علاقة بين حملة وعلامة فعّالة. التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لهذه الحملة.

الحقول
`resource_name`	`string` اسم المورد تكون أسماء موارد CampaignEffectivelabel على النحو التالي: `customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}`
`campaign`	`string` الحملة التي تم إرفاق التصنيف الفعّال بها.
`label`	`string` التصنيف الفعّال الذي تمّ تعيينه للحملة.
`owner_customer_id`	`int64` رقم تعريف العميل الذي يملك التصنيف الفعّال.

CampaignLabel

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

الحقول
`resource_name`	`string` اسم المورد تكون أسماء مصادر تصنيفات الحملات على النحو التالي: `customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}`
`campaign`	`string` الحملة التي تم إرفاق التصنيف بها.
`label`	`string` التصنيف الذي تمّ تعيينه للحملة.
`owner_customer_id`	`int64` معرّف العميل الذي يملك التصنيف.

CartDataSalesView

عرض مبيعات بيانات سلة التسوّق

الحقول

resource_name

string

اسم المورد لعرض مبيعات بيانات سلة التسوّق. تكون أسماء الموارد لعرض مبيعات بيانات سلة التسوّق على النحو التالي: customers/{customer_id}/cartDataSalesView

الإحالة الناجحة

إحالة ناجحة.

الحقول
`resource_name`	`string` اسم مورد الإحالة الناجحة. تكون أسماء مصادر الإحالات الناجحة على النحو التالي: `customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}`
`id`	`int64` رقم تعريف الإحالة الناجحة
`criterion_id`	`int64` رقم تعريف معيار "إعلانات شبكة البحث 360". تشير القيمة 0 إلى أنّ المعيار لم يتم تحديد مصدره.
`merchant_id`	`int64` رقم تعريف حساب المستودع في "إعلانات شبكة البحث 360" الذي يحتوي على المنتج الذي تم النقر عليه. تُنشئ "إعلانات شبكة البحث 360" هذا المعرّف عند ربط حساب مستودع في "إعلانات شبكة البحث 360".
`ad_id`	`int64` رقم تعريف الإعلان تشير القيمة 0 إلى أنّ الإعلان غير منسَب.
`click_id`	`string` سلسلة فريدة للزيارة التي تُنسَب إليها الإحالة الناجحة، ويتم تمريرها إلى الصفحة المقصودة كمَعلمة عنوان URL لمعرّف النقرة.
`visit_id`	`int64` رقم تعريف الزيارة في "إعلانات شبكة البحث 360" الذي تمّ تحديد مصدر الإحالة الناجحة على أنّه مصدره.
`advertiser_conversion_id`	`string` بالنسبة إلى الإحالات الناجحة بلا إنترنت، يكون هذا المعرّف مقدَّمًا من المعلِنين. إذا لم يحدّد المعلِن رقم تعريف مثل هذا، تُنشئ "إعلانات شبكة البحث 360" رقمًا تعريفيًا. بالنسبة إلى الإحالات الناجحة على الإنترنت، يكون هذا العمود مساويًا لعمود id أو عمود floodlight_order_id استنادًا إلى تعليمات Floodlight للمعلِن.
`product_id`	`string` معرّف المنتج الذي تم النقر عليه.
`product_channel`	`ProductChannel` قناة بيع المنتج الذي تم النقر عليه: على الإنترنت أو محلي.
`product_language_code`	`string` اللغة (ISO-639-1) التي تم ضبطها لخلاصة Merchant Center التي تحتوي على بيانات عن المنتج.
`product_store_id`	`string` المتجر في "الإعلان للمنتجات داخل المتجر" الذي تم النقر عليه. ويجب أن يتطابق مع أرقام تعريف المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلية.
`product_country_code`	`string` البلد (بتنسيق ISO-3166) المسجَّل لخلاصة المستودع التي تحتوي على المنتج الذي تم النقر عليه.
`attribution_type`	`AttributionType` المصدر الذي تُنسَب إليه الإحالة الناجحة: زيارة أو كلمة رئيسية + إعلان
`conversion_date_time`	`string` الطابع الزمني لحدث الإحالة الناجحة.
`conversion_last_modified_date_time`	`string` الطابع الزمني لآخر مرة تم فيها تعديل الإحالة الناجحة
`conversion_visit_date_time`	`string` الطابع الزمني للزيارة التي تمّ تحديد مصدر الإحالة الناجحة إليها.
`conversion_quantity`	`int64` عدد السلع التي سجّلتها الإحالة الناجحة، كما تحدّده مَعلمة عنوان URL qty. يتحمّل المعلِن مسؤولية تعبئة المَعلمة ديناميكيًا (مثل عدد السلع المُباعة في الإحالة الناجحة)، وإلا سيتم ضبطها تلقائيًا على 1.
`conversion_revenue_micros`	`int64` الأرباح المعدَّلة بالميكرو لحدث الإحالة الناجحة. وسيكون دائمًا بعملة حساب عرض الإعلانات.
`floodlight_original_revenue`	`int64` الأرباح الأصلية غير المتغيّرة المرتبطة بحدث Floodlight (بالعملة المحدّدة في التقرير الحالي)، قبل إجراء تعديلات على إعدادات عملة Floodlight
`floodlight_order_id`	`string` رقم تعريف طلب Floodlight الذي يقدّمه المعلِن للإحالة الناجحة
`status`	`ConversionStatus` حالة الإحالة الناجحة، إما "مُفعّلة" أو "تمت الإزالة".
`asset_id`	`int64` رقم تعريف مادة العرض التي تم التفاعل معها أثناء حدث الإحالة الناجحة.
`asset_field_type`	`AssetFieldType` نوع حقل مادة العرض لحدث الإحالة الناجحة

ConversionAction

إجراء إحالة ناجحة

الحقول
`resource_name`	`string` اسم مورد إجراء الإحالة الناجحة. تكون أسماء موارد إجراء الإحالة الناجحة على النحو التالي: `customers/{customer_id}/conversionActions/{conversion_action_id}`
`creation_time`	`string` الطابع الزمني لإنشاء نشاط Floodlight، بتنسيق ISO 8601
`status`	`ConversionActionStatus` حالة إجراء الإحالة الناجحة هذا لتجميع أحداث الإحالات الناجحة.
`type`	`ConversionActionType` نوع إجراء الإحالة الناجحة هذا.
`category`	`ConversionActionCategory` فئة الإحالات الناجحة التي تم الإبلاغ عنها لإجراء الإحالة الناجحة هذا.
`value_settings`	`ValueSettings` الإعدادات ذات الصلة بقيمة أحداث الإحالات الناجحة المرتبطة بهذا الإجراء
`attribution_model_settings`	`AttributionModelSettings` الإعدادات المرتبطة بنموذج تحديد المصدر لإجراء الإحالة الناجحة هذا.
`floodlight_settings`	`FloodlightSettings` إعدادات Floodlight لأنواع الإحالات الناجحة في Floodlight
`id`	`int64` رقم تعريف إجراء الإحالة الناجحة.
`name`	`string` اسم إجراء الإحالة الناجحة. هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء إجراءات إحالات ناجحة جديدة.
`primary_for_goal`	`bool` إذا كان العنصر primary_for_goal للإجراء الإحالة الناجحة غير صحيح، لا يمكن تقديم عروض أسعار للإجراء الإحالة الناجحة في جميع الحملات بغض النظر عن هدف الإحالة الناجحة للعميل أو هدف الإحالة الناجحة للحملة. ومع ذلك، لا تراعي أهداف الإحالات الناجحة المخصّصة السمة primary_for_goal، لذا إذا كانت الحملة تتضمّن هدف إحالة ناجحة مخصّصًا تم ضبطه باستخدام إجراء إحالة ناجحة primary_for_goal = false، سيظلّ بإمكانك تقديم عروض أسعار لهذا الإجراء. ستكون primary_for_goal صحيحة تلقائيًا في حال عدم ضبطها. في الإصدار V9، لا يمكن ضبطPrimary_for_goal إلا بعد إنشائها من خلال عملية "تحديث" لأنّها لم يتم تعريفها على أنّها اختيارية.
`owner_customer`	`string` اسم المورد لعميل مالك إجراء الإحالة الناجحة، أو قيمة خالية إذا كان هذا إجراء إحالة ناجحة من تحديد النظام.
`include_in_client_account_conversions_metric`	`bool` ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في مقياس "client_account_conversions".
`include_in_conversions_metric`	`bool` ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في مقياس "الإحالات الناجحة".
`click_through_lookback_window_days`	`int64` الحدّ الأقصى لعدد الأيام التي قد تمضي بين تفاعل (مثل نقرة) وحدث إحالة ناجحة.
`app_id`	`string` رقم تعريف التطبيق لإجراء إحالة ناجحة للتطبيق

AttributionModelSettings

الإعدادات ذات الصلة بنموذج تحديد المصدر لإجراء الإحالة الناجحة هذا

الحقول

attribution_model

AttributionModel

نوع نموذج تحديد المصدر لإجراء الإحالة الناجحة هذا.

data_driven_model_status

DataDrivenModelStatus

حالة نموذج تحديد المصدر بالاستناد إلى البيانات للإجراء الإحالة الناجحة.

FloodlightSettings

الإعدادات المرتبطة بإجراء إحالة ناجحة في Floodlight

الحقول

activity_group_tag

string

سلسلة تُستخدَم لتحديد مجموعة أنشطة Floodlight عند إعداد تقارير الإحالات الناجحة.

activity_tag

string

سلسلة تُستخدَم لتحديد نشاط Floodlight عند إعداد تقارير عن الإحالات الناجحة

activity_id

int64

رقم تعريف نشاط Floodlight في DoubleClick Campaign Manager (DCM)

ValueSettings

الإعدادات ذات الصلة بقيمة أحداث الإحالات الناجحة المرتبطة بهذا الإجراء

الحقول

default_value

double

القيمة التي سيتم استخدامها عند إرسال أحداث الإحالات الناجحة لهذا الإجراء باستخدام قيمة غير صالحة أو غير مسموح بها أو غير متوفّرة، أو عند ضبط هذا الإجراء لاستخدام القيمة التلقائية دائمًا.

default_currency_code

string

رمز العملة المراد استخدامه عند إرسال أحداث الإحالات الناجحة لهذا الإجراء مع رمز عملة غير صالح أو غير متوفّر، أو عند ضبط هذا الإجراء لاستخدام القيمة التلقائية دائمًا.

always_use_default_value

bool

يتحكّم هذا الخيار في ما إذا كان سيتم استخدام القيمة التلقائية ورمز العملة التلقائي بدلاً من القيمة ورمز العملة المحدّدَين في أحداث الإحالات الناجحة لهذا الإجراء.

ConversionCustomVariable

متغيّر مخصّص للإحالة الناجحة اطّلِع على "لمحة عن مقاييس Floodlight وسماته المخصّصة في التجربة الجديدة من "إعلانات شبكة البحث 360" على الرابط https://support.google.com/sa360/answer/13567857.

الحقول
`resource_name`	`string` اسم المورد للمتغيّر المخصّص للإحالة الناجحة. وتكون أسماء موارد المتغيّرات المخصّصة للإحالات الناجحة على النحو التالي: `customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}`
`id`	`int64` رقم تعريف المتغيّر المخصّص للإحالة الناجحة.
`name`	`string` مطلوب. اسم المتغيّر المخصّص للإحالة الناجحة. يجب أن يكون الاسم فريدًا. يمكن أن يتضمّن الاسم 100 حرف كحد أقصى. يجب عدم ترك أي مسافات إضافية قبل الاسم وبعده.
`tag`	`string` مطلوب. علامة المتغيّر المخصّص للإحالة الناجحة. يجب أن تكون العلامة فريدة وأن تتكون من حرف "u" متبوعًا برقم أقل من ormequal إلى 100. على سبيل المثال: "u4".
`status`	`ConversionCustomVariableStatus` حالة المتغيّر المخصّص للإحالة الناجحة لتجميع أحداث الإحالات الناجحة.
`owner_customer`	`string` اسم مورد العميل الذي يملك المتغيّر المخصّص للإحالة الناجحة.
`family`	`ConversionCustomVariableFamily` عائلة المتغيّر المخصّص للإحالة الناجحة.
`cardinality`	`ConversionCustomVariableCardinality` عدد القيم الفريدة للمتغيّر المخصّص للإحالة الناجحة.
`floodlight_conversion_custom_variable_info`	`FloodlightConversionCustomVariableInfo` حقول للمتغيّرات المخصّصة للإحالات الناجحة في Floodlight في "إعلانات شبكة البحث 360"
`custom_column_ids[]`	`int64` أرقام تعريف الأعمدة المخصّصة التي تستخدِم هذا المتغيّر المخصّص للإحالة الناجحة.

FloodlightConversionCustomVariableInfo

معلومات عن المتغيّرات المخصّصة للإحالات الناجحة في Floodlight في "إعلانات شبكة البحث 360"

الحقول

floodlight_variable_type

FloodlightVariableType

نوع متغيّر Floodlight المحدَّد في "إعلانات شبكة البحث 360".

floodlight_variable_data_type

FloodlightVariableDataType

نوع بيانات متغيّر Floodlight المحدّد في "إعلانات شبكة البحث 360"

ConversionTrackingSetting

مجموعة من الإعدادات على مستوى العميل ذات الصلة بتتبُّع الإحالات الناجحة في "إعلانات شبكة البحث 360".

الحقول
`accepted_customer_data_terms`	`bool` ما إذا كان العميل قد قبل بنود بيانات العملاء أم لا. وفي حال استخدام تتبُّع الإحالات الناجحة في جميع الحسابات، يتم اكتساب هذه القيمة من الحساب الإداري. هذا الحقل للقراءة فقط. لمزيد من المعلومات، يُرجى الاطّلاع على https://support.google.com/adspolicy/answer/7475709.
`conversion_tracking_status`	`ConversionTrackingStatus` حالة تتبُّع الإحالات الناجحة ويشير ذلك إلى ما إذا كان العميل يستخدم ميزة تتبُّع الإحالات الناجحة، وإلى مالك ميزة تتبُّع الإحالات الناجحة لهذا العميل. إذا كان هذا العميل يستخدم ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، ستختلف القيمة المعروضة استنادًا إلى `login-customer-id` الطلب.
`enhanced_conversions_for_leads_enabled`	`bool` ما إذا كان العميل قد فعّل ميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين" في حال استخدام ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، يتم اكتساب هذه القيمة من الحساب الإداري. هذا الحقل للقراءة فقط.
`google_ads_conversion_customer`	`string` اسم المورد للعميل الذي يتم إنشاء الإحالات الناجحة وإدارتها فيه هذا الحقل للقراءة فقط.
`conversion_tracking_id`	`int64` رقم تعريف تتبُّع الإحالة الناجحة المستخدَم لهذا الحساب. لا يشير رقم التعريف هذا إلى ما إذا كان العميل يستخدم ميزة تتبُّع الإحالات الناجحة (يشير مقياس conversion_tracking_status إلى ذلك). هذا الحقل للقراءة فقط.
`google_ads_cross_account_conversion_tracking_id`	`int64` رقم تعريف تتبُّع الإحالة الناجحة الخاص بمدير العميل. يتمّ ضبط هذا المَعلمة عند تفعيل ميزة تتبُّع الإحالات الناجحة للعملاء، وتتجاهل مَعلمة conversion_tracking_id. لا يمكن إدارة هذا الحقل إلا من خلال واجهة مستخدم "إعلانات Google". هذا الحقل للقراءة فقط.
`cross_account_conversion_tracking_id`	`int64` رقم تعريف تتبُّع الإحالة الناجحة الخاص بمدير العميل. يتمّ ضبط هذا المَعلمة عندما يفعّل العميل ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، وتتجاهل مَعلمة conversion_tracking_id.

CustomColumn

عمود مخصّص اطّلِع على العمود المخصّص في "إعلانات شبكة البحث 360" على الرابط https://support.google.com/sa360/answer/9633916.

الحقول
`resource_name`	`string` اسم المورد للعمود المخصّص. تكون أسماء موارد الأعمدة المخصّصة على النحو التالي: `customers/{customer_id}/customColumns/{custom_column_id}`
`id`	`int64` رقم تعريف العمود المخصّص.
`name`	`string` اسم العمود المخصّص الذي حدّده المستخدم
`description`	`string` وصف من تحديد المستخدِم للعمود المخصّص
`value_type`	`CustomColumnValueType` نوع قيمة النتيجة للعمود المخصّص.
`references_attributes`	`bool` صحيح عندما يشير العمود المخصّص إلى سمة واحدة أو أكثر
`references_metrics`	`bool` صحيح عندما يشير العمود المخصّص إلى مقياس واحد أو أكثر.
`queryable`	`bool` صحيح عندما يكون العمود المخصّص متاحًا لاستخدامه في طلب البحث SearchAds360Service.Search وSearchAds360Service.SearchStream.
`referenced_system_columns[]`	`string` قائمة أعمدة النظام المُشار إليها في هذا العمود المخصّص على سبيل المثال، أشار العمود المخصّص "مجموع مرّات الظهور والنقرات" إلى أعمدة النظام {"metrics.clicks", "metrics.impressions"}.
`render_type`	`CustomColumnRenderType` كيفية تفسير قيمة النتيجة للعمود المخصّص

العميل

عميل

الحقول
`resource_name`	`string` اسم مورد العميل تكون أسماء موارد العملاء على النحو التالي: `customers/{customer_id}`
`conversion_tracking_setting`	`ConversionTrackingSetting` إعداد تتبُّع الإحالات الناجحة لعميل.
`account_type`	`AccountType` نوع حساب محرّك البحث، على سبيل المثال، "إعلانات Google" وMicrosoft Advertising وYahoo Japan وBaidu وFacebook و"حساب تتبُّع محرّكات البحث" وما إلى ذلك
`double_click_campaign_manager_setting`	`DoubleClickCampaignManagerSetting` إعداد DoubleClick Campaign Manager (DCM) لعميل الحساب الإداري.
`account_status`	`AccountStatus` حالة الحساب، على سبيل المثال، مفعَّلة أو متوقفة مؤقتًا أو تمت إزالتها أو غير ذلك
`last_modified_time`	`string` التاريخ والوقت اللذان تمّ فيهما إجراء آخر تعديل على هذا العميل يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
`engine_id`	`string` رقم تعريف الحساب في حساب المحرّك الخارجي
`status`	`CustomerStatus` حالة العميل.
`creation_time`	`string` الطابع الزمني لوقت إنشاء هذا العميل. يظهر الطابع الزمني في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss".
`id`	`int64` رقم تعريف العميل.
`descriptive_name`	`string` اسم وصفي اختياري وغير فريد للعميل.
`currency_code`	`string` العملة التي يعمل بها الحساب. تتوفّر مجموعة فرعية من رموز العملات وفقًا لمعيار ISO 4217.
`time_zone`	`string` رقم تعريف المنطقة الزمنية المحلية للعميل.
`tracking_url_template`	`string` نموذج عنوان URL لإنشاء عنوان URL للتتبّع من المَعلمات
`final_url_suffix`	`string` نموذج عنوان URL لإلحاق المَعلمات بعنوان URL النهائي
`auto_tagging_enabled`	`bool` ما إذا كان وضع العلامات التلقائي مفعّلاً للعميل
`manager`	`bool` ما إذا كان العميل مديرًا.

CustomerAsset

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

الحقول

resource_name

string

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

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

asset

string

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

status

AssetLinkStatus

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

CustomerAssetSet

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

الحقول
`resource_name`	`string` اسم المورد لمجموعة مواد عرض العميل يكون لأسماء موارد مواد عرض مجموعة مواد العرض التنسيق التالي: `customers/{customer_id}/customerAssetSets/{asset_set_id}`
`asset_set`	`string` مجموعة مواد العرض المرتبطة بالعميل
`customer`	`string` العميل المرتبط بمجموعة مواد العرض هذه.
`status`	`AssetSetLinkStatus` حالة مادة عرض مجموعة مواد عرض العملاء للقراءة فقط.

CustomerClient

رابط بين العميل المحدّد والعميل لا تتوفّر ميزة "العملاء" إلا للعملاء الإداريين. يتم تضمين جميع عملاء العملاء المباشرين وغير المباشرين، بالإضافة إلى الحساب الإداري نفسه.

الحقول
`resource_name`	`string` اسم مورد عميل العميل. تكون أسماء موارد CustomerClient على النحو التالي: `customers/{customer_id}/customerClients/{client_customer_id}`
`applied_labels[]`	`string` أسماء موارد التصنيفات التي يملكها العميل الذي أرسل الطلب والتي يتم تطبيقها على العميل العميل. تكون أسماء موارد التصنيف على النحو التالي: `customers/{customer_id}/labels/{label_id}`
`status`	`CustomerStatus` حالة العميل. للقراءة فقط.
`client_customer`	`string` اسم مورد العميل المرتبط بالعميل المحدّد. للقراءة فقط.
`hidden`	`bool` تُحدِّد ما إذا كان هذا حسابًا مخفيًا. للقراءة فقط.
`level`	`int64` المسافة بين العميل والعميل المحدد. بالنسبة إلى الرابط الذاتي، ستكون قيمة المستوى 0. للقراءة فقط.
`time_zone`	`string` تمثيل سلسلة Common Locale Data Repository (CLDR) للمنطقة الزمنية للعميل، على سبيل المثال، America/Los_Angeles للقراءة فقط.
`test_account`	`bool` يحدّد ما إذا كان العميل حسابًا تجريبيًا. للقراءة فقط.
`manager`	`bool` لتحديد ما إذا كان العميل مديرًا. للقراءة فقط.
`descriptive_name`	`string` اسم وصفي للعميل للقراءة فقط.
`currency_code`	`string` رمز العملة (على سبيل المثال، "USD" أو "EUR") للعميل. للقراءة فقط.
`id`	`int64` رقم تعريف العميل. للقراءة فقط.

CustomerManagerLink

يمثّل علاقة الربط بين العميل والمدير.

الحقول
`resource_name`	`string` اسم المورد تحتوي أسماء مراجع CustomerManagerLink على النموذج التالي: `customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}`
`status`	`ManagerLinkStatus` حالة الربط بين العميل والمدير.
`manager_customer`	`string` العميل الإداري المرتبط بالعميل
`manager_link_id`	`int64` رقم تعريف رابط العميل بالحساب الإداري هذا الحقل للقراءة فقط.
`start_time`	`string` الطابع الزمني لوقت إنشاء CustomerManagerLink يكون الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل.

DoubleClickCampaignManagerSetting

إعداد DoubleClick Campaign Manager (DCM) لعميل الحساب الإداري.

الحقول

advertiser_id

int64

رقم تعريف المعلِن على "مدير الحملة" المرتبط بهذا العميل.

network_id

int64

رقم تعريف شبكة "مدير الحملة" المرتبطة بهذا العميل.

time_zone

string

المنطقة الزمنية لشبكة "مدير الحملة" المرتبطة بهذا العميل بتنسيق قاعدة بيانات المنطقة الزمنية IANA، مثل America/New_York.

DynamicSearchAdsSearchTermView

عرض عبارات البحث للإعلانات الديناميكية على شبكة البحث

الحقول

resource_name

string

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

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landing_page

string

عنوان URL للصفحة المقصودة المحدّد ديناميكيًا للظهور.

هذا الحقل للقراءة فقط.

GenderView

عرض حسب الجنس يعكس مورد age_view حالة العرض الفعّالة، بدلاً من المعايير التي تمت إضافتها. تظهر المجموعة الإعلانية التي لا تتضمّن معايير الجنس تلقائيًا لجميع الأجناس، وبالتالي تظهر جميع الأجناس فيgender_view مع إحصاءات.

الحقول

resource_name

string

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

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

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

الحقول
`resource_name`	`string` اسم المورد الخاص بمتغيّر الاستهداف الجغرافي الثابت تكون أسماء الموارد الثابتة للموقع الجغرافي المستهدَف على النحو التالي: `geoTargetConstants/{geo_target_constant_id}`
`status`	`GeoTargetConstantStatus` حالة ثابت الاستهداف الجغرافي
`id`	`int64` رقم تعريف ثابت الاستهداف الجغرافي.
`name`	`string` الاسم الإنجليزي لقيَم الاستهداف الجغرافي الثابتة
`country_code`	`string` رمز البلد وفقًا لمعيار ISO-3166-1 alpha-2 والمرتبط بالهدف.
`target_type`	`string` نوع الاستهداف الثابت في الاستهداف الجغرافي.
`canonical_name`	`string` الاسم الإنجليزي المؤهَّل بالكامل، ويتألّف من اسم الهدف واسم الشركة الرئيسية والبلد
`parent_geo_target`	`string` اسم المورد الثابت المستهدف الجغرافي الأصلي. تكون أسماء الموارد الثابتة للموقع الجغرافي المستهدَف على النحو التالي: `geoTargetConstants/{parent_geo_target_constant_id}`

KeywordView

عرض الكلمات الرئيسية

الحقول

resource_name

string

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

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

التصنيف

تصنيف

الحقول
`resource_name`	`string` اسم المورد. يكون لأسماء موارد التصنيف التنسيق التالي: `customers/{customer_id}/labels/{label_id}`
`status`	`LabelStatus` حالة التصنيف. للقراءة فقط.
`text_label`	`TextLabel` نوع من التصنيفات يعرض نصًا على خلفية ملونة.
`id`	`int64` رقم تعريف التصنيف للقراءة فقط.
`name`	`string` اسم التصنيف هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء تصنيف جديد. يجب أن يتراوح طول هذه السلسلة بين 1 و80 حرفًا.

LanguageConstant

لغة

الحقول
`resource_name`	`string` اسم المورد لسمة اللغة الثابتة. وتكون أسماء الموارد الثابتة للغة على النحو التالي: `languageConstants/{criterion_id}`
`id`	`int64` معرّف ثابت اللغة.
`code`	`string` رمز اللغة، مثل "en_US" و"en_AU" و"es" و"fr" وما إلى ذلك.
`name`	`string` الاسم الكامل للّغة باللغة الإنجليزية، على سبيل المثال، "الإنجليزية (الولايات المتحدة)" أو "الإسبانية" أو غير ذلك
`targetable`	`bool` ما إذا كانت اللغة قابلة للاستهداف

ListingGroupFilterDimension

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

الحقول
حقل الربط `dimension` تكون سمة من أحد الأنواع أدناه متوفّرة دائمًا. يمكن أن يكون `dimension` واحدًا فقط مما يلي:
`product_bidding_category`	`ProductBiddingCategory` فئة عروض الأسعار لعرض منتج.
`product_brand`	`ProductBrand` العلامة التجارية لعرض منتج معيّن
`product_channel`	`ProductChannel` الموقع الجغرافي لعرض المنتج
`product_condition`	`ProductCondition` تمثّل هذه السمة حالة عرض المنتج.
`product_custom_attribute`	`ProductCustomAttribute` سمة مخصّصة لعرض منتج
`product_item_id`	`ProductItemId` معرّف السلعة لعرض منتج
`product_type`	`ProductType` نوع عرض المنتج

ProductBiddingCategory

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

الحقول

level

ListingGroupFilterBiddingCategoryLevel

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

id

int64

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

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

ProductBrand

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

الحقول

value

string

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

ProductChannel

الموقع الجغرافي لعرض المنتج

الحقول

channel

ListingGroupFilterProductChannel

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

ProductCondition

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

الحقول

condition

ListingGroupFilterProductCondition

قيمة الشرط

ProductCustomAttribute

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

الحقول

index

ListingGroupFilterCustomAttributeIndex

يشير إلى فهرس السمة المخصّصة.

value

string

قيمة سلسلة لسمة المنتج المخصّصة

ProductItemId

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

الحقول

value

string

قيمة المعرّف

ProductType

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

الحقول

level

ListingGroupFilterProductTypeLevel

مستوى النوع.

value

string

قيمة النوع

ListingGroupFilterDimensionPath

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

الحقول

dimensions[]

ListingGroupFilterDimension

المسار الكامل للأبعاد من خلال التسلسل الهرمي لفلترة مجموعة البيانات (باستثناء العقدة الجذر) إلى فلتر مجموعة البيانات هذا.

LocationView

تلخّص طريقة عرض المواقع الجغرافية أداء الحملات حسب معيار الموقع الجغرافي.

الحقول

resource_name

string

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

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

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

الحقول
`resource_name`	`string` اسم المورد لفئة عروض أسعار المنتج. يكون لأسماء موارد فئة عروض أسعار المنتجات التنسيق التالي: `productBiddingCategoryConstants/{country_code}~{level}~{id}`
`level`	`ProductBiddingCategoryLevel` مستوى فئة عروض أسعار المنتجات.
`status`	`ProductBiddingCategoryStatus` حالة فئة عروض أسعار المنتجات.
`id`	`int64` معرّف فئة عروض أسعار المنتجات. هذا المعرّف مكافئ لمعرّف google_product_category كما هو موضّح في هذه المقالة: https://support.google.com/merchants/answer/6324436.
`country_code`	`string` رمز البلد المكوّن من حرفَين كبيرَين لفئة عروض أسعار المنتجات.
`product_bidding_category_constant_parent`	`string` اسم المورد لفئة عروض أسعار المنتج الرئيسية.
`language_code`	`string` رمز اللغة لفئة عروض أسعار المنتجات.
`localized_name`	`string` عرض قيمة فئة عروض أسعار المنتج المترجَمة وفقًا لـ language_code

ProductGroupView

عرض مجموعة منتجات

الحقول

resource_name

string

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

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

حقل أو مورد (عنصر) يستخدمه SearchAds360Service

الحقول
`resource_name`	`string` اسم مورد العنصر تكون أسماء موارد العناصر على النحو التالي: `SearchAds360Fields/{name}`
`category`	`SearchAds360FieldCategory` فئة العنصر
`selectable_with[]`	`string` أسماء جميع الموارد والشرائح والمقاييس التي يمكن اختيارها باستخدام العنصر الموضَّح.
`attribute_resources[]`	`string` أسماء جميع الموارد التي يمكن اختيارها باستخدام العنصر الموضّح لا تؤدي الحقول من هذه الموارد إلى تقسيم المقاييس عند تضمينها في طلبات البحث. يتم ضبط هذا الحقل فقط للعناصر التي تكون فئتها هي "المورد".
`metrics[]`	`string` يسرد هذا الحقل أسماء جميع المقاييس التي يمكن اختيارها باستخدام العنصر الموضّح عند استخدامه في عبارة FROM. ولا يتم ضبطها إلا للعناصر التي تكون فئتها RESOURCE.
`segments[]`	`string` يسرد هذا الحقل أسماء جميع العناصر، سواء كانت شريحة أو موردًا آخر، التي تُقسّم المقاييس عند تضمينها في طلبات البحث وعند استخدام العنصر الموضّح في عبارة FROM. ولا يتم ضبطها إلا للعناصر التي تكون فئتها RESOURCE.
`enum_values[]`	`string` القيم التي يمكن أن يتّخذها العنصر إذا كان حقلًا من النوع ENUM لا يتم ضبط هذا الحقل إلا للعناصر من فئة SEGMENT أو ATTRIBUTE.
`data_type`	`SearchAds360FieldDataType` يحدِّد هذا الحقل عوامل التشغيل التي يمكن استخدامها مع العنصر في عبارات WHERE.
`name`	`string` اسم العنصر
`selectable`	`bool` ما إذا كان يمكن استخدام العنصر في عبارة SELECT في استعلامات البحث.
`filterable`	`bool` ما إذا كان يمكن استخدام العنصر في عبارة WHERE في طلبات البحث
`sortable`	`bool` ما إذا كان يمكن استخدام العنصر في عبارة ORDER BY في طلبات البحث
`type_url`	`string` عنوان URL لملف proto الذي يصف نوع بيانات العنصر
`is_repeated`	`bool` ما إذا كان عنصر الحقل متكرّرًا

ShoppingPerformanceView

عرض أداء "التسوّق على YouTube" يوفّر إحصاءات حملات Shopping مجمّعة على عدة مستويات لسمات المنتجات. إنّ قيم أبعاد المنتج من Merchant Center، مثل العلامة التجارية والفئة والسمات المخصّصة وحالة المنتج ونوع المنتج، ستُظهر حالة كل سمة بدءًا من التاريخ والوقت اللذين تمّ فيهما تسجيل الحدث المقابل.

الحقول

resource_name

string

اسم المورد لعرض أداء Shopping تكون أسماء المراجع لعرض أداء التسوّق على النحو التالي: customers/{customer_id}/shoppingPerformanceView

UserList

قائمة مستخدمين هذه قائمة بالمستخدمين الذين يمكن أن يستهدفهم العميل.

الحقول
`resource_name`	`string` اسم المورد لقائمة المستخدمين يكون لأسماء موارد قائمة المستخدمين الشكل التالي: `customers/{customer_id}/userLists/{user_list_id}`
`type`	`UserListType` نوع هذه القائمة هذا الحقل للقراءة فقط.
`id`	`int64` رقم تعريف قائمة المستخدمين
`name`	`string` اسم قائمة المستخدمين هذه. استنادًا إلى access_reason، قد لا يكون اسم قائمة المستخدمين فريدًا (على سبيل المثال، إذا كان access_reason=SHARED).

UserLocationView

عرض الموقع الجغرافي للمستخدم

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

الحقول

resource_name

string

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

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

country_criterion_id

int64

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

targeting_location

bool

يشير إلى ما إذا كان الموقع الجغرافي مستهدفًا أم لا.

انتقال

زيارة.

الحقول
`resource_name`	`string` اسم المورد للزيارة. تكون أسماء مراجع الانتقال على النحو التالي: `customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}`
`id`	`int64` رقم تعريف الزيارة.
`criterion_id`	`int64` رقم تعريف الكلمة الرئيسية في "إعلانات شبكة البحث 360" وتشير القيمة 0 إلى أنّ الكلمة الرئيسية غير منسوبة.
`merchant_id`	`int64` رقم تعريف حساب المستودع في "إعلانات شبكة البحث 360" الذي يحتوي على المنتج الذي تم النقر عليه. تُنشئ "إعلانات شبكة البحث 360" هذا المعرّف عند ربط حساب مستودع في "إعلانات شبكة البحث 360".
`ad_id`	`int64` رقم تعريف الإعلان وتشير القيمة 0 إلى أنّ الإعلان لم يتمّ تحديد مصدره.
`click_id`	`string` سلسلة فريدة لكل زيارة يتم تمريرها إلى الصفحة المقصودة كمَعلمة عنوان URL الخاصة بمعرّف النقرة.
`visit_date_time`	`string` الطابع الزمني لحدث الزيارة يكون الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل.
`product_id`	`string` معرّف المنتج الذي تم النقر عليه.
`product_channel`	`ProductChannel` قناة بيع المنتج الذي تم النقر عليه: على الإنترنت أو محلي.
`product_language_code`	`string` اللغة (ISO-639-1) التي تم ضبطها لخلاصة Merchant Center التي تحتوي على بيانات عن المنتج.
`product_store_id`	`string` المتجر في "الإعلان للمنتجات داخل المتجر" الذي تم النقر عليه. ويجب أن يتطابق مع أرقام تعريف المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلية.
`product_country_code`	`string` البلد (بتنسيق ISO-3166) المسجَّل لخلاصة المستودع التي تحتوي على المنتج الذي تم النقر عليه.
`asset_id`	`int64` رقم تعريف مادة العرض التي تم التفاعل معها أثناء حدث الزيارة
`asset_field_type`	`AssetFieldType` نوع حقل مادة العرض لحدث الزيارة

WebpageView

عرض صفحة ويب

الحقول

resource_name

string

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

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}