Method: customers.searchAds360.searchStream

מחזירה את כל השורות שתואמות לשאילתת זרם החיפוש.

רשימת שגיאות שקרו: AuthenticationError AuthorizationError 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)

הכותרות של המדדים המותאמים אישית של ההמרות בתוצאות.
conversionCustomDimensionHeaders[]

object (ConversionCustomDimensionHeader)

הכותרות של מאפיין ההמרה המותאם אישית בתוצאות.
rawEventConversionMetricHeaders[]

object (RawEventConversionMetricHeader)

הכותרות של מדדי ההמרות הגולמיים של אירועים שמופיעים בתוצאות.
rawEventConversionDimensionHeaders[]

object (RawEventConversionDimensionHeader)

הכותרות של מאפייני ההמרות הגולמיים של האירועים בתוצאות.
requestId

string

המזהה הייחודי של הבקשה שמשמש למטרות ניפוי באגים.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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