Search Ads 360 Reporting API menerapkan batas pada operasi API untuk memastikan performa sistem yang optimal bagi semua pengguna.
Harga
Penggunaan Search Ads 360 Reporting API disertakan dalam harga keseluruhan Search Ads 360. Tidak ada biaya tambahan untuk menggunakan API.
Batas Kueri
Batas berikut berlaku untuk operasi kueri yang dilakukan melalui metode Search atau SearchStream.
- 3.000 kueri per menit per project per pengguna
- 3.000 kueri per menit per project
- 150.000 kueri per hari per project
Batas operasi API harian
Batas penggunaan API harian didasarkan pada jumlah operasi API yang dilakukan per project Google Cloud.
Satu kueri atau laporan dihitung sebagai satu operasi, terlepas dari hasil yang di-streaming melalui
SearchAds360Service.SearchStream
atau di-page dari panggilan
SearchAds360Service.Search. Pelajari lebih lanjut.
Tabel berikut memberikan beberapa contoh akuntansi:
| Permintaan API | Operasi yang diperhitungkan dalam Batas Harian |
|---|---|
Operasi: Search
Jumlah: 53 grup iklan Layanan: SearchAds360Service
|
1 |
Operasi: SearchStream
Jumlah: 45 kampanye Layanan: SearchAds360Service
|
1 |
Permintaan yang melanggar batas ini akan ditolak dengan error:
RESOURCE_EXHAUSTED.
Telusuri permintaan
Permintaan Search atau SearchStream dihitung sebagai satu operasi terhadap kuota operasi harian pengguna. Satu permintaan SearchStream dihitung sebagai satu operasi API
terlepas dari jumlah batch.
Batasan gRPC
Semua library klien Search Ads 360 Reporting API menggunakan gRPC untuk membuat permintaan dan respons. Secara default, gRPC memiliki ukuran pesan 4 MB.
Respons tidak boleh melebihi batas ini. Misalnya, permintaan penelusuran yang mencakup banyak kolom dapat menghasilkan respons yang berukuran lebih dari 4 MB. Untuk menghindari batas ini, Anda dapat mengurangi jumlah kolom yang dipilih, mengurangi ukuran halaman, atau menggunakan streaming.
Permintaan yang melanggar batasan ini tidak akan menghasilkan
SearchAds360Error,
tetapi akan menghasilkan error gRPC 429 Resource Exhausted. Lihat
daftar kode dan pesan error gRPC.
Permintaan yang dipaginasi
Permintaan yang di-page (misalnya, permintaan yang berisi
next_page_token yang valid) tidak dihitung dalam kuota operasi harian pengguna.
Namun, permintaan penomoran halaman yang berisi token halaman yang sudah tidak berlaku atau tidak valid akan menghasilkan pengecualian dan akan dihitung dalam kuota operasi harian.
Permintaan yang di-pagination, seperti permintaan penelusuran, juga tunduk pada batasan Page size cannot exceed 10,000 rows dan ditolak jika melanggar batas ini, dengan error: INVALID_PAGE_SIZE.
Untuk mengetahui detail selengkapnya tentang penomoran halaman, lihat bagian Melakukan paging melalui hasil.
Permintaan yang menampilkan pengecualian API
Permintaan yang ditolak dengan
SearchAds360Failure
tetap dihitung dalam kuota operasi harian pengguna.
Permintaan yang gagal tetapi tidak menampilkan
SearchAds360Failure,
seperti dari error di tingkat jaringan, tidak akan dihitung dalam kuota operasi harian pengguna karena permintaan tidak akan pernah mencapai layanan. Contohnya adalah kegagalan konektivitas jaringan.
Jenis batas lainnya
Kolom berulang, seperti daftar operasi, yang memiliki terlalu banyak item dalam
permintaan dapat menimbulkan error:
REQUEST_SIZE_LIMIT_EXCEEDED.
Pesan error yang sama ini juga dapat disebabkan oleh masalah lain.
Saat membuat kueri Bahasa Kueri Search Ads 360,
jumlah maksimum item dalam klausa IN adalah 20.000. Jika Anda melebihi batas tersebut, error FILTER_HAS_TOO_MANY_VALUES akan ditampilkan.