แสดงแถวทั้งหมดที่ตรงกับคำค้นหา
รายการข้อผิดพลาด: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError
คำขอ HTTP
POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:search
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
customer |
ต้องระบุ รหัสของลูกค้าที่ค้นหา |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{
"query": string,
"pageToken": string,
"pageSize": integer,
"validateOnly": boolean,
"returnTotalResultsCount": boolean,
"summaryRowSetting": enum ( |
ช่อง | |
---|---|
query |
ต้องระบุ สตริงการค้นหา |
page |
โทเค็นของหน้าที่จะดึงข้อมูล หากไม่ระบุ ระบบจะแสดงหน้าแรกของผลการค้นหา ใช้ค่าที่ได้รับจาก |
page |
จำนวนองค์ประกอบที่จะดึงข้อมูลในหน้าเดียว เมื่อมีการขอหน้าเว็บที่มีขนาดใหญ่เกินไป เซิร์ฟเวอร์อาจตัดสินใจจำกัดจำนวนทรัพยากรที่แสดงผลเพิ่มเติม |
validate |
หากเป็นจริง ระบบจะตรวจสอบคำขอแต่ไม่ดำเนินการ |
return |
ถ้าเป็นจริง จำนวนผลลัพธ์ทั้งหมดที่ตรงกับข้อความค้นหาโดยละเว้นข้อความ LIMIT จะรวมอยู่ในคำตอบ ค่าเริ่มต้นคือ False |
summary |
กำหนดว่าจะแสดงแถวสรุปหรือไม่ ระบบจะไม่แสดงแถวข้อมูลสรุปโดยค่าเริ่มต้น หากได้รับคำขอ ระบบจะส่งแถวสรุปในการตอบสนองด้วยตนเองหลังจากแสดงผลลัพธ์การค้นหาอื่นๆ ทั้งหมด |
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับ SearchAds360Service.Search
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "results": [ { object ( |
ช่อง | |
---|---|
results[] |
รายการแถวที่ตรงกับคําค้นหา |
next |
โทเค็นการแบ่งหน้าเว็บที่ใช้ดึงข้อมูลหน้าถัดไปของผลการค้นหา ส่งเนื้อหาของสตริงนี้เป็นแอตทริบิวต์ |
total |
จำนวนผลลัพธ์ทั้งหมดที่ตรงกับข้อความค้นหาโดยไม่คำนึงถึงข้อความ LIMIT |
field |
FieldMask ที่แสดงช่องที่ผู้ใช้ขอ ซึ่งเป็นรายการชื่อฟิลด์ที่สมบูรณ์ในตัวเองที่คั่นด้วยคอมมา ตัวอย่าง: |
summary |
แถวสรุปที่มีสรุปเมตริกในผลลัพธ์ สรุปเมตริกหมายถึงการรวมเมตริกจากผลลัพธ์ทั้งหมด ซึ่งการรวมอาจเป็นผลรวม ค่าเฉลี่ย อัตรา เป็นต้น |
custom |
ส่วนหัวของคอลัมน์ที่กำหนดเองในผลการค้นหา |
conversion |
ส่วนหัวของเมตริก Conversion ที่กำหนดเองในผลลัพธ์ |
conversion |
ส่วนหัวของมิติข้อมูลที่กําหนดเองของ Conversion ในผลลัพธ์ |
raw |
ส่วนหัวของเมตริก Conversion เหตุการณ์ดิบในผลลัพธ์ |
raw |
ส่วนหัวของมิติข้อมูล Conversion เหตุการณ์ดิบในผลลัพธ์ |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/doubleclicksearch