Package google.ads.searchads360.v0.services

الفهرس

• CustomColumnService (واجهة)
• CustomerService (واجهة)
• SearchAds360FieldService (واجهة)
• SearchAds360Service (واجهة)
• ConversionCustomDimensionHeader (رسالة)
• ConversionCustomMetricHeader (رسالة)
• CustomColumnHeader (رسالة)
• GetCustomColumnRequest (رسالة)
• GetSearchAds360FieldRequest (رسالة)
• ListAccessibleCustomersRequest (رسالة)
• ListAccessibleCustomersResponse (رسالة)
• ListCustomColumnsRequest (رسالة)
• ListCustomColumnsResponse (رسالة)
• RawEventConversionDimensionHeader (رسالة)
• RawEventConversionMetricHeader (رسالة)
• SearchAds360Row (رسالة)
• SearchSearchAds360FieldsRequest (رسالة)
• SearchSearchAds360FieldsResponse (رسالة)
• SearchSearchAds360Request (رسالة)
• SearchSearchAds360Response (رسالة)
• SearchSearchAds360StreamRequest (رسالة)
• SearchSearchAds360StreamResponse (رسالة)

CustomColumnService

خدمة لإدارة الأعمدة المخصّصة.

GetCustomColumn
rpc GetCustomColumn(GetCustomColumnRequest) returns (CustomColumn) تعرض العمود المخصّص المطلوب بالتفصيل. نطاقات التفويض يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/doubleclicksearch

ListCustomColumns
rpc ListCustomColumns(ListCustomColumnsRequest) returns (ListCustomColumnsResponse) عرض جميع الأعمدة المخصّصة المرتبطة بالعميل بالتفصيل. نطاقات التفويض يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/doubleclicksearch

CustomerService

خدمة لإدارة العملاء.

ListAccessibleCustomers

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) تعرض أسماء موارد العملاء التي يمكن الوصول إليها مباشرةً من خلال المستخدم الذي يصادق على المكالمة. قائمة الأخطاء الملموسة: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError نطاقات التفويض يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/doubleclicksearch

SearchAds360FieldService

خدمة لاسترجاع حقول واجهة برمجة التطبيقات لأداة "إعلانات شبكة البحث 360"

GetSearchAds360Field
rpc GetSearchAds360Field(GetSearchAds360FieldRequest) returns (SearchAds360Field) لا يتم عرض سوى الحقل المطلوب. قائمة الأخطاء الملموسة: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError نطاقات التفويض يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/doubleclicksearch

SearchSearchAds360Fields
rpc SearchSearchAds360Fields(SearchSearchAds360FieldsRequest) returns (SearchSearchAds360FieldsResponse) عرض جميع الحقول التي تطابق طلب البحث. قائمة بالأخطاء الناتجة: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError نطاقات التفويض يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/doubleclicksearch

SearchAds360Service

خدمة لاسترجاع البيانات والمقاييس على مستوى الموارد

بحث
rpc Search(SearchSearchAds360Request) returns (SearchSearchAds360Response) تعرض جميع الصفوف التي تطابق طلب البحث. قائمة بالأخطاء الناتجة: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError نطاقات التفويض يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/doubleclicksearch

SearchStream
rpc SearchStream(SearchSearchAds360StreamRequest) returns (SearchSearchAds360StreamResponse) تعرض جميع الصفوف التي تطابق طلب بحث مصدر البحث. قائمة بالأخطاء الناتجة: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError نطاقات التفويض يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/doubleclicksearch

ConversionCustomDimensionHeader

رسالة عنوان السمة المخصّصة للإحالة الناجحة.

الحقول
id	int64 رقم تعريف السمة المخصّصة للإحالة الناجحة.
name	string الاسم الذي حدّده المستخدم للسمة المخصّصة للإحالة الناجحة.

ConversionCustomMetricHeader

رسالة لعنوان المقياس المخصّص للإحالة الناجحة

الحقول
id	int64 رقم تعريف المقياس المخصّص للإحالة الناجحة
name	string الاسم الذي حدّده المستخدم للمقياس المخصّص للإحالة الناجحة.

CustomColumnHeader

رسالة لعنوان العمود المخصّص.

الحقول
id	int64 رقم تعريف العمود المخصّص.
name	string الاسم الذي حدّده المستخدم للعمود المخصّص.
references_metrics	bool صحيح عندما يشير العمود المخصّص إلى المقاييس.

GetCustomColumnRequest

اطلب رسالة بقيمة CustomColumnService.GetCustomColumn.

الحقول
resource_name	string مطلوبة. اسم مورد العمود المخصّص المطلوب استرجاعه

GetSearchAds360FieldRequest

اطلب رسالة بقيمة SearchAds360FieldService.GetSearchAds360Field.

الحقول
resource_name	string مطلوبة. اسم مورد الحقل الذي تريد الحصول عليه.

ListAccessibleCustomersRequest

لا يشتمل هذا النوع على أي حقول.

اطلب رسالة بقيمة CustomerService.ListAccessibleCustomers.

ListAccessibleCustomersResponse

رسالة الرد لـ "CustomerService.ListAccessibleCustomers".

الحقول
resource_names[]	string اسم المورد للعملاء الذين يمكن الوصول إليهم مباشرةً من خلال المستخدم الذي يصادق على المكالمة.

ListCustomColumnsRequest

طلب رسالة لمدة CustomColumnService.ListCustomColumns

الحقول
customer_id	string مطلوبة. رقم تعريف العميل المطلوب تطبيق عملية قائمة العمود المخصّص عليه.

ListCustomColumnsResponse

رسالة رد لجلب جميع الأعمدة المخصّصة المرتبطة بعميل.

الحقول
custom_columns[]	CustomColumn الأعمدة المخصّصة التي يملكها العميل المقدّم.

RawEventConversionDimensionHeader

رسالة لعنوان سمة الإحالة الناجحة للحدث الأولي.

الحقول
id	int64 رقم تعريف المتغيّر المخصَّص للإحالة الناجحة
name	string الاسم الذي حدّده المستخدم لسمة الحدث الأوليّ.

RawEventConversionMetricHeader

رسالة لعنوان مقياس الإحالة الناجحة للأحداث الأولية

الحقول
id	int64 رقم تعريف المتغيّر المخصَّص للإحالة الناجحة
name	string الاسم الذي حدّده المستخدم لمقياس الحدث الأولي.

صف إعلانات شبكة البحث 360

صف تم عرضه من الاستعلام.

الحقول
ad_group	AdGroup المجموعة الإعلانية المشار إليها في طلب البحث.
ad_group_ad	AdGroupAd الإعلان المشار إليه في طلب البحث.
ad_group_ad_label	AdGroupAdLabel تصنيف إعلان المجموعة الإعلانية المشار إليه في طلب البحث.
ad_group_asset	AdGroupAsset مادة عرض المجموعة الإعلانية المُشار إليها في طلب البحث.
ad_group_asset_set	AdGroupAssetSet مجموعة مواد عرض المجموعة الإعلانية المُشار إليها في طلب البحث.
ad_group_audience_view	AdGroupAudienceView طريقة عرض الجمهور على مستوى المجموعة الإعلانية المُشار إليها في طلب البحث.
ad_group_bid_modifier	AdGroupBidModifier معدِّل عروض الأسعار المشار إليه في طلب البحث.
ad_group_criterion	AdGroupCriterion المعيار المشار إليه في طلب البحث.
ad_group_criterion_label	AdGroupCriterionLabel تصنيف معيار المجموعة الإعلانية المشار إليه في طلب البحث.
ad_group_label	AdGroupLabel تصنيف المجموعة الإعلانية المشار إليه في طلب البحث.
age_range_view	AgeRangeView عرض الفئة العمرية المُشار إليها في طلب البحث.
asset	Asset مادة العرض المُشار إليها في طلب البحث.
asset_group_asset	AssetGroupAsset مادة عرض مجموعة مواد العرض المُشار إليها في طلب البحث.
asset_group_signal	AssetGroupSignal إشارة مجموعة مواد العرض المُشار إليها في طلب البحث.
asset_group_listing_group_filter	AssetGroupListingGroupFilter فلتر مجموعة البيانات في مجموعة مواد العرض المُشار إليها في طلب البحث.
asset_group_top_combination_view	AssetGroupTopCombinationView عرض مجموعة مواد العرض الأعلى في مجموعة مواد العرض المُشار إليها في طلب البحث
asset_group	AssetGroup مجموعة مواد العرض المُشار إليها في طلب البحث.
asset_set_asset	AssetSetAsset مادة عرض مجموعة مواد العرض المُشار إليها في طلب البحث.
asset_set	AssetSet مجموعة مواد العرض المُشار إليها في طلب البحث.
bidding_strategy	BiddingStrategy استراتيجية عروض الأسعار المشار إليها في طلب البحث.
campaign_budget	CampaignBudget ميزانية الحملة المشار إليها في طلب البحث.
campaign	Campaign الحملة المشار إليها في طلب البحث.
campaign_asset	CampaignAsset مادة عرض الحملة المُشار إليها في طلب البحث.
campaign_asset_set	CampaignAssetSet مجموعة مواد عرض الحملة المُشار إليها في طلب البحث.
campaign_audience_view	CampaignAudienceView مشاهدة جمهور الحملة المُشار إليها في طلب البحث.
campaign_criterion	CampaignCriterion معيار الحملة المشار إليه في طلب البحث.
campaign_label	CampaignLabel تصنيف الحملة المشار إليه في طلب البحث.
cart_data_sales_view	CartDataSalesView الملف الشخصي للمبيعات في بيانات سلة التسوّق المُشار إليه في طلب البحث.
audience	Audience الجمهور المشار إليه في طلب البحث.
conversion_action	ConversionAction إجراء الإحالة الناجحة المشار إليه في طلب البحث.
conversion_custom_variable	ConversionCustomVariable المتغيّر المخصَّص للإحالة الناجحة المشار إليه في طلب البحث.
customer	Customer العميل المشار إليه في الطلب.
customer_asset	CustomerAsset مادة عرض العميل المُشار إليها في طلب البحث.
customer_asset_set	CustomerAssetSet مجموعة مواد عرض العميل المُشار إليها في طلب البحث.
accessible_bidding_strategy	AccessibleBiddingStrategy استراتيجية عروض الأسعار التي يمكن الوصول إليها المُشار إليها في طلب البحث.
customer_manager_link	CustomerManagerLink CustomerManagerLink المشار إليه في طلب البحث.
customer_client	CustomerClient CustomerClient المشار إليه في الطلب.
dynamic_search_ads_search_term_view	DynamicSearchAdsSearchTermView عرض عبارة البحث للإعلانات الديناميكية على شبكة البحث المُشار إليها في طلب البحث.
gender_view	GenderView عرض الجنس المُشار إليه في طلب البحث.
geo_target_constant	GeoTargetConstant ثابت الهدف الجغرافي المُشار إليه في طلب البحث.
keyword_view	KeywordView عرض الكلمة الرئيسية المشار إليها في طلب البحث.
label	Label التصنيف المشار إليه في طلب البحث.
language_constant	LanguageConstant تمثّل هذه السمة الثابت اللغوي المُشار إليه في طلب البحث.
location_view	LocationView عرض الموقع الجغرافي المُشار إليه في طلب البحث.
product_bidding_category_constant	ProductBiddingCategoryConstant فئة عروض أسعار المنتج المُشار إليها في طلب البحث.
product_group_view	ProductGroupView عرض مجموعة المنتجات المشار إليها في طلب البحث.
shopping_performance_view	ShoppingPerformanceView عرض أداء التسوّق المُشار إليه في طلب البحث.
user_list	UserList قائمة المستخدمين المشار إليها في طلب البحث.
webpage_view	WebpageView عرض صفحة الويب المُشار إليه في طلب البحث.
visit	Visit الزيارة على مستوى الحدث المُشار إليها في طلب البحث.
conversion	Conversion الإحالة الناجحة على مستوى الحدث المُشار إليها في طلب البحث.
metrics	Metrics المقاييس
segments	Segments الشرائح
custom_columns[]	Value الأعمدة المخصّصة.

SearchSearchAds360FieldsRequest

اطلب رسالة بقيمة SearchAds360FieldService.SearchSearchAds360Fields.

الحقول
query	string مطلوبة. سلسلة طلب البحث
page_token	string الرمز المميّز للصفحة لاسترداده. في حال عدم تحديد أي خيار، سيتم عرض الصفحة الأولى من النتائج. استخدِم القيمة التي تم الحصول عليها من next_page_token في الردّ السابق لطلب الحصول على الصفحة التالية من النتائج.
page_size	int32 عدد العناصر المطلوب استردادها في صفحة واحدة. عندما يتم طلب صفحة كبيرة جدًا، قد يقرّر الخادم تقييد عدد الموارد التي يتم عرضها بشكل أكبر.

SearchSearchAds360FieldsResponse

رسالة الرد لـ "SearchAds360FieldService.SearchSearchAds360Fields".

الحقول
results[]	SearchAds360Field قائمة الحقول التي تطابق طلب البحث.
next_page_token	string الرمز المميّز لتقسيم النتائج على عدّة صفحات يُستخدم لاسترداد الصفحة التالية من النتائج. مرِّر محتوى هذه السلسلة كسمة page_token للطلب التالي. لا يتم عرض next_page_token للصفحة الأخيرة.
total_results_count	int64 إجمالي عدد النتائج التي تطابق طلب البحث مع تجاهل عبارة LIMIT.

SearchSearchAds360Request

اطلب رسالة بقيمة SearchAds360Service.Search.

الحقول
customer_id	string مطلوبة. رقم تعريف العميل الذي يجري الاستعلام عنه.
query	string مطلوبة. سلسلة طلب البحث
page_token	string الرمز المميّز للصفحة لاسترداده. في حال عدم تحديد أي خيار، سيتم عرض الصفحة الأولى من النتائج. استخدِم القيمة التي تم الحصول عليها من next_page_token في الردّ السابق لطلب الحصول على الصفحة التالية من النتائج.
page_size	int32 عدد العناصر المطلوب استردادها في صفحة واحدة. عندما يتم طلب صفحة كبيرة جدًا، قد يقرّر الخادم تقييد عدد الموارد التي يتم عرضها بشكل أكبر.
validate_only	bool إذا كانت الإجابة "صحيح"، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه.
return_total_results_count	bool إذا كانت true، فسيتم تضمين العدد الإجمالي للنتائج التي تطابق الاستعلام مع تجاهل عبارة LIMIT في الإجابة. والقيمة التلقائية هي "خطأ".
summary_row_setting	SummaryRowSetting تحدِّد هذه السياسة ما إذا كان سيتم عرض صف ملخّص. ولا يتم عرض صف الملخّص تلقائيًا. وإذا لزم الأمر، سيتم إرسال صف الملخص كاستجابة بمفرده بعد عرض جميع نتائج الاستعلام الأخرى.

SearchSearchAds360Response

رسالة الرد لـ "SearchAds360Service.Search".

الحقول
results[]	SearchAds360Row قائمة الصفوف التي تطابق طلب البحث.
next_page_token	string الرمز المميّز لتقسيم النتائج على عدّة صفحات يُستخدم لاسترداد الصفحة التالية من النتائج. مرِّر محتوى هذه السلسلة كسمة page_token للطلب التالي. لا يتم عرض next_page_token للصفحة الأخيرة.
total_results_count	int64 إجمالي عدد النتائج التي تطابق طلب البحث مع تجاهل عبارة LIMIT.
field_mask	FieldMask قناع الحقل الذي يمثل الحقول التي طلبها المستخدم.
summary_row	SearchAds360Row صف الملخص الذي يحتوي على ملخص المقاييس في النتائج يعني ملخص المقاييس تجميع المقاييس عبر جميع النتائج، ويمكن أن يكون التجميع هنا هو المجموع والمتوسط والمعدل وما إلى ذلك.
custom_column_headers[]	CustomColumnHeader عناوين الأعمدة المخصّصة في النتائج.
conversion_custom_metric_headers[]	ConversionCustomMetricHeader عناوين المقاييس المخصّصة للإحالة الناجحة في النتائج.
conversion_custom_dimension_headers[]	ConversionCustomDimensionHeader عناوين السمات المخصّصة للإحالة الناجحة في النتائج.
raw_event_conversion_metric_headers[]	RawEventConversionMetricHeader عناوين مقاييس الإحالات الناجحة الأولية للأحداث في النتائج.
raw_event_conversion_dimension_headers[]	RawEventConversionDimensionHeader عناوين سمات الإحالات الناجحة للأحداث الأولية في النتائج.

SearchSearchAds360StreamRequest

اطلب رسالة بقيمة SearchAds360Service.SearchStream.

الحقول
customer_id	string مطلوبة. رقم تعريف العميل الذي يجري الاستعلام عنه.
query	string مطلوبة. سلسلة طلب البحث
batch_size	int32 عدد الصفوف التي يتم عرضها في كل دفعة استجابة في ساحة المشاركات عندما يتم طلب دفعة كبيرة جدًا، قد يقرر الخادم تقييد عدد الصفوف التي يتم عرضها بشكل أكبر.
summary_row_setting	SummaryRowSetting تحدِّد هذه السياسة ما إذا كان سيتم عرض صف ملخّص. ولا يتم عرض صف الملخّص تلقائيًا. وإذا لزم الأمر، سيتم إرسال صف الملخص كاستجابة بمفرده بعد عرض جميع نتائج الاستعلام الأخرى.

SearchSearchAds360StreamResponse

رسالة الرد لـ "SearchAds360Service.SearchStream".

الحقول
results[]	SearchAds360Row قائمة الصفوف التي تطابق طلب البحث.
field_mask	FieldMask قناع الحقل الذي يمثل الحقول التي طلبها المستخدم.
summary_row	SearchAds360Row صف الملخص الذي يحتوي على ملخص المقاييس في النتائج يعني ملخص المقاييس تجميع المقاييس عبر جميع النتائج، ويمكن أن يكون التجميع هنا هو المجموع والمتوسط والمعدل وما إلى ذلك.
custom_column_headers[]	CustomColumnHeader عناوين الأعمدة المخصّصة في النتائج.
conversion_custom_metric_headers[]	ConversionCustomMetricHeader عناوين المقاييس المخصّصة للإحالة الناجحة في النتائج.
conversion_custom_dimension_headers[]	ConversionCustomDimensionHeader عناوين السمة المخصّصة للإحالة الناجحة في النتائج.
raw_event_conversion_metric_headers[]	RawEventConversionMetricHeader عناوين مقاييس الإحالات الناجحة الأولية للأحداث في النتائج.
raw_event_conversion_dimension_headers[]	RawEventConversionDimensionHeader عناوين سمات الإحالات الناجحة للأحداث الأولية في النتائج.
request_id	string المعرّف الفريد للطلب الذي يُستخدَم لأغراض تصحيح الأخطاء.