Token developer adalah string alfanumerik sepanjang 22 karakter yang memungkinkan aplikasi Anda terhubung ke Google Ads API. Anda bisa mendapatkannya dengan mendaftar di halaman Pusat API di akun pengelola Google Ads Anda. Setiap kali melakukan panggilan API, Anda mengirim token developer sebagai bagian dari permintaan dengan menyetel header http atau gRPC developer-token.
Setiap token developer diberi tingkat akses yang mengontrol jumlah panggilan API yang dapat Anda lakukan per hari dengan token, serta lingkungan tempat Anda dapat melakukan panggilan.
Saat mendaftar untuk mendapatkan token developer, Anda mungkin diberi tingkat Akses Explorer secara default. Hal ini memungkinkan Anda melakukan panggilan terhadap akun produksi, tetapi dengan batasan tertentu. Dalam kasus tertentu saat kami tidak dapat meninjau aplikasi token developer Anda secara otomatis, kami dapat memberikan tingkat Akses Akun Pengujian untuk token developer Anda. Hal ini memungkinkan Anda melakukan panggilan API hanya terhadap akun pengujian. Untuk menghapus batasan tingkat akses akun penjelajah dan pengujian, Anda harus meminta tingkat Akses Dasar atau Akses Standar untuk token developer Anda. Setelah permohonan token developer Anda ditinjau dan disetujui, token developer Anda akan diberi tingkat akses yang sesuai.
Apakah Anda memerlukan token developer baru?
Apakah Anda harus mendaftar untuk mendapatkan token developer baru atau tidak bergantung pada beberapa faktor. Berikut ini beberapa skenario umum:
Skenario |
Langkah berikutnya |
| Perusahaan Anda belum pernah menggunakan Google Ads API dan Anda ingin mengembangkan aplikasi sendiri | Daftar untuk mendapatkan token developer baru. Pelajari lebih lanjut |
| Perusahaan Anda aktif menggunakan atau telah menggunakan Google Ads API pada masa lalu | Google biasanya memberikan satu token developer per perusahaan, jadi jika perusahaan Anda sudah menggunakan Google Ads API, Anda harus menggunakan kembali token developer yang sudah ada. Pelajari lebih lanjut |
| Perusahaan Anda sudah menggunakan Google Ads API, tetapi juga mengembangkan produk atau alat baru | Jika Anda yakin bahwa Anda tidak dapat menggunakan token developer yang ada, maka Anda dapat mengajukan permohonan untuk mendapatkan token baru dengan menjelaskan kasus penggunaan Anda dalam permohonan tersebut. Untuk bagian selanjutnya dalam panduan ini, Anda dapat menggunakan token developer yang ada. Pelajari lebih lanjut |
| Perusahaan Anda menggunakan aplikasi pihak ketiga | Anda hanya memerlukan token developer jika Anda mengembangkan aplikasi sendiri. Jika Anda menggunakan aplikasi atau layanan pihak ketiga, developer aplikasi tersebut harus mendapatkan token developer untuk aplikasi tersebut. Jika Anda tidak yakin dengan kasus Anda, hubungi tim kepatuhan API. |
Siapa yang dapat mengajukan permohonan token developer?
Perusahaan dan developer perorangan dapat mengajukan permohonan token developer. Tabel berikut merangkum detail yang harus Anda berikan saat mendaftar untuk token developer.
| Jika Anda | Kemudian, berikan detail developer berikut | Catatan tambahan |
|---|---|---|
| Developer yang mewakili perusahaan atau tim produk Anda | Nama perusahaan dan URL perusahaan Anda | Google biasanya memberikan satu token developer per perusahaan, tetapi menyetujui token developer terpisah untuk alat terpisah berdasarkan tiap-tiap kasus. |
| Developer perorangan yang tidak mewakili perusahaan | Tentukan nama perusahaan Anda sebagai Individual. Anda dapat
memberikan URL alternatif seperti URL profil GitHub atau URL profil LinkedIn
sebagai ganti URL perusahaan. |
Anda memerlukan kehadiran online dalam bentuk tertentu dan harus memberikan URL kepada Google
yang membantu kami menilai apa yang Anda rencanakan untuk dilakukan dengan Google Ads API. URL umum
seperti test.com dan example.com tidak
diterima. |
Cara mengajukan permohonan token developer
Ada dua langkah saat mengajukan permohonan token developer.
Langkah 1: Pilih atau buat akun pengelola Google Ads
Jika sudah memiliki akun pengelola Google Ads, pilih akun tersebut saat mengajukan permohonan token developer. Jika akun pengelola ini belum ditautkan ke akun Anda yang lain, sebaiknya tempatkan akun ini di akar hierarki akun Anda untuk mempermudah proses peninjauan token dan menyederhanakan pengelolaan akun di kemudian hari.
Jika Anda belum memiliki akun pengelola, Anda dapat mengikuti petunjuk Pusat Bantuan untuk membuatnya.
Langkah 2: Ajukan permohonan akses ke Google Ads API
Perhatikan bahwa proses peninjauan token developer dapat memerlukan waktu beberapa saat. Pelajari lebih lanjut.
Buka https://ads.google.com/aw/apicenter di browser web Anda. Login ke akun pengelola Google Ads Anda jika diminta.
Isi formulir Akses API dan setujui Persyaratan dan Ketentuan.
Pastikan informasi Anda sudah benar dan URL situs perusahaan Anda berfungsi. Jika situs belum aktif, Google mungkin tidak dapat memproses permohonan Anda dan menolaknya.
Pastikan email kontak API yang Anda berikan mengarah ke kotak masuk yang dipantau secara rutin. Tim kepatuhan API Google mungkin menghubungi alamat email ini selama proses peninjauan untuk meminta klarifikasi. Jika Anda tidak dapat dihubungi, Google mungkin tidak melanjutkan permohonan Anda.
Anda dapat mengedit email kontak API di Pusat API. Selalu perbarui informasi ini, bahkan setelah proses permohonan, agar Google dapat mengirimkan pengumuman layanan penting kepada Anda.
Setelah Anda menyelesaikan proses permohonan, token developer akan muncul di Pusat API Anda dengan salah satu hasil berikut:
- Token developer Anda memiliki tingkat Akses Explorer dengan status Disetujui. Artinya, Google dapat meninjau dan menyetujui aplikasi token developer Anda secara otomatis untuk tingkat Akses Explorer. Anda dapat mulai melakukan panggilan API terhadap akun produksi atau akun percobaan.
- Token developer Anda memiliki tingkat Akses Akun Pengujian dengan status Menunggu Persetujuan. Artinya, Google tidak dapat meninjau dan menyetujui permohonan token developer Anda secara otomatis untuk tingkat Akses Explorer. Anda dapat mulai melakukan panggilan API terhadap akun pengujian. Setelah Anda menyelesaikan panduan ini, sebaiknya Anda membaca cara mengajukan permohonan tingkat Akses Dasar
Verifikasi apakah Anda login ke akun pengelola Google Ads
Anda harus login ke akun pengelola Google Ads untuk mengakses token developer, dan akun tersebut tidak boleh berupa akun pengelola uji coba Google Ads.
Untuk memverifikasi apakah Anda login ke akun pengelola Google Ads, ikuti langkah-langkah berikut:
Buka https://ads.google.com/aw/apicenter di browser web Anda.
Jika Anda login ke akun pelanggan, halaman akan menampilkan Pusat API hanya tersedia untuk akun pengelola..
Jika Akun pengujian muncul dengan warna merah di sudut kanan atas, akun Anda adalah pengelola pengujian atau pengiklan pengujian.
Tempat menemukan token developer Anda
Anda dapat menemukan token developer, jika ada, di halaman Pusat API di akun pengelola Google Ads Anda.