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

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

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 في الاستجابة. القيمة التلقائية هي 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

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