แสดงแถวทั้งหมดที่ตรงกับคำค้นหา
รายการข้อผิดพลาด: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError
คำขอ HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/googleAds:search
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
customerId |
ต้องระบุ รหัสของลูกค้าที่ค้นหา |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{
"query": string,
"pageToken": string,
"pageSize": integer,
"validateOnly": boolean,
"returnTotalResultsCount": boolean,
"summaryRowSetting": enum ( |
ช่อง | |
---|---|
query |
ต้องระบุ สตริงการค้นหา |
pageToken |
โทเค็นของหน้าที่จะดึงข้อมูล หากไม่ได้ระบุ ระบบจะแสดงผลหน้าแรกของผลการค้นหา ใช้ค่าที่ได้รับจาก |
pageSize |
จำนวนองค์ประกอบที่จะดึงข้อมูลในหน้าเดียว เมื่อมีการขอหน้าเว็บมากเกินไป เซิร์ฟเวอร์อาจตัดสินใจจำกัดจำนวนทรัพยากรที่แสดงผลมากขึ้น |
validateOnly |
หากจริง คำขอจะได้รับการตรวจสอบ แต่จะไม่ดำเนินการ |
returnTotalResultsCount |
หากจริง จำนวนผลลัพธ์ทั้งหมดที่ตรงกับข้อความค้นหาโดยละเว้นข้อความ LIMIT จะรวมอยู่ในคำตอบ ทั้งนี้ ระบบตั้งค่าเริ่มต้นไว้ที่ false |
summaryRowSetting |
กำหนดว่าจะแสดงแถวสรุปหรือไม่ โดยค่าเริ่มต้น ระบบจะไม่แสดงแถวสรุป หากได้รับคำขอ ระบบจะส่งแถวสรุปในการตอบสนองด้วยตนเองหลังจากแสดงผลลัพธ์การค้นหาอื่นๆ ทั้งหมด |
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับ GoogleAdsService.Search
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "results": [ { object ( |
ช่อง | |
---|---|
results[] |
รายการแถวที่ตรงกับการค้นหา |
nextPageToken |
โทเค็นการใส่เลขหน้าที่ใช้ในการเรียกผลลัพธ์หน้าถัดไป ส่งเนื้อหาของสตริงนี้เป็นแอตทริบิวต์ |
totalResultsCount |
จำนวนผลลัพธ์ทั้งหมดที่ตรงกับข้อความค้นหาโดยไม่คำนึงถึงข้อความ LIMIT |
fieldMask |
FieldMask ที่แสดงช่องที่ผู้ใช้ขอ ซึ่งเป็นรายการชื่อของช่องที่มีคุณสมบัติครบถ้วนและคั่นด้วยคอมมา ตัวอย่าง: |
summaryRow |
แถวสรุปที่มีข้อมูลสรุปของเมตริกในผลลัพธ์ การสรุปเมตริกหมายถึงการรวมเมตริกในผลลัพธ์ทั้งหมด การสรุปในที่นี้อาจเป็นผลรวม ค่าเฉลี่ย อัตรา ฯลฯ |
queryResourceConsumption |
จำนวนทรัพยากรที่ใช้เพื่อแสดงคำค้นหา |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/adwords
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0