Method: customers.searchAds360.searchStream

แสดงผลทุกแถวที่ตรงกับคำค้นหาในสตรีมการค้นหา

รายการข้อผิดพลาดที่เกิดขึ้น: AuthenticationError, AuthorizationError, ChangeEventError, ChangeStatusError, ClickViewError, HeaderError, InternalError, QueryError, QuotaError, RequestError

คำขอ HTTP

POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:searchStream

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

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

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

string

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

เนื้อหาคำขอ

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

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

string

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

batchSize

integer

จำนวนแถวที่จะแสดงผลในแต่ละชุดการตอบกลับของสตรีม เมื่อมีการขอชุดข้อมูลขนาดใหญ่เกินไป เซิร์ฟเวอร์อาจตัดสินใจจำกัดจำนวนแถวที่แสดงผลเพิ่มเติม

summaryRowSetting

enum (SummaryRowSetting)

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

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

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

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

การแสดง JSON
{
  "results": [
    {
      object (SearchAds360Row)
    }
  ],
  "fieldMask": string,
  "summaryRow": {
    object (SearchAds360Row)
  },
  "customColumnHeaders": [
    {
      object (CustomColumnHeader)
    }
  ],
  "conversionCustomMetricHeaders": [
    {
      object (ConversionCustomMetricHeader)
    }
  ],
  "conversionCustomDimensionHeaders": [
    {
      object (ConversionCustomDimensionHeader)
    }
  ],
  "rawEventConversionMetricHeaders": [
    {
      object (RawEventConversionMetricHeader)
    }
  ],
  "rawEventConversionDimensionHeaders": [
    {
      object (RawEventConversionDimensionHeader)
    }
  ],
  "requestId": string
}
ช่อง
results[]

object (SearchAds360Row)

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

fieldMask

string (FieldMask format)

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

ซึ่งเป็นรายการชื่อแบบสมบูรณ์ของช่องที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"

summaryRow

object (SearchAds360Row)

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

customColumnHeaders[]

object (CustomColumnHeader)

ส่วนหัวของคอลัมน์ที่กำหนดเองในผลลัพธ์

conversionCustomMetricHeaders[]

object (ConversionCustomMetricHeader)

ส่วนหัวของเมตริกที่กำหนดเองของการกระทำที่ถือเป็น Conversion ในผลลัพธ์

conversionCustomDimensionHeaders[]

object (ConversionCustomDimensionHeader)

ส่วนหัวของมิติข้อมูลที่กำหนดเองของการกระทำที่ถือเป็น Conversion ในผลลัพธ์

rawEventConversionMetricHeaders[]

object (RawEventConversionMetricHeader)

ส่วนหัวของเมตริกการกระทำที่ถือเป็น Conversion ของเหตุการณ์ดิบในผลลัพธ์

rawEventConversionDimensionHeaders[]

object (RawEventConversionDimensionHeader)

ส่วนหัวของมิติข้อมูลการกระทำที่ถือเป็น Conversion ของเหตุการณ์ดิบในผลลัพธ์

requestId

string

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

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

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

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