Package google.ads.searchads360.v0.services

الفهرس

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_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

المعرّف الفريد للطلب الذي يُستخدَم لأغراض تصحيح الأخطاء.