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 serta jumlah operasi dan permintaan yang dapat Anda jalankan setiap hari. Penggunaan yang diizinkan menentukan fitur Google Ads API tertentu yang boleh digunakan oleh token developer.

Tingkat akses

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

Tingkat akses Dapat mengakses... Batas operasi harian1 Terapkan
Akses akun pengujian Akun pengujian 15.000 operasi / hari Petunjuk
Akses dasar Akun pengujian dan produksi 15.000 operasi / hari Petunjuk
Akses standar Akun pengujian dan produksi Operasi tanpa batas / hari Petunjuk

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

Akses akun pengujian

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

Selesaikan pendaftaran Google Ads API di antarmuka web Google Ads untuk diberi tingkat akses akun pengujian secara otomatis.

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 yang sebenarnya dan aktif. Akun pengujian tidak menayangkan iklan.

Dengan tingkat akses dasar,token developer dapat menjalankan hingga 15.000 operasi 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 akses akun produksi, isi formulir permohonan akses dasar. Pastikan Anda telah menyelesaikan langkah-langkah 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 dapat menyelesaikan proses permohonan tanpa alamat email 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 operasi dalam jumlah yang tidak terbatas per hari untuk sebagian besar layanan. Hal ini termasuk, tetapi tidak terbatas pada GoogleAdsService Search dan SearchStream. Untuk mengetahui detail selengkapnya tentang batas dan pengecualian untuk 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.

Apa pun tingkat akses yang dimiliki, semua operasi API tunduk pada batasan kapasitas sistem. Untuk mempelajari lebih lanjut cara menangani error pembatasan kapasitas, lihat Jenis error.

Mengajukan permohonan Akses standar

Jika saat ini Anda memiliki tingkat akses dasar dan ingin mengajukan permohonan untuk operasi Google Ads API tanpa batas, isi formulir permohonan akses standar.

Jika alat Anda merupakan alat 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 akses dasar dan token akses standar. Penggunaan yang diizinkan dialokasikan berdasarkan tujuan penggunaan Google Ads API. Izin ini menentukan fitur API mana yang dapat digunakan dengan token, seperti yang dijabarkan dalam tabel berikut:

Penggunaan yang Diizinkan Deskripsi
Pembuatan / pengelolaan iklan Berikan 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.
Meneliti kata kunci dan rekomendasi Izinkan token untuk mengakses RecommendationService, KeywordPlanIdeaService, dan KeywordPlanService. Hal ini hanya digunakan oleh alat yang memerlukan saran untuk membantu memfasilitasi pembuatan dan pengelolaan kampanye Google Ads.

Mengubah penggunaan yang diizinkan

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