Batas Penggunaan

Batas penggunaan melindungi infrastruktur Google dari proses otomatis yang menggunakan Display & Video 360 API dengan cara yang tidak tepat. Solusi 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 oleh semua permintaan terkait.
  • Batas kuota penulisan, yang dihitung 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 yang lain.

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

Batas kuota tingkat 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 dalam URL permintaan akan dihitung dalam batas kuota tambahan "per pengiklan per project".

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 ini intensif operasi tulis, artinya metode tersebut menggunakan resource produk dalam jumlah yang signifikan, dan akibatnya, memakai lebih banyak kuota permintaan tulis daripada permintaan tulis lainnya.

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

Metode berikut dianggap intensif menulis:

Melebihi batas kuota

Jika permintaan Anda gagal karena melampaui batas permintaan API, API akan menampilkan kode status HTTP dan alasan error-nya. Selain itu, isi respons berisi deskripsi mendetail tentang penyebab error.

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

Code RPC Pesan Tindakan yang Disarankan
429 RESOURCE_EXHAUSTED Resource telah habis (misalnya, memeriksa kuota). Periksa penggunaan Anda dari Konsol API Google dan ubah alur kerja Anda untuk memparalelkan permintaan yang dibuat di berbagai pengiklan dengan lebih baik atau memperlambat kecepatan pengiriman permintaan secara lebih umum.

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