Method: customers.searchAds360.search

Menampilkan semua baris yang cocok dengan kueri penelusuran.

Daftar error yang ditampilkan: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Permintaan HTTP

POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:search

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang dikueri.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "query": string,
  "pageToken": string,
  "pageSize": integer,
  "validateOnly": boolean,
  "returnTotalResultsCount": boolean,
  "summaryRowSetting": enum (SummaryRowSetting)
}
Kolom
query

string

Wajib. String kueri.
pageToken

string

Token halaman yang akan diambil. Jika tidak ditentukan, halaman pertama hasil akan ditampilkan. Gunakan nilai yang diperoleh dari nextPageToken dalam respons sebelumnya untuk meminta halaman hasil berikutnya.
pageSize

integer

Jumlah elemen yang akan diambil dalam satu halaman. Jika halaman yang diminta terlalu besar, server dapat memutuskan untuk lebih membatasi jumlah resource yang ditampilkan.
validateOnly

boolean

Jika benar, permintaan divalidasi tetapi tidak dieksekusi.
returnTotalResultsCount

boolean

Jika benar, jumlah total hasil yang cocok dengan kueri yang mengabaikan klausa LIMIT akan disertakan dalam respons. Defaultnya adalah false.
summaryRowSetting

enum (SummaryRowSetting)

Menentukan apakah baris ringkasan akan ditampilkan. Secara default, baris ringkasan tidak ditampilkan. Jika diminta, baris ringkasan akan dikirim dalam respons secara otomatis setelah semua hasil kueri lainnya ditampilkan.

Isi respons

Pesan respons untuk SearchAds360Service.Search.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "results": [
    {
      object (SearchAds360Row)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string,
  "fieldMask": string,
  "summaryRow": {
    object (SearchAds360Row)
  },
  "customColumnHeaders": [
    {
      object (CustomColumnHeader)
    }
  ],
  "conversionCustomMetricHeaders": [
    {
      object (ConversionCustomMetricHeader)
    }
  ],
  "conversionCustomDimensionHeaders": [
    {
      object (ConversionCustomDimensionHeader)
    }
  ],
  "rawEventConversionMetricHeaders": [
    {
      object (RawEventConversionMetricHeader)
    }
  ],
  "rawEventConversionDimensionHeaders": [
    {
      object (RawEventConversionDimensionHeader)
    }
  ]
}
Kolom
results[]

object (SearchAds360Row)

Daftar baris yang cocok dengan kueri.
nextPageToken

string

Token penomoran halaman digunakan untuk mengambil halaman hasil berikutnya. Teruskan konten string ini sebagai atribut pageToken dari permintaan berikutnya. nextPageToken tidak ditampilkan untuk halaman terakhir.
totalResultsCount

string (int64 format)

Jumlah total hasil yang cocok dengan kueri yang mengabaikan klausa LIMIT.
fieldMask

string (FieldMask format)

FieldMask yang mewakili kolom apa yang diminta oleh pengguna.

Ini adalah daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".
summaryRow

object (SearchAds360Row)

Baris ringkasan yang berisi ringkasan metrik dalam hasil. Ringkasan metrik berarti agregasi metrik di semua hasil, di sini agregasi dapat berupa jumlah, rata-rata, tarif, dll.
customColumnHeaders[]

object (CustomColumnHeader)

Header kolom kustom dalam hasil.
conversionCustomMetricHeaders[]

object (ConversionCustomMetricHeader)

Header metrik kustom konversi dalam hasil.
conversionCustomDimensionHeaders[]

object (ConversionCustomDimensionHeader)

Header dimensi kustom konversi dalam hasil.
rawEventConversionMetricHeaders[]

object (RawEventConversionMetricHeader)

Header metrik konversi peristiwa mentah dalam hasil.
rawEventConversionDimensionHeaders[]

object (RawEventConversionDimensionHeader)

Header dimensi konversi peristiwa mentah dalam hasil.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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