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

הערך הוא True אם העמודה בהתאמה אישית מפנה למדדים.

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

השם שהמשתמש נתן למדד של אירוע הגולמי.

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

הלקוח שאליו מתייחסת השאילתה.

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

אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת.

return_total_results_count

bool

אם הערך הוא true, המספר הכולל של התוצאות שתואמות לשאילתה, בלי להתייחס לסעיף 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

‫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

המזהה הייחודי של הבקשה שמשמש למטרות ניפוי באגים.