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

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

RawEventConversionDimensionHeader

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

ช่อง
id

int64

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

name

string

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

RawEventConversionMetricHeader

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

ช่อง
id

int64

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

name

string

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

SearchAds360 แถว

แถวที่แสดงผลจากข้อความค้นหา

ช่อง
ad_group

AdGroup

กลุ่มโฆษณาที่อ้างอิงในการค้นหา

ad_group_ad

AdGroupAd

โฆษณาที่อ้างอิงในการค้นหา

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_label

AdGroupCriterionLabel

ป้ายกำกับเกณฑ์ของกลุ่มโฆษณาที่อ้างอิงในการค้นหา

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

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

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

ฟิลด์มาสก์ที่แสดงช่องที่ผู้ใช้ขอ

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

ฟิลด์มาสก์ที่แสดงช่องที่ผู้ใช้ขอ

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

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