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 ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

rpc SearchStream(SearchSearchAds360StreamRequest) returns (SearchSearchAds360StreamResponse)

แสดงผลแถวทั้งหมดที่ตรงกับคำค้นหาของสตรีมการค้นหา

รายการข้อผิดพลาดที่เกิดขึ้น AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError 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

รหัสที่ไม่ซ้ำกันของคำขอที่ใช้เพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่อง