Package google.ads.searchads360.v0.services

Chỉ mục

CustomColumnService

Dịch vụ quản lý cột tuỳ chỉnh.

GetCustomColumn

rpc GetCustomColumn(GetCustomColumnRequest) returns (CustomColumn)

Trả về cột tuỳ chỉnh được yêu cầu một cách đầy đủ.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/doubleclicksearch
ListCustomColumns

rpc ListCustomColumns(ListCustomColumnsRequest) returns (ListCustomColumnsResponse)

Trả về tất cả các cột tuỳ chỉnh liên kết với khách hàng một cách chi tiết đầy đủ.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/doubleclicksearch

CustomerService

Dịch vụ quản lý khách hàng.

ListAccessibleCustomers

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse)

Trả về tên tài nguyên của khách hàng mà người dùng xác thực cuộc gọi có thể truy cập trực tiếp.

Danh sách lỗi được gửi: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/doubleclicksearch

SearchAds360FieldService

Dịch vụ để tìm nạp các trường API Search Ads 360.

GetSearchAds360Field

rpc GetSearchAds360Field(GetSearchAds360FieldRequest) returns (SearchAds360Field)

Chỉ trả về trường được yêu cầu.

Danh sách các lỗi được gửi: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/doubleclicksearch
SearchSearchAds360Fields

rpc SearchSearchAds360Fields(SearchSearchAds360FieldsRequest) returns (SearchSearchAds360FieldsResponse)

Trả về tất cả các trường khớp với cụm từ tìm kiếm.

Danh sách lỗi được gửi: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/doubleclicksearch

SearchAds360Service

Dịch vụ tìm nạp dữ liệu và chỉ số trong các tài nguyên.

Tìm kiếm

rpc Search(SearchSearchAds360Request) returns (SearchSearchAds360Response)

Trả về tất cả các hàng khớp với cụm từ tìm kiếm.

Danh sách lỗi được gửi: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/doubleclicksearch
SearchStream

rpc SearchStream(SearchSearchAds360StreamRequest) returns (SearchSearchAds360StreamResponse)

Trả về tất cả các hàng khớp với truy vấn luồng tìm kiếm.

Danh sách lỗi được gửi: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/doubleclicksearch

ConversionCustomDimensionHeader

Thông báo cho tiêu đề phương diện tuỳ chỉnh của lượt chuyển đổi.

Trường
id

int64

Mã phương diện tuỳ chỉnh của lượt chuyển đổi.
name

string

Tên do người dùng xác định của phương diện tuỳ chỉnh lượt chuyển đổi.

ConversionCustomMetricHeader

Thông báo cho tiêu đề chỉ số tuỳ chỉnh về lượt chuyển đổi.

Trường
id

int64

Mã chỉ số tuỳ chỉnh của lượt chuyển đổi.
name

string

Tên do người dùng xác định của chỉ số tuỳ chỉnh về lượt chuyển đổi.

CustomColumnHeader

Thông báo cho tiêu đề cột tuỳ chỉnh.

Trường
id

int64

Mã cột tuỳ chỉnh.
name

string

Tên do người dùng xác định của cột tuỳ chỉnh.
references_metrics

bool

Đúng khi cột tuỳ chỉnh tham chiếu đến các chỉ số.

GetCustomColumnRequest

Thông báo yêu cầu đối với CustomColumnService.GetCustomColumn.

Trường
resource_name

string

Bắt buộc. Tên tài nguyên của cột tuỳ chỉnh cần tìm nạp.

GetSearchAds360FieldRequest

Yêu cầu gửi tin nhắn cho SearchAds360FieldService.GetSearchAds360Field.

Trường
resource_name

string

Bắt buộc. Tên tài nguyên của trường cần lấy.

ListAccessibleCustomersRequest

Loại này không có trường nào.

Thông báo yêu cầu đối với CustomerService.ListAccessibleCustomers.

ListAccessibleCustomersResponse

Thông báo phản hồi cho CustomerService.ListAccessibleCustomers.

Trường
resource_names[]

string

Tên tài nguyên của khách hàng mà người dùng xác thực cuộc gọi có thể truy cập trực tiếp.

ListCustomColumnsRequest

Yêu cầu gửi tin nhắn cho CustomColumnService.ListCustomColumns

Trường
customer_id

string

Bắt buộc. Mã của khách hàng để áp dụng thao tác trong danh sách CustomColumn.

ListCustomColumnsResponse

Thông báo phản hồi để tìm nạp tất cả cột tuỳ chỉnh được liên kết với một khách hàng.

Trường
custom_columns[]

CustomColumn

CustomColumns thuộc quyền sở hữu của khách hàng được cung cấp.

RawEventConversionDimensionHeader

Thông báo cho tiêu đề phương diện lượt chuyển đổi sự kiện chưa qua xử lý.

Trường
id

int64

Mã biến tuỳ chỉnh của lượt chuyển đổi.
name

string

Tên do người dùng xác định của phương diện sự kiện thô.

RawEventConversionMetricHeader

Thông báo cho tiêu đề chỉ số lượt chuyển đổi sự kiện thô.

Trường
id

int64

Mã biến tuỳ chỉnh lượt chuyển đổi.
name

string

Tên do người dùng xác định của chỉ số sự kiện thô.

SearchAds360Row

Một hàng được trả về từ truy vấn.

Trường
ad_group

AdGroup

Nhóm quảng cáo được tham chiếu trong truy vấn.
ad_group_ad

AdGroupAd

Quảng cáo được tham chiếu trong truy vấn.
ad_group_ad_effective_label

AdGroupAdEffectiveLabel

Nhãn hiệu quả của quảng cáo trong nhóm quảng cáo được tham chiếu trong truy vấn.
ad_group_ad_label

AdGroupAdLabel

Nhãn quảng cáo của nhóm quảng cáo được tham chiếu trong truy vấn.
ad_group_asset

AdGroupAsset

Thành phần nhóm quảng cáo được tham chiếu trong truy vấn.
ad_group_asset_set

AdGroupAssetSet

Tập hợp thành phần nhóm quảng cáo được tham chiếu trong truy vấn.
ad_group_audience_view

AdGroupAudienceView

Chế độ xem đối tượng nhóm quảng cáo được tham chiếu trong truy vấn.
ad_group_bid_modifier

AdGroupBidModifier

Hệ số điều chỉnh giá thầu được tham chiếu trong truy vấn.
ad_group_criterion

AdGroupCriterion

Tiêu chí được tham chiếu trong truy vấn.
ad_group_criterion_effective_label

AdGroupCriterionEffectiveLabel

Nhãn hiệu quả của tiêu chí nhóm quảng cáo được tham chiếu trong truy vấn.
ad_group_criterion_label

AdGroupCriterionLabel

Nhãn tiêu chí của nhóm quảng cáo được tham chiếu trong truy vấn.
ad_group_effective_label

AdGroupEffectiveLabel

Nhãn hiệu quả của nhóm quảng cáo được tham chiếu trong truy vấn.
ad_group_label

AdGroupLabel

Nhãn nhóm quảng cáo được tham chiếu trong truy vấn.
age_range_view

AgeRangeView

Chế độ xem độ tuổi được tham chiếu trong truy vấn.
asset

Asset

Tài sản được tham chiếu trong truy vấn.
asset_group_asset

AssetGroupAsset

Thành phần nhóm thành phần được tham chiếu trong truy vấn.
asset_group_signal

AssetGroupSignal

Tín hiệu nhóm thành phần được tham chiếu trong truy vấn.
asset_group_listing_group_filter

AssetGroupListingGroupFilter

Bộ lọc nhóm trang thông tin của nhóm thành phần được tham chiếu trong truy vấn.
asset_group_top_combination_view

AssetGroupTopCombinationView

Chế độ xem kiểu kết hợp hàng đầu của nhóm thành phần được tham chiếu trong truy vấn.
asset_group

AssetGroup

Nhóm thành phần được tham chiếu trong truy vấn.
asset_set_asset

AssetSetAsset

Thành phần trong nhóm thành phần được tham chiếu trong truy vấn.
asset_set

AssetSet

Nhóm thành phần được tham chiếu trong truy vấn.
bidding_strategy

BiddingStrategy

Chiến lược đặt giá thầu được tham chiếu trong truy vấn.
campaign_budget

CampaignBudget

Ngân sách chiến dịch được tham chiếu trong truy vấn.
campaign

Campaign

Chiến dịch được tham chiếu trong truy vấn.
campaign_asset

CampaignAsset

Thành phần của chiến dịch được tham chiếu trong truy vấn.
campaign_asset_set

CampaignAssetSet

Tập hợp thành phần chiến dịch được tham chiếu trong truy vấn.
campaign_audience_view

CampaignAudienceView

Chế độ xem đối tượng của chiến dịch được tham chiếu trong truy vấn.
campaign_criterion

CampaignCriterion

Tiêu chí chiến dịch được tham chiếu trong truy vấn.
campaign_effective_label

CampaignEffectiveLabel

Nhãn hiệu quả của chiến dịch được tham chiếu trong truy vấn.
campaign_label

CampaignLabel

Nhãn chiến dịch được tham chiếu trong truy vấn.
cart_data_sales_view

CartDataSalesView

Chế độ xem lượt bán hàng trong dữ liệu giỏ hàng được tham chiếu trong truy vấn.
audience

Audience

Đối tượng được tham chiếu trong truy vấn.
conversion_action

ConversionAction

Hành động chuyển đổi được tham chiếu trong truy vấn.
conversion_custom_variable

ConversionCustomVariable

Biến tuỳ chỉnh lượt chuyển đổi được tham chiếu trong truy vấn.
customer

Customer

Khách hàng được tham chiếu trong truy vấn.
customer_asset

CustomerAsset

Thành phần của khách hàng được tham chiếu trong truy vấn.
customer_asset_set

CustomerAssetSet

Tập hợp thành phần khách hàng được tham chiếu trong truy vấn.
accessible_bidding_strategy

AccessibleBiddingStrategy

Chiến lược đặt giá thầu có thể truy cập được được tham chiếu trong truy vấn.
customer_client

CustomerClient

CustomerClient được tham chiếu trong truy vấn.
dynamic_search_ads_search_term_view

DynamicSearchAdsSearchTermView

Chế độ xem cụm từ tìm kiếm của quảng cáo tìm kiếm động được tham chiếu trong truy vấn.
gender_view

GenderView

Chế độ xem theo giới tính được đề cập trong truy vấn.
geo_target_constant

GeoTargetConstant

Hằng số mục tiêu theo vị trí địa lý được tham chiếu trong truy vấn.
keyword_view

KeywordView

Chế độ xem từ khoá được tham chiếu trong truy vấn.
label

Label

Nhãn được tham chiếu trong truy vấn.
language_constant

LanguageConstant

Hằng ngôn ngữ được tham chiếu trong truy vấn.
location_view

LocationView

Chế độ xem vị trí được tham chiếu trong truy vấn.
product_bidding_category_constant

ProductBiddingCategoryConstant

Danh mục đặt giá thầu sản phẩm được tham chiếu trong truy vấn.
product_group_view

ProductGroupView

Chế độ xem nhóm sản phẩm được tham chiếu trong truy vấn.
shopping_performance_view

ShoppingPerformanceView

Chế độ xem hiệu suất mua sắm được tham chiếu trong truy vấn.
user_list

UserList

Danh sách người dùng được tham chiếu trong truy vấn.
user_location_view

UserLocationView

Chế độ xem vị trí của người dùng được tham chiếu trong truy vấn.
webpage_view

WebpageView

Chế độ xem trang web được tham chiếu trong truy vấn.
visit

Visit

Lượt truy cập ở cấp sự kiện được tham chiếu trong truy vấn.
conversion

Conversion

Lượt chuyển đổi ở cấp sự kiện được tham chiếu trong truy vấn.
metrics

Metrics

Các chỉ số.
segments

Segments

Các phân đoạn.
custom_columns[]

Value

Cột tuỳ chỉnh.

SearchSearchAds360FieldsRequest

Thông báo yêu cầu đối với SearchAds360FieldService.SearchSearchAds360Fields.

Trường
query

string

Bắt buộc. Chuỗi truy vấn.
page_token

string

Mã thông báo của trang cần truy xuất. Nếu không được chỉ định, hệ thống sẽ trả về trang kết quả đầu tiên. Sử dụng giá trị thu được từ next_page_token trong phản hồi trước đó để yêu cầu trang kết quả tiếp theo.
page_size

int32

Số phần tử cần truy xuất trong một trang. Khi một trang quá lớn được yêu cầu, máy chủ có thể quyết định giới hạn thêm số lượng tài nguyên được trả về.

SearchSearchAds360FieldsResponse

Thông báo phản hồi cho SearchAds360FieldService.SearchSearchAds360Fields.

Trường
results[]

SearchAds360Field

Danh sách các trường khớp với truy vấn.
next_page_token

string

Mã thông báo phân trang được dùng để truy xuất trang kết quả tiếp theo. Truyền nội dung của chuỗi này dưới dạng thuộc tính page_token của yêu cầu tiếp theo. Không trả về next_page_token cho trang cuối cùng.
total_results_count

int64

Tổng số kết quả khớp với truy vấn, bỏ qua mệnh đề LIMIT.

SearchSearchAds360Request

Thông báo yêu cầu đối với SearchAds360Service.Search.

Trường
customer_id

string

Bắt buộc. Mã của khách hàng đang được truy vấn.
query

string

Bắt buộc. Chuỗi truy vấn.
page_token

string

Mã thông báo của trang cần truy xuất. Nếu không được chỉ định, hệ thống sẽ trả về trang kết quả đầu tiên. Sử dụng giá trị thu được từ next_page_token trong phản hồi trước đó để yêu cầu trang kết quả tiếp theo.
page_size

int32

Số phần tử cần truy xuất trong một trang. Khi một trang quá lớn được yêu cầu, máy chủ có thể quyết định giới hạn thêm số lượng tài nguyên được trả về.
validate_only

bool

Nếu đúng, yêu cầu sẽ được xác thực nhưng không được thực thi.
return_total_results_count

bool

Nếu đúng, tổng số kết quả khớp với truy vấn (bỏ qua mệnh đề LIMIT) sẽ được đưa vào phản hồi. Mặc định là sai.
summary_row_setting

SummaryRowSetting

Xác định xem hàng tóm tắt có được trả về hay không. Theo mặc định, hàng tóm tắt sẽ không được trả về. Nếu được yêu cầu, hàng tóm tắt sẽ tự được gửi trong một phản hồi sau khi tất cả kết quả truy vấn khác được trả về.

SearchSearchAds360Response

Thông báo phản hồi cho SearchAds360Service.Search.

Trường
results[]

SearchAds360Row

Danh sách các hàng khớp với truy vấn.
next_page_token

string

Mã thông báo phân trang dùng để truy xuất trang kết quả tiếp theo. Truyền nội dung của chuỗi này dưới dạng thuộc tính page_token của yêu cầu tiếp theo. Không trả về next_page_token cho trang cuối cùng.
total_results_count

int64

Tổng số kết quả phù hợp với truy vấn bỏ qua mệnh đề LIMIT.
field_mask

FieldMask

FieldMask đại diện cho những trường mà người dùng đã yêu cầu.
summary_row

SearchAds360Row

Hàng tóm tắt chứa thông tin tóm tắt về các chỉ số trong kết quả. Tóm tắt chỉ số có nghĩa là tổng hợp các chỉ số trên tất cả kết quả, trong đó tổng hợp có thể là tổng, trung bình, tỷ lệ, v.v.
custom_column_headers[]

CustomColumnHeader

Tiêu đề của các cột tuỳ chỉnh trong kết quả.
conversion_custom_metric_headers[]

ConversionCustomMetricHeader

Tiêu đề của các chỉ số tuỳ chỉnh về lượt chuyển đổi trong kết quả.
conversion_custom_dimension_headers[]

ConversionCustomDimensionHeader

Tiêu đề của phương diện tuỳ chỉnh lượt chuyển đổi trong kết quả.
raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

Tiêu đề của các chỉ số lượt chuyển đổi sự kiện thô trong kết quả.
raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

Tiêu đề của phương diện lượt chuyển đổi sự kiện thô trong kết quả.

SearchSearchAds360StreamRequest

Thông báo yêu cầu đối với SearchAds360Service.SearchStream.

Trường
customer_id

string

Bắt buộc. Mã của khách hàng đang được truy vấn.
query

string

Bắt buộc. Chuỗi truy vấn.
batch_size

int32

Số hàng được trả về trong mỗi lô phản hồi luồng. Khi bạn yêu cầu một lô quá lớn, máy chủ có thể quyết định giới hạn thêm số lượng hàng được trả về.
summary_row_setting

SummaryRowSetting

Xác định xem hàng tóm tắt có được trả về hay không. Theo mặc định, hàng tóm tắt sẽ không được trả về. Nếu được yêu cầu, hàng tóm tắt sẽ tự được gửi trong một phản hồi sau khi tất cả kết quả truy vấn khác được trả về.

SearchSearchAds360StreamResponse

Thông báo phản hồi cho SearchAds360Service.SearchStream.

Trường
results[]

SearchAds360Row

Danh sách các hàng khớp với truy vấn.
field_mask

FieldMask

Mặt nạ trường đại diện cho các trường mà người dùng yêu cầu.
summary_row

SearchAds360Row

Hàng tóm tắt chứa thông tin tóm tắt về các chỉ số trong kết quả. Tóm tắt chỉ số có nghĩa là tổng hợp các chỉ số trên tất cả kết quả, trong đó tổng hợp có thể là tổng, trung bình, tỷ lệ, v.v.
custom_column_headers[]

CustomColumnHeader

Tiêu đề của các cột tuỳ chỉnh trong kết quả.
conversion_custom_metric_headers[]

ConversionCustomMetricHeader

Tiêu đề của các chỉ số tuỳ chỉnh về lượt chuyển đổi trong kết quả.
conversion_custom_dimension_headers[]

ConversionCustomDimensionHeader

Tiêu đề của phương diện tuỳ chỉnh lượt chuyển đổi trong kết quả.
raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

Tiêu đề của các chỉ số về lượt chuyển đổi của sự kiện chưa qua xử lý trong kết quả.
raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

Tiêu đề của các phương diện lượt chuyển đổi sự kiện thô trong kết quả.
request_id

string

Mã nhận dạng duy nhất của yêu cầu được dùng cho mục đích gỡ lỗi.