Batas Penggunaan

Batas penggunaan melindungi infrastruktur Google dari proses otomatis yang menggunakan Display & Video 360 API dengan cara yang tidak tepat. Kebijakan ini memastikan bahwa tindakan satu developer tidak dapat berdampak negatif pada komunitas yang lebih besar.

Batas kuota permintaan API

Display & Video 360 API menggunakan dua jenis batas:

  • Total batas kuota, yang dihitung berdasarkan semua permintaan yang relevan.
  • Batas kuota tulis, yang diperhitungkan oleh semua permintaan relevan yang dibuat untuk menulis metode. Metode tulis ditentukan sebagai metode—seperti create, patch, delete, atau bulkEdit—yang mengubah resource. Perhatikan bahwa beberapa metode menggunakan lebih banyak kuota tulis daripada metode lainnya.

Jika project Anda melebihi salah satu batas ini, pembatasan dapat terjadi.

Batas kuota di seluruh project

Batas kuota default berikut digunakan bersama oleh semua resource dan metode Display & Video 360 API:

  • Total permintaan per menit per project: 1500
  • Permintaan tulis per menit per project: 700

Batas kuota permintaan khusus pengiklan

Metode yang menentukan ID pengiklan di URL permintaan akan mengurangi batas kuota "per pengiklan per project" tambahan.

Semua permintaan dengan ID pengiklan yang ditentukan di jalur URL-nya—seperti permintaan ke layanan advertisers.lineItems, advertisers.creatives, atau advertisers.channels—akan mengurangi batas kuota berikut:

  • Total permintaan per menit per pengiklan per project: 300
  • Permintaan tulis per menit per pengiklan per project: 150

Metode yang intensif menulis

Metode API berikut intensif penulisan, yang berarti metode tersebut menggunakan resource produk dalam jumlah yang signifikan dan, akibatnya, menggunakan lebih banyak kuota permintaan tulis daripada permintaan tulis lainnya.

Permintaan yang dibuat ke metode yang intensif menulis dihitung sebagai 5 kueri tulis saat menghitung penggunaan kuota permintaan tulis. Misalnya, 100 permintaan tulis standar dan 21 permintaan intensif tulis (tidak satu pun yang menentukan pengiklan) yang dilakukan dalam satu menit akan dihitung sebagai 205 kueri tulis (100 + (21 * 5) = 205) dan akan melebihi batas kuota permintaan umum yang ada sebesar 200 kueri tulis per menit.

Metode berikut dianggap intensif operasi tulis:

Melampaui batas kuota

Jika permintaan Anda gagal karena melebihi batas permintaan API, API akan menampilkan kode status HTTP dan alasan error. Selain itu, isi respons berisi deskripsi mendetail tentang hal yang menyebabkan error.

Daftar berikut menunjukkan kemungkinan error dan tindakan yang direkomendasikan untuk kegagalan permintaan yang disebabkan oleh melampaui batas permintaan API.

Kode PPK Pesan Tindakan yang Disarankan
429 RESOURCE_EXHAUSTED Resource telah habis (misalnya, periksa kuota). Periksa penggunaan Anda dari Konsol Google API dan ubah alur kerja Anda untuk lebih memparalelkan permintaan yang dibuat di bawah pengiklan yang berbeda atau secara umum memperlambat kecepatan Anda mengirim permintaan.

Peningkatan tidak dapat diminta untuk batas kuota API Display & Video 360.