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 ini.
Batas Kueri
Batas 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 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 dihitung terhadap Batas Harian |
---|---|
Operasi: Search
Jumlah: 53 grup iklan
Layanan: |
1 |
Operasi: SearchStream
Jumlah: 45 kampanye
Layanan: |
1 |
Permintaan yang melanggar batas ini 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,
berapa pun 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 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 dipaginasi (misalnya, permintaan yang berisi next_page_token
yang valid) tidak dihitung terhadap 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 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 penomoran halaman, lihat Paging melalui hasil.
Permintaan yang menampilkan pengecualian API
Permintaan yang ditolak dengan SearchAds360Failure
akan 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 tersebut tidak akan pernah sampai ke layanan. Contohnya adalah kegagalan konektivitas jaringan.
Jenis batasan 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 lainnya.
Saat membuat kueri Bahasa Kueri Search Ads 360, jumlah item maksimum dalam klausa IN
adalah 20.000. Jika Anda melebihi batas tersebut, error FILTER_HAS_TOO_MANY_VALUES
akan ditampilkan.