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

הערך יהיה 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

חובה. מזהה הלקוח שעליו יש להחיל את הפעולה של רשימת 'CustomColumn'.

ListCustomColumnsResponse

הודעת תגובה לאחזור כל העמודות המותאמות אישית שמשויכות ללקוח.

שדות
custom_columns[]

CustomColumn

העמודות המותאמות אישית בבעלות הלקוח שצוין.

RawEventConversionDimensionHeader

הודעה לגבי הכותרת של מאפיין ההמרה הגולמי של האירוע.

שדות
id

int64

המזהה של המשתנה המותאם אישית של ההמרה.

name

string

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

RawEventConversionMetricHeader

הודעה לגבי הכותרת של מדד ההמרות הגולמי של האירוע.

שדות
id

int64

המזהה של המשתנה המותאם אישית של ההמרה.

name

string

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

שורה של SearchAds360

שורה שהוחזרה מהשאילתה.

שדות
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

הלקוח של הלקוח שצוין בשאילתה.

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

אם הערך הוא 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

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