Google Ads API menerapkan batasan pada operasi API, seperti jumlah operasi yang dapat dikirim dalam satu permintaan mutate. Tabel di bawah ini merangkum beberapa batasan dan kuota yang penting untuk diperhatikan.
Jenis Permintaan, Batasan, dan Kode Error | |||
---|---|---|---|
Permintaan yang dipaginasi | 10.000 baris per halaman |
INVALID_PAGE_SIZE
|
|
Operasi dengan Akses Dasar | 15.000 operasi API per hari |
RESOURCE_EXHAUSTED
|
|
Mutasi permintaan | 10.000 operasi per permintaan |
TOO_MANY_MUTATE_OPERATIONS
|
|
Permintaan Layanan Perencanaan | 1 QPS |
RESOURCE_EXHAUSTED
|
|
Permintaan Layanan Upload Konversi | 2.000 konversi per permintaan |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
|
Permintaan Layanan Anggaran Akun dan Penagihan | 1 operasi per permintaan mutasi |
TOO_MANY_MUTATE_OPERATIONS
|
Batas operasi API harian
Batas penggunaan API harian didasarkan pada jumlah API operasi yang dibuat per token developer. API adalah jumlah total permintaan {i> get <i}dan operasi mutasi. Batas untuk operasi API harian bergantung pada tingkat akses token developer. Tujuan Panduan Tingkat Akses dan Penggunaan yang Diizinkan menguraikan batas operasi API spesifik untuk setiap tingkat akses.
Permintaan yang melanggar batas ini ditolak dengan error:
RESOURCE_EXHAUSTED
.
Batasan gRPC
Semua library klien Google Ads API menggunakan gRPC untuk membuat permintaan dan respons. Secara default, gRPC memiliki 4 MB, tetapi pustaka klien kita menyetel ukuran pesan maksimal ke 64 MB untuk meningkatkan efisiensi.
Respons tidak boleh melebihi batas ini. Misalnya, permintaan penelusuran yang mencakup banyak isian yang dapat menghasilkan respons berukuran melebihi 64 MB. Kepada menghindari batas ini, Anda dapat mengurangi jumlah bidang yang dipilih, mengurangi ukuran, atau gunakan streaming. Untuk mutasi, kirim lebih sedikit operasi per permintaan.
Permintaan yang melanggar batasan ini tidak akan menghasilkan
GoogleAdsError
, tetapi akan membuat
429 Resource Exhausted
error gRPC. Lihat daftar kode error gRPC dan
pesan.
Mutasi permintaan
Selain menghitung kuota operasi harian pengguna, model permintaan tidak boleh berisi lebih dari 10.000 operasi per permintaan.
Permintaan yang melanggar batasan ini ditolak dengan error:
TOO_MANY_MUTATE_OPERATIONS
.
Batasan dan pertimbangan tambahan untuk layanan dan jenis permintaan tertentu diuraikan di bawah ini.
Telusuri permintaan
Permintaan Search
atau SearchStream
dihitung sebagai satu operasi terhadap metode
kuota operasi harian. Satu permintaan SearchStream
dihitung sebagai satu operasi API
terlepas dari jumlah batch.
Permintaan yang dipaginasi
Permintaan yang dipaginasi (misalnya, permintaan yang berisi permintaan
next_page_token
) tidak dihitung dalam kuota operasi harian pengguna.
Namun, permintaan penomoran halaman yang
berisi token halaman yang sudah tidak berlaku atau tidak valid
membuat pengecualian dan akan mengurangi kuota operasi harian.
Permintaan yang diberi nomor halaman, seperti permintaan penelusuran, juga tunduk kepada
Pembatasan sebesar Page size cannot exceed 10,000 rows
dan akan ditolak jika melanggar
batasan ini, dengan error:
INVALID_PAGE_SIZE
.
Untuk detail selengkapnya tentang penomoran halaman, lihat Paging melalui hasil penelusuran.
Jenis permintaan lainnya
Permintaan yang bukan permintaan Get
, Mutate
, Search
, atau SearchStream
dihitung sebagai satu operasi terhadap kuota operasi harian pengguna.
Beberapa contoh permintaan tersebut termasuk:
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
Permintaan yang menampilkan pengecualian API
Permintaan yang ditolak dengan
GoogleAdsFailure
masih diperhitungkan terhadap
kuota operasi harian pengguna.
Permintaan yang gagal, tetapi tidak menampilkan
GoogleAdsFailure
, seperti dari error pada
di tingkat jaringan, tidak akan mengurangi kuota operasi harian pengguna
karena permintaan tidak pernah
sampai ke layanan. Contohnya adalah
kegagalan konektivitas jaringan.
Jasa perencanaan
Karena biaya dan kerumitan, metode Layanan perencanaan yang tercantum di bawah ini adalah tunduk pada batas terpisah dari jenis permintaan lainnya.
Dibatasi hingga 1 permintaan per detik per CID:
KeywordPlanIdeaService.GenerateKeywordIdeas
KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
Permintaan yang melanggar batasan ini ditolak dengan error:
RESOURCE_EXHAUSTED
.1 QPS dihitung sebagai 60 permintaan per 60 detik.
Dibatasi hingga 2 permintaan per detik per CID:
Perhatikan batas ini saat membuat rencana kata kunci.
Objek Rencana Kata Kunci | Jumlah Maksimum |
---|---|
KeywordPlan per akun |
10.000 |
KeywordPlanAdGroup per KeywordPlan |
200 |
KeywordPlanAdGroupKeyword per KeywordPlan |
10.000 |
KeywordPlanCampaignKeyword (kata kunci negatif) |
1.000 |
KeywordPlanCampaign per KeywordPlan |
1 |
Layanan upload konversi
Dibatasi hingga 2.000 konversi panggilan atau klik per permintaan:
Permintaan yang melanggar batas ini ditolak dengan error:
TOO_MANY_CONVERSIONS_IN_REQUEST
.
Layanan upload penyesuaian konversi
Dibatasi hingga 2.000 penyesuaian konversi per permintaan:
Permintaan yang melanggar batas ini ditolak dengan error:
TOO_MANY_ADJUSTMENTS_IN_REQUEST
.
Layanan anggaran akun dan penagihan
Mutasi hanya dapat dilakukan pada akun yang dikonfigurasi untuk invoice bulanan.
Permintaan yang melanggar batasan ini ditolak dengan error:
MUTATE_NOT_ALLOWED
.Hanya operasi 1 yang diizinkan untuk permintaan mutasi.
Permintaan yang melanggar batasan ini ditolak dengan error:
TOO_MANY_MUTATE_OPERATIONS
.Anda harus menunggu minimal 12 jam sebelum perubahan instruksi anggaran diubah ke akun yang sama. Melakukan perubahan sebelum 12 jam telah berlalu dapat menyebabkan kegagalan yang tidak dapat dipulihkan yang hanya dapat diselesaikan oleh akun Google Ads Anda representatif.
Undangan ke akun pelanggan
Pengguna baru dapat diundang ke akun klien yang ada dengan
CustomerUserAccessService
. Karena
fungsi ini mengirim email undangan
ke pengguna lain, maka memiliki potensi
disalahgunakan, sehingga ada batasan perilakunya:
Pengguna tidak dapat menerima lebih dari satu undangan yang tertunda untuk klien yang sama menggunakan akun layanan. Jika permintaan berikutnya dibuat untuk mengirim undangan ke pengguna yang sudah memiliki undangan tertunda, pesan error ini akan ditampilkan:
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION
.Akun klien tidak boleh memiliki lebih dari 70 undangan yang tertunda sekaligus. Jika permintaan dikirim yang menyebabkan nilai ini terlampaui, error ini akan dikembalikan:
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED
.
Data pengguna
Data pengguna dikelola dengan
UserDataService
dan
OfflineUserDataJobService
.
Dalam operasi buat/hapus UserData
tertentu, setiap
kumpulan user_identifiers
harus spesifik untuk satu pengguna.
Untuk menegakkan hal ini,
OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS
atau
UserDataError.TOO_MANY_USER_IDENTIFIERS
kesalahan ditampilkan bila ada lebih dari 20 user_identifiers
dalam
UserData
disetel.
Jenis batasan lainnya
Kolom berulang, seperti daftar operasi, yang memiliki terlalu banyak item dalam
permintaan tersebut dapat menyebabkan error:
REQUEST_SIZE_LIMIT_EXCEEDED
.
Pesan error yang sama ini juga dapat disebabkan oleh masalah lainnya.
Jika Anda mengalami keterbatasan ini dan membuat permintaan yang menggunakan coba kurangi jumlah item di kolom berulang dengan men-deploy daftar operasi dalam permintaan mutasi.
Saat membuat kueri GAQL, jumlah maksimum item
dalam klausa IN
adalah 20.000. Jika Anda melebihi batas tersebut,
FILTER_HAS_TOO_MANY_VALUES
{i>error <i}yang dimunculkan.