Package google.ads.searchads360.v0.services

索引

• CustomColumnService (介面)
• CustomerService (介面)
• SearchAds360FieldService (介面)
• SearchAds360Service (介面)
• ConversionCustomDimensionHeader (訊息)
• ConversionCustomMetricHeader (訊息)
• CustomColumnHeader (訊息)
• GetCustomColumnRequest (訊息)
• GetSearchAds360FieldRequest (訊息)
• ListAccessibleCustomersRequest (訊息)
• ListAccessibleCustomersResponse (訊息)
• ListCustomColumnsRequest (訊息)
• ListCustomColumnsResponse (訊息)
• RawEventConversionDimensionHeader (訊息)
• RawEventConversionMetricHeader (訊息)
• SearchAds360Row (訊息)
• SearchSearchAds360FieldsRequest (訊息)
• SearchSearchAds360FieldsResponse (訊息)
• SearchSearchAds360Request (訊息)
• SearchSearchAds360Response (訊息)
• SearchSearchAds360StreamRequest (訊息)
• SearchSearchAds360StreamResponse (訊息)

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 轉換自訂維度 ID。
name	string 轉換自訂維度的使用者定義名稱。

ConversionCustomMetricHeader

轉換自訂指標標頭的訊息。

欄位
id	int64 轉換自訂指標 ID。
name	string 轉換自訂指標的使用者定義名稱。

CustomColumnHeader

自訂欄標頭的訊息。

欄位
id	int64 自訂欄 ID。
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 清單作業的客戶 ID。

ListCustomColumnsResponse

擷取與客戶相關聯的所有自訂欄的回應訊息。

欄位
custom_columns[]	CustomColumn 由提供的客戶擁有的自訂欄。

RawEventConversionDimensionHeader

原始事件轉換維度標頭訊息。

欄位
id	int64 轉換自訂變數 ID。
name	string 原始事件維度的使用者定義名稱。

RawEventConversionMetricHeader

原始事件轉換指標標頭訊息。

欄位
id	int64 轉換自訂變數 ID。
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_manager_link	CustomerManagerLink 查詢中參照的 CustomerManagerLink。
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 必要欄位。要查詢的客戶 ID。
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 必要欄位。要查詢的客戶 ID。
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 用於偵錯的專屬要求 ID。