Untuk mendiskusikan dan memberikan masukan tentang produk kami, bergabunglah ke channel Discord Google Ads resmi di server Komunitas Iklan dan Pengukuran Google.

Halaman ini diterjemahkan oleh Cloud Translation API.

Tingkat Akses dan Penggunaan yang Diizinkan

Setiap token developer Google Ads API diberi tingkat akses dan "penggunaan yang diizinkan". Tingkat akses menentukan apakah Anda dapat memengaruhi akun produksi dan jumlah operasi serta permintaan yang dapat Anda jalankan setiap hari. Penggunaan yang diizinkan menentukan fitur Google Ads API tertentu yang diizinkan untuk digunakan oleh token developer.

Tingkat akses

Ada empat tingkat akses token developer yang berbeda yang tercantum dalam urutan di tabel. Jika belum memiliki akses Google Ads API, Anda dapat memulai dengan mendaftar untuk mendapatkan token developer dengan tingkat Akses Akun Uji. Anda dapat meningkatkan tingkat akses dengan menyelesaikan beberapa langkah tambahan di aplikasi.

Tingkat akses	Dapat mengakses...	Batas operasi harian¹	Cara mendaftar	Berapa lama biasanya proses peninjauan?
Tingkat Akses Akun Uji	Akun pengujian	15.000 operasi / hari	Petunjuk
Tingkat Akses Penjelajah	Akun pengujian dan produksi	2.880 operasi / hari untuk akun produksi 15.000 operasi / hari untuk akun pengujian	Petunjuk
Tingkat Akses Dasar	Akun pengujian dan produksi	15.000 operasi / hari untuk akun pengujian dan produksi	Petunjuk	2 hari kerja
Tingkat Akses Standar	Akun pengujian dan produksi	Operasi tidak terbatas / hari untuk akun pengujian dan produksi	Petunjuk	10 hari kerja

¹ "Per hari" didasarkan pada periode waktu 24 jam yang berubah-ubah saat permintaan API dilakukan dengan token developer Anda. Aplikasi Anda akan menerima error jika melebihi batas permintaan untuk tingkat akses Anda dalam 24 jam terakhir.

Tingkat Akses Akun Uji

Setelah menyelesaikan pendaftaran awal untuk Google Ads API, Anda akan diberi token developer dengan tingkat Akses Akun Uji. Artinya, token developer hanya dapat membuat permintaan Google Ads API terhadap akun percobaan.

Cara mengajukan permohonan tingkat Akses Akun Uji

Selesaikan pendaftaran Google Ads API di antarmuka web Google Ads agar otomatis diberi tingkat Akses Akun Pengujian.

Tingkat Akses Penjelajah

Setelah Anda menyelesaikan pendaftaran awal untuk Google Ads API, Google dapat mengupgrade token developer Anda secara otomatis dari level Akses Akun Uji ke level Akses Explorer dalam beberapa kasus. Tingkat akses Explorer memungkinkan token developer membuat permintaan Google Ads API terhadap akun percobaan dan akun produksi. Akun produksi adalah akun yang menayangkan iklan Google yang sebenarnya dan aktif—akun percobaan tidak menayangkan iklan.

Tingkat Akses Explorer memungkinkan token developer menjalankan hingga 2.880 operasi per hari terhadap akun produksi. Hal ini sudah cukup bagi sebagian besar developer untuk mulai menggunakan API dan membangun otomatisasi dasar.

Tingkat Akses Explorer membatasi akses ke fitur berikut. Jika Anda perlu menggunakan fitur ini, Anda harus mengajukan permohonan untuk Tingkat Akses Dasar atau Tingkat Akses Standar.

Fungsi Terbatas	Layanan dan Metode yang Dibatasi
Pembuatan akun	`CustomerService.CreateCustomerClient`
Pengelolaan pengguna	`CustomerUserAccessInvitationService` `CustomerUserAccessService`
Perencanaan	`KeywordPlanService` `KeywordPlanIdeaService` `KeywordPlanCampaignService` `KeywordPlanCampaignKeywordService` `KeywordPlanAdGroupService` `KeywordPlanAdGroupKeywordService` `AudienceInsightsService` `KeywordPlanIdeaService` `ReachPlanService`
Penagihan dan Pembayaran Akun	`PaymentsAccountService` `BillingSetupService` `AccountBudgetProposalService` `InvoiceService`

Cara mengajukan permohonan tingkat akses Explorer

Selesaikan pendaftaran Google Ads API di antarmuka web Google Ads. Dalam beberapa kasus, Google dapat otomatis mengupgrade token developer Anda ke tingkat Akses Explorer setelah Anda menyelesaikan pendaftaran.

Tingkat Akses Dasar

Tingkat Akses Dasar memungkinkan token developer membuat permintaan Google Ads API terhadap akun percobaan dan akun produksi. Akun produksi adalah akun yang menayangkan iklan Google yang sebenarnya dan aktif—akun percobaan tidak menayangkan iklan.

Tingkat Akses Dasar memungkinkan token developer menjalankan hingga 15.000 operasi per hari. Langkah ini cukup untuk sebagian besar developer.

Cara mengajukan permohonan tingkat Akses Dasar

Jika Anda memiliki token developer dengan tingkat Akses Akun Percobaan dan ingin mengajukan permohonan akses akun produksi, isi formulir permohonan tingkat Akses Dasar. Pastikan Anda telah menyelesaikan langkah-langkah berikut:

Pastikan Anda sudah memiliki token developer dengan tingkat Akses Akun Uji.
Pastikan Email Kontak API di pusat API sudah yang terbaru. Anda harus login ke akun pengelola Google Ads untuk melihat pusat API. Anda tidak akan dapat menyelesaikan proses permohonan tanpa alamat email yang valid dan diperiksa secara rutin. Pastikan Anda telah menautkan semua akun Google Ads aktif ke akun pengelola Google Ads dengan token API.

Tingkat Akses Standar

Tingkat Akses Standar memungkinkan token developer menjalankan operasi dalam jumlah tak terbatas per hari untuk sebagian besar layanan. Hal ini mencakup, tetapi tidak terbatas pada GoogleAdsService Search dan SearchStream. Untuk mengetahui detail selengkapnya tentang batas dan pengecualian pada tingkat Akses Standar, lihat kuota API.

Tingkat Akses Standar hanya diberikan kepada developer yang memerlukan operasi Google Ads API tanpa batas, seperti perusahaan besar atau alat yang melayani banyak pengguna.

Cara mengajukan permohonan tingkat Akses Standar

Jika Anda memiliki token developer dengan tingkat Akses Dasar dan ingin mengajukan permohonan untuk operasi Google Ads API tanpa batas, isi formulir permohonan tingkat Akses Standar.

Jika alat Anda bersifat eksternal, bersiaplah untuk memberikan akses login demo ke alat Anda. Perhatikan bahwa alat Anda harus mematuhi Fungsi Minimum yang Diperlukan.

Kuota API dan batas kapasitas sistem

Terlepas dari tingkat akses, semua operasi API tunduk pada batas kapasitas sistem, yang membatasi jumlah operasi yang dapat Anda lakukan dalam jangka waktu tertentu, yaitu jumlah operasi per jam. Untuk mempelajari lebih lanjut cara menangani error batas kecepatan, lihat jenis error.

Setiap layanan dapat menerapkan batasan tambahan dan pembatasan kuota karena alasan seperti batasan desain produk, pembatasan kebijakan produk, pertimbangan performa dan latensi API. Lihat dokumentasi tentang kuota API untuk mempelajari lebih lanjut batasan ini.

Penggunaan yang diizinkan

Penggunaan yang diizinkan hanya berlaku untuk token developer dengan tingkat Akses Dasar dan Akses Standar. Penggunaan yang diizinkan dialokasikan berdasarkan tujuan penggunaan Google Ads API. Izin ini menentukan fitur API mana yang dapat digunakan untuk token developer, seperti yang dijelaskan dalam tabel berikut:

Penggunaan yang Diizinkan	Deskripsi
Pembuatan / pengelolaan iklan	Memberikan akses ke semua layanan API untuk membuat dan mengelola kampanye, grup iklan, iklan, dan kata kunci Google Ads.
Pelaporan	Hanya lakukan permintaan `GoogleAdsService.Search` atau `GoogleAdsService.SearchStream`, atau panggilan hanya baca. Opsi ini ditujukan bagi developer yang hanya menggunakan API untuk meminta statistik.
Meneliti kata kunci dan rekomendasi	Izinkan token developer mengakses `RecommendationService`, `KeywordPlanIdeaService`, dan `KeywordPlanService`. Ini hanya digunakan oleh alat yang memerlukan saran untuk membantu memfasilitasi pembuatan dan pengelolaan kampanye Google Ads.

Cara mengubah penggunaan yang diizinkan

Jika token developer Anda telah disetujui untuk tingkat Akses Dasar atau tingkat Akses Standar, Anda dapat mengisi permohonan untuk memperbarui penggunaan yang diizinkan. Isi formulir permohonan jika Anda ingin memperbarui penggunaan yang diizinkan atau memberikan akses klien ke alat Anda.