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 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-paging dari panggilan
SearchAds360Service.Search. Pelajari lebih lanjut.
Tabel berikut memberikan beberapa contoh akuntansi:
| Permintaan API | Operasi yang dihitung terhadap 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 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 di-paging
Permintaan yang di-paging (misalnya, permintaan yang berisi next_page_token yang valid) tidak dihitung terhadap kuota operasi harian pengguna.
Namun, permintaan pagination yang berisi token halaman yang tidak valid atau telah habis masa berlakunya akan menghasilkan pengecualian dan akan dihitung terhadap kuota operasi harian.
Permintaan yang di-paging, seperti permintaan penelusuran, juga tunduk pada batasan
Page size cannot exceed 10,000 rows dan akan ditolak jika melanggar
batas ini, dengan error:
INVALID_PAGE_SIZE.
Untuk mengetahui detail selengkapnya tentang pagination, lihat Melakukan paging melalui hasil.
Permintaan yang menampilkan pengecualian API
Permintaan yang ditolak dengan a
SearchAds360Failure
tetap dihitung terhadap kuota operasi harian pengguna.
Permintaan yang gagal tetapi tidak menampilkan
SearchAds360Failure,
seperti dari error di tingkat jaringan, tidak akan dihitung terhadap kuota operasi harian
pengguna karena permintaan tidak akan pernah mencapai layanan. Contohnya adalah kegagalan konektivitas jaringan.
Jenis batasan 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 akan ditampilkan.FILTER_HAS_TOO_MANY_VALUES