Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว เข้าร่วมกลุ่ม Google
searchads-api-announcements เพื่อติดตามการปรับปรุงและรุ่นที่กำลังจะเปิดตัว
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
รายการผู้ใช้
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
รายชื่อผู้ใช้ ซึ่งเป็นรายชื่อผู้ใช้ที่ลูกค้าอาจกำหนดเป้าหมาย คีย์ที่ไม่ซ้ำกันของรายชื่อผู้ใช้ประกอบด้วยช่องต่อไปนี้ id โปรดทราบว่า name ต้องไม่ซ้ำกันสำหรับรายชื่อผู้ใช้ที่เป็นของลูกค้าที่ระบุด้วย ยกเว้นในบางกรณีที่ตั้งค่า access_reason เป็น SHARED การละเมิดข้อจำกัดชื่อที่ไม่ซ้ำกันจะทำให้เกิดข้อผิดพลาด UserListError.INVALID_NAME
คุณสามารถเลือกช่องจากทรัพยากรด้านบนพร้อมกับทรัพยากรนี้ในอนุประโยค SELECT และ WHERE ช่องเหล่านี้จะไม่แบ่งกลุ่ม
เมตริกในอนุประโยค SELECT
ช่อง/กลุ่ม/เมตริก
หน้านี้แสดงเมตริกและกลุ่มทั้งหมดที่สามารถใส่ในอนุประโยค SELECT เดียวกันกับช่องของ user_list
อย่างไรก็ตาม เมื่อระบุ user_list ในอนุประโยค FROM คุณจะไม่สามารถใช้เมตริกและกลุ่มบางรายการได้
ใช้ตัวกรองต่อไปนี้เพื่อแสดงเฉพาะช่องที่ใช้ได้เมื่อระบุ user_list ในอนุประโยค FROM
คุณระบุ user_list ในอนุประโยค FROM ของการค้นหาหรือไม่
ไม่
ใช่แล้ว
user_list.id
คำอธิบายช่อง รหัสของรายชื่อผู้ใช้ หมวดหมู่ ATTRIBUTEประเภทข้อมูล INT64ประเภท URL N/Aกรองได้ จริง เลือกได้ จริง Sortable จริง ซ้ำ เท็จ
user_list.name
คำอธิบายช่อง ชื่อของรายชื่อผู้ใช้นี้ ไม่ซ้ำกันต่อรายชื่อผู้ใช้ ยกเว้นในบางกรณีที่รายชื่อผู้ใช้ที่มีชื่อเดียวกันตั้งค่า access_reason เป็น SHARED หมวดหมู่ ATTRIBUTEประเภทข้อมูล STRINGประเภท URL N/Aกรองได้ จริง เลือกได้ จริง Sortable จริง ซ้ำ เท็จ
user_list.resource_name
คำอธิบายช่อง ชื่อทรัพยากรของรายชื่อผู้ใช้ ชื่อทรัพยากรของรายชื่อผู้ใช้มีรูปแบบเป็น customers/{customer_id}/userLists/{user_list_id} หมวดหมู่ ATTRIBUTEประเภทข้อมูล RESOURCE_NAMEประเภท URL N/Aกรองได้ จริง เลือกได้ จริง Sortable เท็จ ซ้ำ เท็จ
user_list.type
คำอธิบายช่อง ประเภทของรายการนี้ ช่องนี้เป็นแบบอ่านอย่างเดียว หมวดหมู่ ATTRIBUTEประเภทข้อมูล
ENUM
CRM_BASED
EXTERNAL_REMARKETING
LOGICAL
REMARKETING
RULE_BASED
SIMILAR
UNKNOWN
UNSPECIFIED
ประเภท URL google.ads.searchads360.v0.enums.UserListTypeEnum.UserListTypeกรองได้ จริง เลือกได้ จริง Sortable จริง ซ้ำ เท็จ
segments.date
คำอธิบายช่อง วันที่ที่ใช้เมตริก รูปแบบ ปปปป-ดด-วว เช่น 2018-04-17 หมวดหมู่ SEGMENTประเภทข้อมูล DATEประเภท URL N/Aกรองได้ จริง เลือกได้ จริง Sortable จริง ซ้ำ เท็จ
segments.keyword.ad_group_criterion
คำอธิบายช่อง ชื่อทรัพยากรของ AdGroupCriterion หมวดหมู่ SEGMENTประเภทข้อมูล RESOURCE_NAMEประเภท URL N/Aกรองได้ จริง เลือกได้ จริง Sortable เท็จ ซ้ำ เท็จ
segments.keyword.info.match_type
คำอธิบายช่อง ประเภทการทำงานของคีย์เวิร์ด หมวดหมู่ SEGMENTประเภทข้อมูล
ENUM
BROAD
EXACT
PHRASE
UNKNOWN
UNSPECIFIED
ประเภท URL google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchTypeกรองได้ จริง เลือกได้ จริง Sortable จริง ซ้ำ เท็จ
segments.keyword.info.text
คำอธิบายช่อง ข้อความของคีย์เวิร์ด (ไม่เกิน 80 อักขระและ 10 คำ) หมวดหมู่ SEGMENTประเภทข้อมูล STRINGประเภท URL N/Aกรองได้ จริง เลือกได้ จริง Sortable จริง ซ้ำ เท็จ
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2026-05-11 UTC
[null,null,["อัปเดตล่าสุด 2026-05-11 UTC"],[],["This document describes user lists, which are targetable by customers, and associated data. Key fields include `user_list.id` (unique ID), `user_list.name` (potentially non-unique name), `user_list.resource_name` (resource identifier), and `user_list.type` (list classification, e.g., CRM_BASED). These fields, categorized as attributes, can be used in SELECT and WHERE clauses for filtering and retrieval, but will not segment metrics. The related resource is `customer`, which can also be included.\n"]]
