Kuota

Kuota Display & Video 360 API membatasi kecepatan project dalam membuat permintaan ke API.

Ikuti praktik terbaik ini untuk menggunakan kuota API Display & Video 360 Anda dengan lebih baik.

Membuat permintaan di seluruh pengiklan secara bersamaan

Kuota API Display & Video 360 ditetapkan per project dan per pengiklan. Batas kuota project membatasi permintaan yang dibuat oleh project. Kuota pengiklan membatasi permintaan yang dibuat oleh project ke pengiklan.

Untuk menggunakan semua kuota project Anda, buat permintaan di seluruh pengiklan secara bersamaan.

Menggunakan parameter kueri list

Gunakan parameter kueri metode list untuk hanya menyertakan resource yang diinginkan. Lebih sedikit resource memerlukan lebih sedikit permintaan untuk mencantumkan.

Metode list menawarkan tiga parameter utama:

  • pageSize menetapkan jumlah resource yang dapat ditampilkan oleh permintaan. Ukuran halaman default bergantung pada metode. Tetapkan nilai ini ke nilai tertinggi untuk mencantumkan lebih banyak resource per permintaan.
  • filter membatasi resource yang tercantum berdasarkan kriteria yang diberikan. Tetapkan ini untuk mencantumkan hanya sebagian kecil resource. Lihat Permintaan daftar filter untuk mengetahui informasi selengkapnya.
  • orderBy mengurutkan resource yang tercantum berdasarkan properti yang diberikan. Tetapkan ini untuk mengambil batas atas atau bawah daftar resource dengan lebih sedikit permintaan.

Menggunakan fungsi massal dan di seluruh resource

Fungsi massal dan seluruh resource melakukan tugas yang kompleks. Satu permintaan ke metode ini dapat menggantikan beberapa permintaan ke metode lainnya.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat Permintaan Massal.

ID Cache

Banyak tindakan Display & Video 360 API memerlukan ID yang diambil menggunakan API. Contohnya mencakup ID opsi penargetan dan ID audiens Google. Simpan ID secara lokal sehingga Anda tidak perlu terus mengambilnya.

Penggunaan ID untuk resource yang tidak digunakan lagi atau dihapus dapat menampilkan error. Anda harus mengambil ID yang di-cache setiap minggu untuk mengonfirmasi statusnya.

Menggunakan backoff eksponensial

Backoff eksponensial adalah strategi penanganan error. Metode ini mencoba kembali permintaan selama waktu yang semakin lama.

Saat melakukan polling tugas yang berjalan lama, seperti tugas download SDF, strategi backoff eksponensial dapat mengurangi jumlah permintaan yang dikirim.

Contoh kode download SDF kami menggunakan backoff eksponensial dengan library klien kami. Berikut adalah contoh alur backoff eksponensial:

  • Ambil objek Operation dengan permintaan get.
    • Jika done tidak benar, tugas masih berjalan.
    • Tunggu 5 detik + jumlah detik acak, lalu coba lagi permintaan tersebut.
  • Ambil operasi.
    • Jika done tidak benar, tugas masih berjalan.
    • Tunggu 10 detik + jumlah detik acak, lalu coba lagi permintaan tersebut.
  • Ambil operasi.
    • Jika done tidak benar, tugas masih berjalan.
    • Tunggu 20 detik + jumlah detik acak, lalu coba lagi permintaan tersebut.
  • Ambil operasi.
    • Jika done tidak benar, tugas masih berjalan.
    • Tunggu 40 detik + jumlah detik acak, lalu coba lagi permintaan tersebut.
  • Ambil operasi.
    • Jika done tidak benar, tugas masih berjalan.
    • Tunggu 80 detik + jumlah detik acak, lalu coba lagi permintaan tersebut.
  • Lanjutkan pola ini hingga done bernilai benar atau waktu maksimum yang berlalu tercapai.