Tingkat Akses dan Penggunaan yang Diizinkan

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

Level akses

Ada tiga tingkat akses yang berbeda yang tercantum secara berurutan dalam tabel. Jika belum memiliki akses Google Ads API, Anda dapat memulai dengan mendaftar untuk mendapatkan akses akun pengujian. Anda dapat meningkatkan tingkat akses dengan menyelesaikan petunjuk aplikasi tambahan.

Tingkat akses Dapat mengakses... Batas operasi harian1 Batas harian untuk operasi get2 Ajukan Permohonan
Menguji akses akun Akun pengujian 15.000 operasi / hari 1.000 permintaan / hari Petunjuk
Akses dasar Akun pengujian dan produksi 15.000 operasi / hari 1.000 permintaan / hari Petunjuk
Akses standar Akun pengujian dan produksi Operasi tanpa batas / hari 1.000 permintaan / hari Petunjuk

1 "Per hari" didasarkan pada jangka waktu geser 24 jam yang mana permintaan API dibuat dengan token developer. Aplikasi Anda akan menerima error jika melebihi batas permintaan untuk tingkat akses Anda dalam 24 jam terakhir.

2 get akan dihentikan dalam v10. Sebagai gantinya, gunakan search atau searchStream untuk mengambil objek.

Menguji akses akun

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

Mengajukan permohonan akses akun pengujian

Cukup selesaikan pendaftaran Google Ads API dalam UI Google Ads dan Anda akan otomatis diberikan tingkat akses akun pengujian.

Akses dasar

Akses dasar memungkinkan token developer membuat permintaan Google Ads API terhadap akun pengujian dan akun produksi. Akun produksi adalah akun yang menayangkan iklan Google aktif dan nyata (akun pengujian tidak menayangkan iklan).

Tingkat akses dasar memungkinkan token developer mengeksekusi hingga 15.000 permintaan per hari dan 1.000 operasi get per hari. Ini sudah cukup bagi sebagian besar developer.

Mengajukan permohonan Akses dasar

Jika saat ini Anda memiliki token developer tingkat akses akun pengujian dan ingin mengajukan permohonan untuk mendapatkan akses akun produksi, isi formulir permohonan akses dasar. Pastikan Anda telah mengikuti langkah-langkah sederhana berikut:

  1. Pastikan Anda sudah memiliki token developer dengan tingkat akses akun pengujian.
  2. Pastikan Email Kontak API di pusat API sudah yang terbaru. Anda tidak akan dapat menyelesaikan proses pengajuan tanpa Email Kontak Developer yang valid dan diperiksa secara rutin. Pastikan Anda telah menautkan semua akun Google Ads yang aktif ke akun pengelola dengan token API.

Akses standar

Akses standar memungkinkan token developer untuk menjalankan jumlah operasi yang tidak terbatas per hari untuk sebagian besar layanan. Ini mencakup (tetapi tidak terbatas pada) GoogleAdsService Search dan SearchStream. Untuk detail lebih lanjut tentang batas dan pengecualian untuk hal ini, lihat halaman Kuota API.

Token akses standar tetap tunduk pada batas harian 1.000 operasi get. Tingkat akses standar hanya akan diberikan kepada developer yang memerlukan operasi Google Ads API tanpa batas (biasanya perusahaan besar atau alat yang melayani banyak pengguna).

Mengajukan Permohonan untuk Akses Standar

Jika saat ini Anda memiliki tingkat akses dasar dan ingin mengajukan permohonan operasi Google Ads API tanpa batas, isi formulir permohonan 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.

Penggunaan yang diizinkan

Penggunaan yang diizinkan hanya berlaku untuk token Akses Dasar dan Akses Standar. Penggunaan yang diizinkan dialokasikan berdasarkan tujuan penggunaan Google Ads API. Izin ini menentukan fitur API apa yang dapat digunakan oleh token, seperti yang diuraikan dalam tabel di bawah ini.

Berikut adalah daftar penggunaan yang diizinkan:

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 buat permintaan GoogleAdsService.Search atau GoogleAdsService.SearchStream (atau, panggilan hanya-baca). Ini untuk developer yang hanya menggunakan API untuk meminta statistik.
Mencari info kata kunci dan rekomendasi Izinkan token mengakses RecommendationService, KeywordPlanIdeaService, dan KeywordPlanService. Ini hanya digunakan oleh alat yang membutuhkan saran untuk membantu memfasilitasi pembuatan dan pengelolaan kampanye Google Ads.

Mengubah penggunaan yang diizinkan

Jika Anda telah disetujui untuk mendapatkan akses dasar atau tingkat akses standar, Anda dapat mengisi permohonan untuk memperbarui penggunaan yang diizinkan. Isi aplikasi jika Anda ingin memperbarui penggunaan yang diizinkan, atau jika memberikan akses kepada klien ke alat Anda.