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

خدمة لجلب حقول Search Ads 360 API.

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

مطلوب. معرّف العميل الذي سيتم تطبيق عملية قائمة CustomColumn عليه.

ListCustomColumnsResponse

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

الحقول
custom_columns[]

CustomColumn

أعمدة CustomColumns التي يملكها العميل المقدَّم.

RawEventConversionDimensionHeader

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

الحقول
id

int64

رقم تعريف المتغيّر المخصّص للإحالة الناجحة.

name

string

الاسم الذي حدّده المستخدِم لسمة الحدث الأوّلية

RawEventConversionMetricHeader

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

الحقول
id

int64

رقم تعريف المتغيّر المخصَّص للإحالة الناجحة.

name

string

الاسم الذي حدّده المستخدم لمقياس الحدث الأوّلي

صف SearchAds360

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

الحقول
ad_group

AdGroup

المجموعة الإعلانية المُشار إليها في الطلب

ad_group_ad

AdGroupAd

الإعلان المُشار إليه في طلب البحث

ad_group_ad_effective_label

AdGroupAdEffectiveLabel

التصنيف الفعال للإعلان في المجموعة الإعلانية المُشار إليه في الطلب

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_effective_label

AdGroupCriterionEffectiveLabel

التصنيف الفعّال لمعيار المجموعة الإعلانية المشار إليه في طلب البحث.

ad_group_criterion_label

AdGroupCriterionLabel

تصنيف معيار المجموعة الإعلانية المشار إليه في طلب البحث.

ad_group_effective_label

AdGroupEffectiveLabel

التصنيف الفعّال للمجموعة الإعلانية المشار إليه في طلب البحث.

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_effective_label

CampaignEffectiveLabel

التصنيف الفعال للحملة المُشار إليه في طلب البحث.

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

قائمة المستخدمين المشار إليها في طلب البحث.

user_location_view

UserLocationView

عرض الموقع الجغرافي للمستخدم المُشار إليه في طلب البحث

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

إذا كان صحيحًا، سيتم تضمين إجمالي عدد النتائج التي تتطابق مع طلب البحث مع تجاهل عبارة LIMIT في الاستجابة. القيمة التلقائية هي false.

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

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