Struktur kueri

Kueri untuk kolom metrik dan segmen dapat dikirim ke reports.search . Untuk membuat kueri di Bahasa Kueri Merchant Center, Anda harus terlebih dahulu menulis kueri menggunakan tata bahasa bahasa. Sebuah kueri terdiri dari sejumlah klausa:

  • SELECT
  • FROM
  • WHERE
  • ORDER BY
  • LIMIT

Klausa menggunakan nama kolom, nama tabel, operator, kondisi, dan pemesanan untuk membantu Anda memilih data yang diinginkan. Setelah digabungkan menjadi satu permintaan dapat dibuat menggunakan Google Content API for Shopping. Mari kita lihat bagaimana masing-masing dapat digunakan.

Klausul

PILIH

Klausa SELECT menentukan kumpulan kolom yang akan diambil dalam permintaan. SELECT mengambil daftar kolom dan metrik segmen yang dipisahkan koma, dalam responsnya. Klausa SELECT wajib dalam kueri.

Berikut adalah contoh kueri yang memilih metrik klik dari tabel tertentu:

SELECT
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

Anda juga dapat mengkueri berbagai jenis kolom dalam satu permintaan:

SELECT
  segments.date,
  segments.program,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
  • Kolom segmen

    • segments.date
    • segments.program
  • Metrik

    • metrics.impressions
    • metrics.clicks

Beberapa kolom tidak diizinkan dalam klausa SELECT karena hal berikut batasan:

  • Membuat kueri kolom segmen yang tidak memiliki setidaknya satu kolom metrik.

Informasi yang terkait dengan kondisi di atas dapat ditemukan dalam dokumen referensi kami.

FROM

Klausa FROM menentukan tabel tempat mengambil data dalam permintaan. Tujuan tabel di klausa FROM menentukan kolom yang dapat digunakan oleh semua elemen lain klausa untuk kueri yang ditentukan. Hanya satu tabel yang dapat ditentukan dalam Klausa FROM. Saat ini, hanya tabel MerchantPerformanceView yang didukung. Klausa FROM diperlukan dalam kueri untuk metode search pada Layanan reports.

WHERE

Klausa WHERE menentukan kondisi yang akan diterapkan saat memfilter data untuk permintaan. Saat menggunakan klausa WHERE, satu atau beberapa kondisi dapat ditentukan menggunakan AND untuk memisahkannya. Setiap kondisi harus mengikuti pola field_name Operator value. Semua kolom segmen dapat digunakan di WHERE tetapi kolom metrik harus ditentukan dalam klausa SELECT digunakan dalam klausa WHERE. Klausa WHERE diperlukan dalam kueri, karena Anda harus selalu menentukan rentang tanggal yang Anda inginkan data performa yang ditampilkan.

Berikut adalah contoh penggunaan WHERE untuk menampilkan metrik dari waktu tertentu periode:

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

Anda dapat menggabungkan beberapa kondisi untuk memfilter data. Contoh ini akan mengembalikan jumlah klik per penawaran untuk program SHOPPING_ADS dengan klik > 100 dalam periode 30 hari yang ditentukan.

SELECT
  segments.offer_id,
  segments.program,
  metrics.clicks
FROM MerchantPerformanceView
WHERE metrics.clicks > 100
  AND segments.program = SHOPPING_ADS
  AND segments.date BETWEEN 2020-08-01 AND 2020-08-31;

Dalam kueri berikut, Anda akan melihat bahwa segments.date dipilih. Terlepas dari apakah Anda memilih segments.date, rentang tanggal yang terbatas di Klausa WHERE harus selalu disediakan untuk mengambil data performa.

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

Saat memfilter, kepekaan huruf besar/kecil operator Anda penting untuk diperhatikan saat ini.

Untuk mengetahui daftar lengkap operator, lihat tata bahasa bahasa.

ORDER BY

Klausa ORDER BY menentukan urutan hasil dikembalikan. Hal ini memungkinkan Anda untuk mengatur data dalam urutan menaik atau menurun. berdasarkan nama kolom. Setiap pengurutan ditetapkan sebagai field_name yang diikuti dengan ASC atau DESC. Jika ASC atau DESC tidak ditentukan, pesanan akan ditetapkan secara default ke ASC. Hanya kolom yang ditentukan dalam klausa SELECT yang dapat digunakan di Klausa ORDER BY. Klausa ORDER BY bersifat opsional dalam kueri.

Kueri berikut mengurutkan baris yang dikembalikan berdasarkan jumlah klik dari yang tertinggi hingga terendah:

SELECT
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY metrics.clicks DESC

Anda dapat menentukan beberapa kolom dalam klausa ORDER BY menggunakan karakter yang dipisahkan koma daftar. Pengurutan akan terjadi pada urutan yang sama seperti yang ditentukan dalam kueri. Misalnya, dalam kueri{i> <i}ini, hasilnya akan diurutkan dalam urutan menaik berdasarkan offer_id, lalu dalam urutan menurun berdasarkan jumlah tayangan, lalu dalam urut menurun berdasarkan jumlah klik:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY
  segments.offer_id,
  metrics.impressions DESC,
  metrics.clicks DESC

LIMIT

Klausa LIMIT memungkinkan Anda menentukan jumlah hasil yang akan ditampilkan. Fungsi ini berguna jika Anda hanya tertarik pada ringkasan.

Misalnya, LIMIT dapat digunakan untuk membatasi jumlah total hasil untuk kueri berikut:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY metrics.impressions DESC
LIMIT 50