Method: customers.userListQueries.validate

מבצע בדיקות אימות סטטיות בשאילתה של רשימת המשתמשים שצוינה.

בקשת HTTP

POST https://adsdatahub.googleapis.com/v1/{parent=customers/*}/userListQueries:validate

כתובת ה-URL כוללת תחביר gRPC קידוד מחדש.

פרמטרים של נתיב

פרמטרים
parent

string

שם המשאב ההורה שבבעלותו השאילתה, למשל 'customers/123'.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "query": {
    object (UserListQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
שדות
query

object (UserListQuery)

השאילתה לאימות.
adsDataCustomerId
(deprecated)

string (int64 format)

אופציונלי. מספר לקוח ספציפי של Ads Data Hub המקושר לצורך אימות נתוני מודעות וגישה לטבלה זמנית. הגדרת ברירת המחדל לכל הלקוחות המקושרים. הוּצא משימוש. משתמשים במאפיין adsDataCustomerId ב-query_execution_spec.
matchDataCustomerId
(deprecated)

string (int64 format)

אופציונלי. מספר לקוח ספציפי של Ads Data Hub המקושר לצורך אימות של נתוני התאמה וגישה לטבלה זמנית. הגדרת ברירת המחדל לכל הלקוחות המקושרים. הוּצא משימוש. משתמשים בפרמטר "match_table_customer_id" בתוך query_execution_spec.
spec

object (QueryExecutionSpec)

אופציונלי. השדות הכפולים בתוך query_execution_spec יחליפו את השדות החיצוניים.
includePerformanceInfo

boolean

אופציונלי. אם הערך הוא true, יש להתקשר ל-BigQuery כדי יבש את השאילתה ולאסוף פרטי ביצועים. התהליך עשוי להימשך זמן רב יותר בהשוואה לאימות השאילתה בלבד. יש להגדיר את תאריך ההתחלה, את תאריך הסיום ואת הפרמטרים בתוך query_execution_spec עבור הריצה היבשה.

גוף התגובה

אם התגובה מוצלחת, גוף התגובה מכיל נתונים במבנה הבא:

תגובה לבקשה מסוג userListQuery.verify.

ייצוג JSON 
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  }
}
שדות
processedBytes
(deprecated)

string (int64 format)

הוצא משימוש, ובמקום זאת יש להשתמש ב-QueryPerformanceInfo. בייטים של נתונים שהשאילתה הזו קוראת. בכתובת https://cloud.google.com/bigquery/pricing#data מפורט אופן החישוב. פונקציה זו מוחזרת אם הערך של PerformanceInfo נכון. אנחנו עיגולים את ה-Bybits ל-MB ואז ממירים אותם לבייטים. -1 פירושו שלא הצלחנו לאחזר אותו עבור שאילתה זו.
queryPerformanceInfo

object (QueryPerformanceInfo)

פונקציה זו מוחזרת אם הערך של PerformanceInfo נכון.

היקפי הרשאה

יש צורך בהיקף OAuth הבא:

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