Halaman ini diterjemahkan oleh Cloud Translation API.

Bahasa Kueri Google Ads

Bahasa Kueri Google Ads dapat mengkueri Google Ads API untuk

Resource dan atribut, segmen, dan metrik yang terkait menggunakan

GoogleAdsService Penelusuran atau SearchStream

Hasil kueri GoogleAdsService adalah daftar Instance GoogleAdsRow, dengan masing-masing GoogleAdsRow yang merepresentasikan resource. Jika ada atribut atau metrik yang diminta, maka baris juga menyertakan bidang-bidang tersebut. Jika ada segmen yang diminta, juga akan menampilkan baris tambahan untuk setiap tuple resource segmen.

Metadata tentang kolom dan resource yang tersedia di

GoogleAdsFieldService

Layanan ini menyediakan katalog kolom yang dapat dikueri dengan detail tentang kompatibilitas dan jenisnya.

Hasil dari kueri GoogleAdsFieldService adalah daftar Instance GoogleAdsField, dengan masing-masing GoogleAdsField yang berisi detail tentang kolom yang diminta.

Membuat kueri atribut resource

Di bawah ini adalah kueri dasar untuk atribut sumber daya kampanye, yang menggambarkan cara untuk menampilkan ID, nama, dan status kampanye:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

Kueri ini mengurutkan berdasarkan ID kampanye. Setiap GoogleAdsRow yang dihasilkan akan mewakili objek campaign yang diisi dengan kolom yang dipilih (termasuk kolom yang ditentukan resource_name kampanye).

Untuk mengetahui kolom lain yang tersedia untuk kueri kampanye, lihat Dokumentasi referensi Campaign.

Membuat kueri untuk metrik

Di samping atribut yang dipilih untuk sumber daya tertentu, Anda juga dapat melakukan kueri metrik terkait:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

Kueri ini memfilter hanya untuk kampanye yang memiliki status PAUSED dan memiliki lebih dari 1.000 tayangan, sambil mengurutkan berdasarkan ID kampanye. Masing-masing GoogleAdsRow yang dihasilkan akan memiliki kolom metrics yang diisi dengan metrik yang dipilih.

Untuk mengetahui daftar metrik yang dapat dikueri, buka Metrics dokumentasi.

Membuat kueri untuk segmen

Di samping atribut yang dipilih untuk sumber daya tertentu, Anda juga dapat melakukan kueri segmen terkait:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id

Serupa dengan kueri untuk metrik, kueri ini hanya memfilter kampanye yang memiliki status PAUSED dan memiliki lebih dari 1.000 tayangan; namun, kueri ini menyegmentasikan data berdasarkan tanggal. Ini mengarah pada setiap hasil GoogleAdsRow yang mewakili tuple kampanye dan tanggal Segment. Penting penting untuk diperhatikan bahwa segmentasi memisahkan metrik yang dipilih, yang dikelompokkan berdasarkan segmen dalam klausa SELECT.

Untuk mengetahui daftar segmen yang dapat dikueri, buka Segments dokumentasi.

Membuat kueri atribut resource terkait

Di kueri untuk sumber daya tertentu, Anda mungkin dapat bergabung dengan sumber daya terkait resource jika tersedia. Resource terkait ini dikenal sebagai "atribusi resource". Anda bisa bergabung dengan resource yang diatribusikan secara implisit dengan memilih di kueri Anda.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

Kueri ini tidak hanya memilih atribut kampanye, tetapi juga menarik data terkait dari setiap kampanye yang dipilih. Setiap GoogleAdsRow yang dihasilkan mewakili objek campaign yang diisi dengan atribut kampanye yang dipilih serta atribut strategi bidding yang dipilih bidding_strategy.name.

Untuk mengetahui resource atribusi apa yang tersedia untuk kueri kampanye, lihat dokumentasi referensi Campaign.

Mutasi berdasarkan hasil kueri

Saat membuat kueri untuk sumber daya yang diberikan, Anda bisa segera mengambil sumber daya yang dikembalikan sebagai objek, mengubahnya, dan mengirimkannya kembali ke metode mutate di mana layanan resource. Berikut adalah contoh alur kerja:

Jalankan kueri untuk semua kampanye yang saat ini PAUSED dan memiliki tayangan lebih besar dari 1.000.
Dapatkan objek Campaign dari kolom campaign dari setiap GoogleAdsRow di responsnya.
Ubah status setiap kampanye dari PAUSED menjadi ENABLED.
Panggil CampaignService.MutateCampaigns dengan kampanye yang diubah untuk memperbaruinya.

Metadata kolom

Kueri yang dikirim ke GoogleAdsFieldService dimaksudkan untuk mengambil metadata kolom. Informasi ini dapat digunakan untuk memahami bagaimana {i>field<i} dapat digunakan bersama-sama dalam kueri. Karena data tersedia dari API dan memberikan informasi yang diperlukan metadata yang diperlukan untuk memvalidasi atau membangun kueri, hal ini memungkinkan developer secara terprogram. Berikut adalah kueri umum untuk metadata:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

Anda dapat mengganti <INSERT_RESOURCE_OR_FIELD> di kueri ini dengan resource (seperti customer atau campaign) atau kolom (seperti campaign.id, metrics.impressions, atau ad_group.id).

Untuk mengetahui daftar kolom yang dapat dikueri, lihat GoogleAdsField dokumentasi.

Contoh kode

Library klien memiliki contoh penggunaan Bahasa Kueri Google Ads di GoogleAdsService. Folder operasi dasar memiliki contoh seperti GetCampaigns, GetKeywords, dan SearchForGoogleAdsFields. Folder pelaporan memiliki contoh GetKeywordStats.

Berikutnya

Tata bahasa kueri