Mengambil objek

GoogleAdsService adalah objek terpadu pengambilan dan pelaporan Google Ads API. Layanan ini memiliki metode yang:

  • Mengambil atribut objek tertentu.
  • Mengambil metrik performa untuk objek berdasarkan rentang tanggal.
  • Mengurutkan objek berdasarkan atributnya.
  • Gunakan kondisi untuk menunjukkan objek mana yang ingin Anda tampilkan dalam respons.
  • Batasi jumlah objek yang ditampilkan.

GoogleAdsService dapat menampilkan hasil di dua cara:

  • GoogleAdsService.SearchStream mengembalikan semua baris dalam satu respons streaming, yang lebih efisien untuk set hasil besar (lebih dari 10.000 baris). Ini mungkin lebih tepat jika aplikasi batch Anda ingin mengunduh data sebanyak sebaik mungkin.
  • GoogleAdsService.Search putus respons besar menjadi halaman hasil yang dapat dikelola. Ini bisa lebih sesuai jika aplikasi interaktif Anda menampilkan halaman hasil pada baik.

Pelajari lebih lanjut paging versus streaming.

Buat permintaan

Metode pencarian memerlukan SearchGoogleAdsRequest, yang terdiri dari dari atribut berikut:

  • customer_id
  • Bahasa Kueri Google Ads query yang menunjukkan resource mana yang akan dikueri, atribut, segmen, dan metrik yang akan diambil, serta kondisi yang akan digunakan untuk membatasi objek mana yang ditampilkan
  • (Khusus GoogleAdsService.Search) A page_size untuk menunjukkan jumlah objek yang akan ditampilkan dalam satu respons saat menggunakan paging.
  • (Khusus GoogleAdsService.Search) page_token opsional untuk mengambil batch hasil berikutnya saat menggunakan paging.

Untuk informasi lebih lanjut tentang Bahasa Kueri Google Ads, lihat Bahasa Kueri Google Ads panduan kami.

Memproses respons

GoogleAdsService menampilkan daftar Objek GoogleAdsRow.

Setiap GoogleAdsRow mewakili objek yang ditampilkan oleh kueri, dan terdiri dari adalah kumpulan atribut yang diisi berdasarkan {i>field<i} yang diminta dalam Klausa SELECT. Atribut yang tidak disertakan dalam klausa SELECT tidak diisi pada objek GoogleAdsRow dalam respons.

Misalnya, meskipun ad_group_criterion memiliki atribut status, Kolom status dari atribut ad_group_criterion baris tidak diisi dalam respons untuk kueri yang klausa SELECT tidak menyertakan ad_group_criterion.status. Demikian pula, atribut campaign pada baris ini tidak diisi jika klausa SELECT tidak menyertakan kolom apa pun dari Resource campaign.

Setiap GoogleAdsRow dapat memiliki atribut dan metrik yang berbeda dari baris lain dalam set hasil yang sama; jadi baris harus dilihat sebagai objek daripada baris-baris tetap pada suatu tabel.

Jenis enum TIDAK DIKETAHUI

Resource yang ditampilkan dengan jenis UNKNOWN tidak sepenuhnya didukung di versi API tersebut. Resource ini dapat dibuat melalui antarmuka seperti UI Google Ads. Anda dapat memilih metrik jika resource memiliki jenis UNKNOWN, tetapi Anda tidak dapat mengubah resource melalui API. Channel contohnya adalah kampanye atau iklan baru yang diperkenalkan di UI, namun tidak didukung dalam versi API yang Anda kuerikan.

Berikut beberapa pertimbangan yang harus diperhatikan:

  • Resource dengan jenis UNKNOWN dapat didukung nanti atau tetap UNKNOWN tanpa batas waktu.
  • Objek baru dengan jenis UNKNOWN dapat muncul kapan saja. Objek ini kompatibel dengan versi sebelumnya karena nilai enum sudah tersedia. Sumber daya diperkenalkan dengan perubahan ini saat tersedia sehingga Anda memiliki tampilan akun yang akurat. Resource UNKNOWN dapat muncul karena aktivitas baru di akun Anda melalui antarmuka lain, atau saat resource tidak lagi didukung.
  • UNKNOWN resource dapat memiliki metrik detail yang terlampir padanya dapat dikueri.
  • Resource UNKNOWN biasanya terlihat sepenuhnya di UI Google Ads.
  • Resource UNKNOWN umumnya tidak dapat diubah.

Segmentasi

Respons akan berisi satu GoogleAdsRow untuk setiap kombinasi berikut ini:

  • Instance resource utama yang ditentukan dalam klausa FROM
  • Nilai dari setiap kolom segment yang dipilih

Misalnya, respons untuk kueri yang memilih FROM campaign dan memiliki segments.ad_network_type dan segments.date dalam klausa SELECT akan berisi satu baris untuk setiap kombinasi berikut:

  • campaign
  • segments.ad_network_type
  • segments.date

Hasil secara implisit disegmentasikan oleh setiap instance resource utama, bukan menurut nilai masing-masing {i>field<i} yang dipilih. Misalnya,

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

menghasilkan satu baris per kampanye, bukan satu baris per nilai nilai yang berbeda Kolom campaign.status.

Sebelumnya
Mengubah dan memeriksa objek
Berikutnya
Metadata resource