Method: customers.googleAds.searchStream

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

รายการข้อผิดพลาดที่พบ: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError ทั้งหมด

คำขอ HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/googleAds:searchStream

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

ต้องระบุ รหัสของลูกค้าที่กำลังค้นหา

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON
{
  "query": string,
  "summaryRowSetting": enum (SummaryRowSetting)
}
ช่อง
query

string

ต้องระบุ สตริงการค้นหา

summaryRowSetting

enum (SummaryRowSetting)

กําหนดว่าจะแสดงแถวสรุปหรือไม่ โดยค่าเริ่มต้น ระบบจะไม่แสดงผลแถวสรุป หากส่งคำขอ ระบบจะส่งแถวสรุปไปในการตอบกลับคำขอหลังจากแสดงผลการค้นหาอื่นๆ ทั้งหมด

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ GoogleAdsService.SearchStream

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "results": [
    {
      object (GoogleAdsRow)
    }
  ],
  "fieldMask": string,
  "summaryRow": {
    object (GoogleAdsRow)
  },
  "requestId": string
}
ช่อง
results[]

object (GoogleAdsRow)

รายการแถวที่ตรงกับข้อความค้นหา

fieldMask

string (FieldMask format)

FieldMask ที่แสดงถึงฟิลด์ที่ผู้ใช้ขอ

ซึ่งเป็นรายการชื่อฟิลด์ที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"

summaryRow

object (GoogleAdsRow)

แถวสรุปที่มีสรุปเมตริกในผลลัพธ์ สรุปเมตริกหมายถึงการรวมเมตริกจากผลลัพธ์ทั้งหมด โดยสรุปอาจเป็นผลรวม ค่าเฉลี่ย อัตรา ฯลฯ

requestId

string

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

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

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

  • https://www.googleapis.com/auth/adwords

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0