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 ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/doubleclicksearch
SearchStream

rpc SearchStream(SearchSearchAds360StreamRequest) returns (SearchSearchAds360StreamResponse)

تعرض هذه الدالة جميع الصفوف التي تتطابق مع طلب البحث في "دفق البحث".

قائمة الأخطاء التي تم طرحها: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError 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

تمثّل هذه السمة الأعمدة المخصّصة التي يملكها العميل المحدّد.

RawEventConversionDimensionHeader

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

الحقول
id

int64

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

name

string

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

RawEventConversionMetricHeader

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

الحقول
id

int64

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

name

string

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

SearchAds360Row

صف تم إرجاعه من الاستعلام

الحقول
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 في الردّ. القيمة التلقائية هي "خطأ".

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

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

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

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