Search Ads 360 Reporting API menerapkan batasan pada operasi API untuk memastikan performa sistem yang optimal bagi semua pengguna.
Harga
Penggunaan Search Ads 360 Reporting API disertakan dalam harga Search Ads 360 secara keseluruhan. Tidak ada biaya tambahan untuk menggunakan API ini.
Batas Kueri
Batasan berikut berlaku untuk operasi kueri yang dilakukan melalui metode Penelusuran 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 dibuat per project Google Cloud.
Satu kueri atau laporan dihitung sebagai satu operasi, terlepas dari hasilnya
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 dihitung terhadap Batas Harian |
|---|---|
Operasi: Search
Jumlah: 53 grup iklan
Layanan: |
1 |
Operasi: SearchStream
Jumlah: 45 kampanye
Layanan: |
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 sebesar 4 MB.
Respons tidak boleh melebihi batas ini. Misalnya, permintaan penelusuran yang menyertakan banyak kolom dapat menghasilkan respons yang ukurannya melebihi 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 dipaginasi (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 mengurangi kuota operasi harian.
Permintaan yang diberi nomor halaman, seperti permintaan penelusuran, juga tunduk kepada
batasan Page size cannot exceed 10,000 rows dan akan ditolak jika melanggar
batas ini, dengan error:
INVALID_PAGE_SIZE.
Untuk detail selengkapnya tentang penomoran halaman, lihat Hasil Paging melalui.
Permintaan yang menampilkan pengecualian API
Permintaan yang ditolak dengan
SearchAds360Failure tetap mengurangi
kuota operasi harian pengguna.
Permintaan yang gagal tetapi tidak menampilkan
SearchAds360Failure, seperti dari error di
tingkat jaringan, tidak akan mengurangi 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 menyebabkan 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.