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 đủ chi tiết.

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ột tuỳ chỉnh liên kết với khách hàng một cách đầy đủ chi tiết.

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 các lỗi đã 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 đã 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 các lỗi đã 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ố trên các tài nguyên.

Tìm kiếm

rpc Search(SearchSearchAds360Request) returns (SearchSearchAds360Response)

Trả về mọi dòng phù hợp với cụm từ tìm kiếm.

Danh sách các lỗi đã 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ả hàng khớp với truy vấn luồng tìm kiếm.

Danh sách các lỗi đã 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 của lượt chuyển đổi.

ConversionCustomMetricHeader

Thông báo cho tiêu đề chỉ số tuỳ chỉnh của 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 lượt chuyển đổi.

CustomColumnHeader

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

Trường
id

int64

Mã cột tuỳ chỉnh.

name

string

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

references_metrics

bool

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

GetCustomColumnRequest

Tin nhắn yêu cầu cho 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

Tin nhắn yêu cầu cho SearchAds360FieldService.GetSearchAds360Field.

Trường
resource_name

string

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

ListAccessibleCustomersRequest

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

Tin nhắn yêu cầu cho CustomerService.ListAccessibleCustomers.

ListAccessibleCustomersResponse

Tin nhắn 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 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 danh sách CustomColumn.

ListCustomColumnsResponse

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

Trường
custom_columns[]

CustomColumn

Cột tuỳ chỉnh thuộc sở hữu của khách hàng được cung cấp.

RawEventConversionDimensionHeader

Thông báo cho tiêu đề của 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 chưa qua xử lý.

RawEventConversionMetricHeader

Thông báo cho tiêu đề chỉ số 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 chỉ số sự kiện chưa qua xử lý.

Hàng SearchAds360

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_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

Nhóm 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 của nhóm quảng cáo được tham chiếu trong truy vấn.

ad_group_bid_modifier

AdGroupBidModifier

Hệ số sửa đổi 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_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_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

Thành phầ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 về 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 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 bộ 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 chiến dịch được tham chiếu trong truy vấn.

campaign_asset_set

CampaignAssetSet

Nhóm 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_label

CampaignLabel

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

cart_data_sales_view

CartDataSalesView

Chế độ xem doanh số 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 của lượt chuyển đổi được tham chiếu trong truy vấn.

customer

Customer

Khách hàng được nhắc đến trong truy vấn.

customer_asset

CustomerAsset

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

customer_asset_set

CustomerAssetSet

Nhóm 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 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 cho 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 tham chiếu trong truy vấn.

geo_target_constant

GeoTargetConstant

Hằng số mục tiêu đị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 số 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.

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

Phân khúc.

custom_columns[]

Value

Cột tuỳ chỉnh.

SearchSearchAds360FieldsRequest

Tin nhắn yêu cầu cho 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ị nhận đượ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 trang được yêu cầu quá lớn, 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

Tin nhắn phản hồi cho SearchAds360FieldService.SearchSearchAds360Fields.

Trường
results[]

SearchAds360Field

Danh sách trường khớp với cụm từ tìm kiếm.

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. next_page_token không được trả về 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

Tin nhắn yêu cầu cho SearchAds360Service.Search.

Trường
customer_id

string

Bắt buộc. Mã của khách hàng đượ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ị nhận đượ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 trang được yêu cầu quá lớn, 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 không được trả về. Nếu được yêu cầu, hàng tóm tắt sẽ tự gửi trong phản hồi sau khi tất cả kết quả truy vấn khác được trả về.

SearchSearchAds360Response

Tin nhắn phản hồi cho SearchAds360Service.Search.

Trường
results[]

SearchAds360Row

Danh sách các hàng phù hợ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. next_page_token không được trả về 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.

field_mask

FieldMask

Trường mặt nạ biểu thị 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ố nghĩa là tổng hợp các chỉ số trên tất cả kết quả. Ở đây, dữ liệu 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

Các tiêu đề của 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 chưa qua xử lý 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 chưa qua xử lý trong kết quả.

SearchSearchAds360StreamRequest

Tin nhắn yêu cầu cho SearchAds360Service.SearchStream.

Trường
customer_id

string

Bắt buộc. Mã của khách hàng đượ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 theo luồng. Khi yêu cầu lô quá lớn, máy chủ có thể quyết định giới hạn thêm số 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 không được trả về. Nếu được yêu cầu, hàng tóm tắt sẽ tự gửi trong phản hồi sau khi tất cả kết quả truy vấn khác được trả về.

SearchSearchAds360StreamResponse

Tin nhắn phản hồi cho SearchAds360Service.SearchStream.

Trường
results[]

SearchAds360Row

Danh sách các hàng phù hợp với truy vấn.

field_mask

FieldMask

Trường mặt nạ biểu thị 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ố nghĩa là tổng hợp các chỉ số trên tất cả kết quả. Ở đây, dữ liệu 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

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

conversion_custom_dimension_headers[]

ConversionCustomDimensionHeader

Các 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 chưa qua xử lý 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 chưa qua xử lý trong kết quả.

request_id

string

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