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

הלקוח 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

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