REST Resource: customers.analysisQueries

Resource: AnalysisQuery

Menentukan kueri analisis yang dapat dijalankan dalam Ads Data Hub.

Representasi 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.
}
Kolom
name

string

Nama yang mengidentifikasi kueri secara unik. Laporan ini memiliki format customer/[customerId]/analysisQuery/[resource_id], mis. 'customer/123/analysisQuery/abcd1234'. ID resource dibuat oleh server.
title

string

Judul kueri, yang unik dalam satu pelanggan dan jenis kueri Ads Data Hub.
queryText

string

Teks kueri yang ditulis dalam SQL Standar. Lihat https://cloud.google.com/bigquery/docs/reference/standard-sql/.
parameterTypes

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

Parameter tambahan apa pun yang diharapkan oleh kueri. Memetakan setiap nama argumen ke jenis argumennya.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
mergeSpec
(deprecated)

object (MergeSpec)

Petunjuk untuk penggabungan baris. Jika ada, setiap baris yang akan dihapus karena alasan privasi akan digabungkan menjadi satu baris gabungan. Baris gabungan akan berada di output akhir jika baris gabungan memenuhi persyaratan privasi.
queryState

enum (QueryState)

Status kueri.
updateTime

string (Timestamp format)

Waktu kueri terakhir diperbarui.

Stempel waktu dalam format RFC3339 UTC "Zulu" dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
updateEmail

string

Alamat email pengguna yang terakhir memperbarui kueri.
createTime

string (Timestamp format)

Waktu kueri dibuat.

Stempel waktu dalam format RFC3339 UTC "Zulu" dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
createEmail

string

Alamat email pengguna yang membuat kueri.
queryShare[]

object (QueryShare)

Menunjukkan cara kueri dapat dibagikan di luar pelanggan Ads Data Hub yang memiliki kepemilikan.
Kolom union filtered_row. Petunjuk untuk penggabungan baris. filtered_row hanya dapat berupa salah satu dari berikut:
filteredRowSummary

object (FilteredRowSummary)

Menentukan cara menggabungkan baris yang dihapus karena alasan privasi menjadi satu baris gabungan. Baris gabungan akan disertakan dalam output akhir jika baris gabungan memenuhi persyaratan privasi.
generateFilteredRowSummaryAutomatically

boolean

Jika benar, ringkasan baris yang difilter akan dibuat secara otomatis.

MergeSpec

Petunjuk penggabungan untuk skema hasil kueri analisis.

Representasi JSON 
{
  "columns": {
    string: {
      object (MergeColumn)
    },
    ...
  }
}
Kolom
columns

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

Petunjuk untuk menggabungkan setiap kolom, yang dikunci dengan nama. Setiap kolom yang hilang akan diperlakukan sebagai AAudio_TYPE_UNSPECIFIED.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

MergeColumn

Petunjuk penggabungan untuk satu kolom output.

Representasi JSON 
{
  "type": enum (MergeType),
  "value": {
    object (ParameterValue)
  }
}
Kolom
type

enum (MergeType)

Metode yang digunakan untuk menggabungkan nilai untuk kolom.
value

object (ParameterValue)

Nilai konstan yang digunakan (hanya valid untuk jenis penggabungan CONSTANT).

Jenis Penggabungan

Semua operasi yang didukung untuk penggabungan kolom.

Enumerasi
MERGE_TYPE_UNSPECIFIED Jenis penggabungan tidak ditentukan. Nilai kolom gabungan akan menjadi NULL.
CONSTANT Ganti nilai kolom gabungan dengan konstanta yang ditentukan.
SUM Ambil jumlah nilai kolom gabungan.

RingkasanFilteredRow

Petunjuk penggabungan untuk skema hasil kueri analisis.

Representasi JSON 
{
  "columns": {
    string: {
      object (ColumnSummaryRule)
    },
    ...
  }
}
Kolom
columns

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

Petunjuk untuk menggabungkan setiap kolom, yang dikunci dengan nama. Setiap kolom yang hilang akan diperlakukan sebagai Summary_TYPE_UNSPECIFIED.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

KolomColumnRule

Petunjuk penggabungan untuk satu kolom output.

Representasi JSON 
{
  "type": enum (SummaryType),
  "value": {
    object (ParameterValue)
  }
}
Kolom
type

enum (SummaryType)

Metode yang digunakan untuk menggabungkan nilai untuk kolom.
value

object (ParameterValue)

Nilai konstan yang digunakan (hanya valid untuk jenis ringkasan CONSTANT).

JenisRingkasan

Semua operasi yang didukung untuk penggabungan kolom.

Enumerasi
SUMMARY_TYPE_UNSPECIFIED Jenis ringkasan tidak ditentukan. Nilai kolom ringkasan akan menjadi NULL.
CONSTANT Ganti nilai kolom gabungan dengan konstanta yang ditentukan.
SUM Ambil jumlah nilai kolom gabungan.

Metode

create

 Membuat kueri analisis untuk eksekusi berikutnya.

delete

 Menghapus kueri analisis.

get

 Mengambil kueri analisis yang diminta.

list

 Mencantumkan kueri analisis yang dimiliki oleh pelanggan tertentu.

patch

 Memperbarui kueri analisis yang ada.

start

 Memulai eksekusi pada kueri analisis tersimpan.

startTransient

 Memulai eksekusi pada kueri analisis sementara.

validate

 Melakukan pemeriksaan validasi statis pada kueri analisis yang diberikan.