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

ข้อความสําหรับส่วนหัวของมิติข้อมูลที่กําหนดเองของ Conversion

ช่อง
id

int64

รหัสมิติข้อมูลที่กำหนดเองของ Conversion

name

string

ชื่อที่ผู้ใช้กําหนดของมิติข้อมูลการกระทําที่กําหนดเองของ Conversion

ConversionCustomMetricHeader

ข้อความสําหรับส่วนหัวเมตริกที่กําหนดเองของ Conversion

ช่อง
id

int64

รหัสเมตริกที่กําหนดเองของ Conversion

name

string

ชื่อที่ผู้ใช้กําหนดของเมตริกที่กําหนดเองของ Conversion

CustomColumnHeader

ข้อความสำหรับส่วนหัวของคอลัมน์ที่กำหนดเอง

ช่อง
id

int64

รหัสคอลัมน์ที่กำหนดเอง

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

ListCustomColumnsResponse

ข้อความตอบกลับสำหรับการดึงข้อมูลคอลัมน์ที่กำหนดเองทั้งหมดที่เชื่อมโยงกับลูกค้า

ช่อง
custom_columns[]

CustomColumn

CustomColumns ที่ลูกค้าระบุเป็นเจ้าของ

RawEventConversionDimensionHeader

ข้อความสําหรับส่วนหัวของมิติข้อมูล Conversion ของเหตุการณ์ดิบ

ช่อง
id

int64

รหัสตัวแปร Conversion ที่กําหนดเอง

name

string

ชื่อที่ผู้ใช้กําหนดของมิติข้อมูลเหตุการณ์ดิบ

RawEventConversionMetricHeader

ข้อความสําหรับส่วนหัวของเมตริก Conversion ของเหตุการณ์ดิบ

ช่อง
id

int64

รหัสตัวแปร Conversion ที่กําหนดเอง

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 ที่อ้างอิงในคําค้นหา

conversion_custom_variable

ConversionCustomVariable

ตัวแปรที่กําหนดเองของ Conversion ที่อ้างอิงในคําค้นหา

customer

Customer

ลูกค้าที่มีการอ้างอิงในคำค้นหา

customer_asset

CustomerAsset

ชิ้นงานของลูกค้าที่อ้างอิงในคําค้นหา

customer_asset_set

CustomerAssetSet

ชุดชิ้นงานของลูกค้าที่อ้างอิงในการค้นหา

accessible_bidding_strategy

AccessibleBiddingStrategy

กลยุทธ์การเสนอราคาที่เข้าถึงได้ซึ่งอ้างอิงในคําค้นหา

customer_client

CustomerClient

CustomerClient ที่อ้างอิงในการค้นหา

dynamic_search_ads_search_term_view

DynamicSearchAdsSearchTermView

มุมมองข้อความค้นหาของโฆษณา Search แบบไดนามิกที่อ้างอิงในคำค้นหา

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

มุมมองประสิทธิภาพ Shopping ที่อ้างอิงในคําค้นหา

user_list

UserList

รายการผู้ใช้ที่อ้างอิงในข้อความค้นหา

user_location_view

UserLocationView

มุมมองตำแหน่งของผู้ใช้ที่อ้างอิงในข้อความค้นหา

webpage_view

WebpageView

มุมมองหน้าเว็บที่อ้างอิงในข้อความค้นหา

visit

Visit

การเข้าชมระดับเหตุการณ์ที่อ้างอิงในคําค้นหา

conversion

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

หากเป็นจริง ระบบจะตรวจสอบคำขอแต่ไม่ดำเนินการ

return_total_results_count

bool

หากเป็นจริง ระบบจะรวมจํานวนผลลัพธ์ทั้งหมดที่ตรงกับการค้นหาโดยไม่สนใจคำสั่ง 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 ในผลลัพธ์

conversion_custom_dimension_headers[]

ConversionCustomDimensionHeader

ส่วนหัวของมิติข้อมูลที่กําหนดเองของ Conversion ในผลลัพธ์

raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

ส่วนหัวของเมตริก Conversion เหตุการณ์ดิบในผลลัพธ์

raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

ส่วนหัวของมิติข้อมูล Conversion เหตุการณ์ดิบในผลลัพธ์

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 ในผลลัพธ์

conversion_custom_dimension_headers[]

ConversionCustomDimensionHeader

ส่วนหัวของมิติข้อมูลที่กำหนดเองของ Conversion ในผลลัพธ์

raw_event_conversion_metric_headers[]

RawEventConversionMetricHeader

ส่วนหัวของเมตริก Conversion เหตุการณ์ดิบในผลลัพธ์

raw_event_conversion_dimension_headers[]

RawEventConversionDimensionHeader

ส่วนหัวของมิติข้อมูล Conversion เหตุการณ์ดิบในผลลัพธ์

request_id

string

รหัสที่ไม่ซ้ำกันของคําขอที่ใช้สําหรับการแก้ไขข้อบกพร่อง