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

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

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

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