Method: customers.analysisQueries.validate

ดําเนินการตรวจสอบความถูกต้องแบบคงที่กับการค้นหาการวิเคราะห์ที่มีให้

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

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

string

ชื่อทรัพยากรระดับบนสุดที่เป็นเจ้าของการค้นหา เช่น 'customers/123'

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

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

การแสดง JSON
{
  "query": {
    object (AnalysisQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
ช่อง
query

object (AnalysisQuery)

คําค้นหาที่ต้องการตรวจสอบ

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

ไม่บังคับ หากค่าเป็น "จริง" ให้เรียกใช้ BigQuery เพื่อเรียกใช้การค้นหาแห้งเพื่อรวบรวมข้อมูลบางอย่างเกี่ยวกับประสิทธิภาพ โดยอาจใช้เวลานานกว่านั้นในการตรวจสอบความถูกต้องของคําค้นหาเท่านั้น ต้องตั้งค่า startDate, endDate และพารามิเตอร์ภายใน query_execution_spec สําหรับการทดลองเรียกใช้

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

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

การตอบสนองต่อคําขอการวิเคราะห์คําค้นหาที่ตรวจสอบความถูกต้อง

การแสดง JSON
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  },
  "filteredRowSummary": {
    object (FilteredRowSummary)
  }
}
ช่อง
processedBytes
(deprecated)

string (int64 format)

เลิกใช้งานแล้ว และใช้ QueryPerformanceInfo แทน จํานวนไบต์ของข้อมูลการค้นหาที่อ่านนี้ ดูรายละเอียดวิธีคํานวณค่านี้ได้ที่ https://cloud.google.com/bigquery/pricing#data แสดงผลหากมี includePerformanceInfo เป็นจริง เราปัดเศษไบต์ที่ประมวลผลให้เป็น MB แล้วแปลงเป็นไบต์ -1 หมายถึงเราไม่สามารถเรียกข้อมูลนี้สําหรับข้อความค้นหานี้

queryPerformanceInfo

object (QueryPerformanceInfo)

แสดงผลหากมี includePerformanceInfo เป็นจริง

filteredRowSummary

object (FilteredRowSummary)

ข้อมูลสรุปเกี่ยวกับแถวที่กรองซึ่งจะใช้เมื่อดําเนินการค้นหา: แถวที่ไม่ได้รวบรวมอย่างเพียงพอจะไม่รวมอยู่ในผลลัพธ์ สรุปแถวที่กรองแล้วจะอธิบายถึงวิธีการสรุปแถวเหล่านี้ ดูรายละเอียดได้ที่ https://developers.google.com/ads-data-hub/guides/filtered-row-summary

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

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

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