Pembaruan Kebijakan Penggunaan Resource Google Ads API

Rabu, 1 Mei 2024

Apa yang berubah?

Kami memperbarui kebijakan penggunaan resource Google Ads API untuk membatasi pola kueri GoogleAdsService.Search dan GoogleAdsService.SearchStream yang menggunakan resource API dalam jumlah berlebihan. Jika pola kueri tertentu dibatasi, layanan, metode, dan pola kueri lainnya akan terus berfungsi tanpa terpengaruh.

Mulai sekitar 17 Juni 2024, dan hanya untuk pola kueri yang dibatasi, permintaan akan terpengaruh sebagai berikut:

  • Jika menggunakan API versi v17 atau yang lebih lama, Anda akan menerima error QuotaError.RESOURCE_EXHAUSTED.
  • Jika Anda menggunakan API versi v18 atau yang lebih baru, Anda akan menerima QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION atau QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION, bergantung pada apakah penggunaan resource yang berlebihan tersebut terjadi dalam jangka waktu singkat (beberapa menit) atau jangka waktu lama.

Untuk membantu Anda mengidentifikasi dan memantau laporan yang mahal, kami juga akan menampilkan metrik biaya untuk setiap laporan. Untuk melihat biaya laporan yang berhasil, lihat kolom berikut:

Apa alasan perubahan ini?

Kami melakukan perubahan ini untuk menjaga keandalan dan stabilitas API.

Apa yang harus saya lakukan?

Sebelum 17 Juni 2024, update aplikasi Anda untuk melakukan hal berikut:

  • Menangani kode error baru saat melakukan panggilan GoogleAdsService::Search or GoogleAdsService::SearchStream
    • Jika Anda menggunakan Google Ads API versi v17 atau yang lebih lama, tangani error QuotaError.RESOURCE_EXHAUSTED.
    • Jika Anda menggunakan API versi v18 atau yang lebih baru, tangani error QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION dan QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION.
  • Jika satu atau beberapa pola kueri pelaporan Anda dibatasi, Anda harus meninjau dan memperbaiki pola kueri tersebut. Berikut beberapa cara untuk meningkatkan performa kueri:
    • Jalankan kueri lebih jarang.
    • Gunakan pola atau tampilan kueri yang lebih murah.

Untuk mempelajari lebih lanjut cara mengoptimalkan kueri, lihat mengelola efisiensi data.

  • [Opsional] Gabungkan metrik query_resource_consumption baru ke dalam sistem pemantauan Anda untuk mendeteksi dan menangani kueri baru yang mahal.

Cara mendapatkan bantuan

Jika Anda memiliki pertanyaan tentang perubahan ini atau memerlukan bantuan untuk mengoptimalkan pola kueri tertentu, lihat halaman dukungan Google Ads API untuk mengetahui opsi yang tersedia.

- David Stevens, Product Manager Google Ads API

Label: google-ads-api