Search Ads 360 Reporting API versi baru kini tersedia. Bergabunglah dengan grup Google searchads-api-announcements untuk terus mendapatkan informasi terbaru tentang peningkatan dan rilis mendatang.

Halaman ini diterjemahkan oleh Cloud Translation API.

Harga, Batas API, dan Kuota

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-paging dari panggilan SearchAds360Service.Search. Pelajari lebih lanjut.

Tabel berikut memberikan beberapa contoh akuntansi:

Permintaan API Operasi dihitung terhadap Batas Harian

Permintaan API	Operasi dihitung terhadap Batas Harian
Operasi: `Search` Jumlah: 53 grup iklan Layanan: `SearchAds360Service`	1
Operasi: `SearchStream` Jumlah: 45 kampanye Layanan: `SearchAds360Service`	1

Operasi: Search

Jumlah: 53 grup iklan

Layanan: SearchAds360Service

Operasi: SearchStream

Jumlah: 45 kampanye

Layanan: SearchAds360Service

Permintaan yang melanggar batas ini akan ditolak dengan error: RESOURCE_EXHAUSTED.

Permintaan penelusuran

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 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 di-paging

Permintaan yang di-paging (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 penomoran 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 Melakukan 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 tidak akan pernah menjangkau 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.