Mengambil Objek

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

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

GoogleAdsService dapat menampilkan hasil dengan dua cara:

  • GoogleAdsService.SearchStream menampilkan semua baris dalam satu respons streaming yang lebih efisien untuk kumpulan hasil yang besar (lebih dari 10.000 baris). Hal ini mungkin lebih sesuai jika aplikasi batch Anda ingin mendownload data sebanyak mungkin.
  • GoogleAdsService.Search akan memecah respons besar menjadi halaman hasil yang dapat dikelola. Cara ini mungkin lebih sesuai jika aplikasi interaktif Anda menampilkan halaman hasil dalam satu waktu.

Pelajari paging versus streaming lebih lanjut.

Membuat permintaan

Metode penelusuran memerlukan SearchGoogleAdsRequest, yang terdiri dari atribut berikut:

  • customer_id.
  • query Bahasa Kueri Google Ads yang menunjukkan resource mana yang akan dikueri, atribut, segmen, dan metrik yang akan diambil, serta kondisi yang digunakan untuk membatasi objek mana yang ditampilkan.
  • (Khusus GoogleAdsService.Search) 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 Panduan Bahasa Kueri Google Ads.

Memproses respons

GoogleAdsService menampilkan daftar objek GoogleAdsRow.

Setiap GoogleAdsRow mewakili objek yang ditampilkan oleh kueri, dan terdiri dari serangkaian atribut yang diisi berdasarkan kolom yang diminta dalam klausul SELECT. Atribut yang tidak disertakan dalam klausul 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 sebagai respons untuk kueri yang klausa SELECT-nya tidak menyertakan ad_group_criterion.status. Demikian pula, atribut campaign baris tidak akan diisi jika klausul SELECT tidak menyertakan kolom apa pun dari resource campaign.

Setiap GoogleAdsRow dapat memiliki atribut dan metrik yang berbeda dari baris lain dalam kumpulan hasil yang sama; jadi baris tersebut harus dianggap sebagai objek, bukan baris tetap dari tabel.

Jenis enum tidak diketahui

Resource yang ditampilkan dengan jenis UNKNOWN tidak sepenuhnya didukung dalam versi API tersebut. Resource ini mungkin telah dibuat melalui antarmuka lain seperti UI Google Ads. Anda dapat memilih metrik jika sebuah resource memiliki jenis UNKNOWN, tetapi Anda tidak dapat memutasikan resource melalui API. Contohnya adalah kampanye atau iklan baru yang diperkenalkan di UI, tetapi tidak didukung di versi API yang Anda kueri.

Berikut ini adalah beberapa hal yang harus diperhatikan:

  • Resource dengan jenis UNKNOWN mungkin didukung nanti atau tetap UNKNOWN tanpa batas.
  • Objek baru dengan jenis UNKNOWN dapat muncul kapan saja. Objek ini kompatibel dengan versi lama karena nilai enum sudah tersedia. Kami memperkenalkan resource 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 karena resource tidak lagi didukung secara formal.
  • Resource UNKNOWN mungkin memiliki metrik mendetail terlampir yang dapat Anda kueri.
  • Resource UNKNOWN biasanya sepenuhnya terlihat di UI Google Ads.
  • Resource UNKNOWN umumnya tidak dapat dimutasi.

Segmentasi

Responsnya akan berisi satu GoogleAdsRow untuk setiap kombinasi berikut:

  • instance resource utama yang ditentukan dalam klausul FROM
  • nilai dari setiap kolom segment yang dipilih

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

  • campaign
  • segments.ad_network_type
  • segments.date