REST Resource: customers.analysisQueries

แหล่งข้อมูล: การวิเคราะห์การค้นหา

กําหนดการค้นหาการวิเคราะห์ที่ดําเนินการภายใน Ads Data Hub ได้

การแสดง JSON 
{
  "name": string,
  "title": string,
  "queryText": string,
  "parameterTypes": {
    string: {
      object (ParameterType)
    },
    ...
  },
  "mergeSpec": {
    object (MergeSpec)
  },
  "queryState": enum (QueryState),
  "updateTime": string,
  "updateEmail": string,
  "createTime": string,
  "createEmail": string,
  "queryShare": [
    {
      object (QueryShare)
    }
  ],

  // Union field filtered_row can be only one of the following:
  "filteredRowSummary": {
    object (FilteredRowSummary)
  },
  "generateFilteredRowSummaryAutomatically": boolean
  // End of list of possible types for union field filtered_row.
}
ช่อง
name

string

ชื่อที่ระบุคําค้นหาที่ไม่ซ้ํากัน โดยใช้แบบฟอร์ม customer/[customerId]/analysisQuery/[resource_id] เช่น 'customers/123/analysisQuery/abcd1234' เซิร์ฟเวอร์สร้างรหัสทรัพยากร
title

string

ชื่อคําค้นหาที่ไม่ซ้ํากันซึ่งอยู่ภายในลูกค้า Ads Data Hub รายการเดียวและประเภทคําค้นหา
queryText

string

ข้อความค้นหาที่เขียนใน SQL มาตรฐาน โปรดดู https://cloud.google.com/bigquery/docs/reference/standard-sql/
parameterTypes

map (key: string, value: object (ParameterType))

พารามิเตอร์เพิ่มเติมใดๆ ที่คาดไว้จากการค้นหา จับคู่ชื่ออาร์กิวเมนต์แต่ละรายการกับประเภทอาร์กิวเมนต์

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่าง: { "name": "wrench", "mass": "1.3kg", "count": "3" }
mergeSpec
(deprecated)

object (MergeSpec)

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

enum (QueryState)

สถานะคําค้นหา
updateTime

string (Timestamp format)

เวลาที่อัปเดตการค้นหาครั้งล่าสุด

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดในระดับนาโนวินาทีและอาจใช้ตัวเลขไม่เกิน 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
updateEmail

string

อีเมลของผู้ใช้ที่อัปเดตการค้นหาครั้งล่าสุด
createTime

string (Timestamp format)

เวลาที่สร้างการสืบค้นข้อมูล

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดในระดับนาโนวินาทีและอาจใช้ตัวเลขไม่เกิน 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
createEmail

string

อีเมลของผู้ใช้ที่สร้างคําค้นหา
queryShare[]

object (QueryShare)

ระบุวิธีการแชร์คําค้นหานอกเหนือจากลูกค้า Ads Data Hub ที่เป็นเจ้าของ
ช่อง Union filtered_row วิธีการรวมแถว filtered_row ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
filteredRowSummary

object (FilteredRowSummary)

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

boolean

หากเป็น "จริง" ระบบจะสร้างสรุปแถวที่กรองโดยอัตโนมัติ

ผสานข้อมูลจําเพาะ

ผสานวิธีการสําหรับสคีมาผลการค้นหาการวิเคราะห์

การแสดง JSON 
{
  "columns": {
    string: {
      object (MergeColumn)
    },
    ...
  }
}
ช่อง
columns

map (key: string, value: object (MergeColumn))

วิธีการรวมแต่ละคอลัมน์ โดยแยกตามชื่อ คอลัมน์ที่ขาดไปทั้งหมดจะถือว่าเป็น GSMMO_TYPE_UNSPECIFIED

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่าง: { "name": "wrench", "mass": "1.3kg", "count": "3" }

ผสานคอลัมน์

ผสานคําแนะนําสําหรับคอลัมน์เอาต์พุตเดี่ยว

การแสดง JSON 
{
  "type": enum (MergeType),
  "value": {
    object (ParameterValue)
  }
}
ช่อง
type

enum (MergeType)

วิธีการรวมค่าของคอลัมน์
value

object (ParameterValue)

ค่าคงที่ที่จะใช้ (ใช้ได้สําหรับประเภทการรวม CONSTT เท่านั้น)

ประเภทการรวม

การดําเนินการที่รองรับทั้งหมดสําหรับการผสานคอลัมน์

Enum
MERGE_TYPE_UNSPECIFIED ประเภทการรวมที่ไม่ระบุ ค่าของคอลัมน์ที่รวมกันจะเป็น NULL
CONSTANT แทนที่ค่าคอลัมน์ที่รวมด้วยค่าคงที่ที่กําหนด
SUM ดูผลรวมของค่าคอลัมน์ที่ผสานกัน

สรุปตัวกรองที่กรองแล้ว

ผสานวิธีการสําหรับสคีมาผลการค้นหาการวิเคราะห์

การแสดง JSON 
{
  "columns": {
    string: {
      object (ColumnSummaryRule)
    },
    ...
  }
}
ช่อง
columns

map (key: string, value: object (ColumnSummaryRule))

วิธีการรวมแต่ละคอลัมน์ โดยแยกตามชื่อ คอลัมน์ที่ขาดไปจะถือว่าเป็น Summary_TYPE_UNSPECIFIED

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่าง: { "name": "wrench", "mass": "1.3kg", "count": "3" }

กฎสรุปคอลัมน์

ผสานคําแนะนําสําหรับคอลัมน์เอาต์พุตเดี่ยว

การแสดง JSON 
{
  "type": enum (SummaryType),
  "value": {
    object (ParameterValue)
  }
}
ช่อง
type

enum (SummaryType)

วิธีการรวมค่าของคอลัมน์
value

object (ParameterValue)

ค่าคงที่ที่จะใช้ (ใช้ได้สําหรับประเภทข้อมูลสรุป CONSTT เท่านั้น)

ประเภทข้อมูลสรุป

การดําเนินการที่รองรับทั้งหมดสําหรับการผสานคอลัมน์

Enum
SUMMARY_TYPE_UNSPECIFIED ประเภทข้อมูลสรุปที่ไม่ได้ระบุ ค่าคอลัมน์สรุปจะเป็น NULL
CONSTANT แทนที่ค่าคอลัมน์ที่รวมด้วยค่าคงที่ที่กําหนด
SUM ดูผลรวมของค่าคอลัมน์ที่ผสานกัน

เมธอด

create

 สร้างการค้นหาการวิเคราะห์สําหรับการดําเนินการในภายหลัง

delete

 ลบการค้นหาการวิเคราะห์

get

 เรียกข้อมูลการค้นหาการวิเคราะห์ที่ขอ

list

 แสดงรายการการค้นหาการวิเคราะห์ของลูกค้าที่ระบุ

patch

 อัปเดตการค้นหาการวิเคราะห์ที่มีอยู่

start

 เริ่มการดําเนินการค้นหาการวิเคราะห์ที่เก็บไว้

startTransient

 เริ่มการดําเนินการค้นหาการวิเคราะห์ชั่วคราว

validate

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