Token Developer

Token developer adalah string alfanumerik sepanjang 22 karakter yang digunakan untuk menghubungkan aplikasi Anda ke Google Ads API. Token developer dihentikan pada 9 September 2026. Panduan ini merangkum perubahan dan mencantumkan pertanyaan umum (FAQ) tentang migrasi ini untuk membantu developer yang sudah ada.

Apa yang berubah?

Kami memperkenalkan beberapa perubahan pada pengalaman aktivasi Google Ads API dan pengelolaan akses API sebagai bagian dari penghentian token developer. Bagian ini menyoroti perubahan utama.

Tingkat akses API dikaitkan dengan project Google Cloud

Kami akan menghentikan penggunaan token developer pada 9 September 2026. Tingkat akses token developer Anda saat ini dan yang aktif telah otomatis ditransfer ke project Google Cloud Anda berdasarkan aktivitas API terbaru. Anda dapat terus mengirim token developer di header panggilan API, tetapi hal ini bersifat opsional dan diabaikan oleh server API. Kode yang sudah ada akan terus berfungsi tanpa perubahan apa pun. Tingkat akses API Anda kini ditentukan oleh project Google Cloud yang Anda gunakan untuk membuat kredensial OAuth.

Pengalaman pendaftaran baru untuk Google Ads API

Sekarang Anda dapat mendaftar untuk mendapatkan akses ke Google Ads API langsung di Konsol Google Cloud tanpa memerlukan akun pengelola Google Ads. Jangan mendaftar untuk mendapatkan token developer dari halaman Pusat API atau mencoba mengajukan permohonan akses API dari halaman Pusat API di akun pengelola Google Ads Anda karena proses ini telah dialihkan ke Konsol Google Cloud dan tidak akan diproses jika dimulai dari halaman Pusat API.

Pengalaman pengelolaan akses API baru

Kami telah menghentikan semua fungsi pendaftaran baru dan pengelolaan akses API seperti mengajukan permohonan akses API dan mengelola tingkat akses API di halaman API Center di akun pengelola Google Ads. Fungsi ini kini tersedia di halaman Ringkasan Google Ads API di Konsol Google Cloud.

Anda masih dapat mengakses halaman Pusat API untuk melihat detail developer historis Anda. Halaman ini akan sepenuhnya dihentikan pada masa mendatang.

Kode error baru

Google Ads API versi v25 akan menampilkan error CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION jika Anda mencoba menggunakan project Google Cloud dengan tingkat Akses Akun Percobaan untuk melakukan panggilan ke akun produksi. Versi API yang lebih lama akan memunculkan error ACTION_NOT_PERMITTED. Jika Anda mengalami error ini, buka halaman Ringkasan Google Ads API untuk project Google Cloud Anda dan ajukan permohonan Akses Explorer.

Verifikasi merek diperlukan untuk Akses Dasar dan Standar

Untuk aplikasi Akses Dasar dan Standar yang baru, Anda harus menyelesaikan verifikasi merek untuk project Google Cloud Anda. Pemegang akses yang ada tidak diwajibkan untuk menyelesaikan verifikasi brand, meskipun hal ini dianjurkan.

Aplikasi Akses Dasar kini otomatis dan akan ditinjau dalam beberapa menit setelah verifikasi dan pengiriman merek.

Karena pembaruan proses ini, semua aplikasi akses Basic API yang tertunda akan ditutup sebagai bagian dari transisi ini. Pelamar yang terpengaruh akan menerima email yang berisi detail dan harus mengajukan kembali permohonan akses API dari halaman Ringkasan Google Ads API.

Email kontak API baru

Saat kami bersiap untuk menonaktifkan halaman Pusat API, kami akan beralih menggunakan daftar pengguna pemilik dan editor di project Google Cloud Anda sebagai satu-satunya saluran untuk komunikasi administratif dan kepatuhan wajib. Untuk memastikan kelancaran peralihan, kami akan terus mengirimkan Pengumuman Layanan Wajib (MSA) untuk sementara ke alamat email yang tercantum di Pusat API Anda. Kami akan terus memberi tahu Anda saat kami menyelesaikan peralihan saluran komunikasi kami.

Yang harus dilakukan jika Anda adalah developer lama

Tinjau tingkat akses API project Google Cloud Anda: Jika Anda adalah developer lama, sebaiknya tinjau halaman Ringkasan Google Ads API project Google Cloud Anda untuk memastikan bahwa project tersebut memiliki tingkat akses API yang sama dengan token developer lama Anda. Ikuti petunjuk dalam panduan ini untuk mengatasi perbedaan yang mungkin Anda temukan.

Tinjau alamat email kontak API Anda: Buka halaman IAM (Identity and Access Management) untuk project Google Cloud Anda. Verifikasi bahwa developer dan pengelola akun Ads yang aktif telah diberi peran pemilik atau editor yang sesuai di project Google Cloud Anda. Kami akan mulai mengirimkan Pengumuman Layanan Wajib (MSA) ke alamat email ini untuk memberi tahu Anda tentang perubahan mendatang pada Google Ads API. Kami akan terus mengirimkan MSA ke alamat email kontak yang tercantum di Pusat API Anda untuk jangka waktu sementara, dan kami akan memberi tahu Anda setiap kali proses ini diperbarui.

Perbaiki kode aplikasi Anda: Sebaiknya perbarui aplikasi Anda agar berhenti mengirim token developer sebagai bagian dari panggilan API. Kami telah memublikasikan versi terbaru dari library klien, server MCP Google Ads, dan Asisten Developer Google Ads API yang memungkinkan Anda melakukan panggilan API tanpa menetapkan token developer. Kami akan mulai menolak token developer dalam panggilan API di versi utama Google Ads API mendatang. Jika aplikasi Anda menggunakan library ini, update dependensi aplikasi untuk menggunakan versi terbaru.

Hubungi dukungan Google Ads API jika Anda memerlukan bantuan lebih lanjut atau memiliki pertanyaan lainnya.

Pertanyaan umum (FAQ)

Apa yang terjadi pada tingkat akses API?

Tingkat akses API masih diterapkan di Google Ads API. Namun, izin ini kini diberikan ke project Konsol Google Cloud Anda, bukan ke token developer Anda. Saat Anda melakukan panggilan API, tingkat akses API Anda kini ditentukan oleh project Google Cloud yang Anda gunakan untuk membuat kredensial OAuth.

Bagaimana cara mengidentifikasi project untuk mentransfer tingkat akses API?

Jika Anda sudah memiliki token developer yang disetujui sebelum 9 September 2026, tingkat aksesnya telah ditransfer ke project Google Cloud Anda sebagai berikut:

  • Kami memeriksa log panggilan API selama 90 hari terakhir untuk mengidentifikasi project Cloud yang digunakan untuk melakukan panggilan API dengan token developer yang disetujui.
  • Kami menetapkan tingkat akses API token developer ke semua project Cloud yang teridentifikasi.

Dapatkah saya memiliki beberapa project Cloud dengan berbagai tingkat akses setelah perubahan ini"?

Ya, Anda dapat memiliki beberapa project Google Cloud dengan tingkat akses API yang berbeda. Misalnya, Anda dapat memiliki satu project Google Cloud dengan Akses Dasar dan project Google Cloud lainnya dengan Akses Standar.

Contoh

Sebagai contoh, asumsikan Anda memiliki 4 token developer dan 6 project Cloud dengan detail berikut:

  • Token Developer 1: abcdefghijkl1234567890 memiliki Akses Standar. API ini telah digunakan dengan project ID: 1234567890, 5678912345, 45678912345.
  • Token Developer 2: xyzabcdefghi6789012345 memiliki Akses Dasar. Project ini telah digunakan dengan project ID: 1231235678.
  • Token Developer 3: asdfgflkjhjz7654321012 memiliki Akses Dasar, tetapi belum pernah digunakan untuk melakukan panggilan API. Baru saja disetujui.
  • Token Developer 4: qwertypoiuyu6543298790 memiliki Akses Standar, tetapi belum digunakan dalam 90 hari terakhir. Project ID 9876564900 pernah digunakan dengan token developer ini pada masa lalu.
  • Project cloud: project ID: 7171234567 belum pernah digunakan dengan token developer mana pun untuk melakukan panggilan API.

Tingkat akses API akan ditransfer dari token developer ke project Google Cloud sebagai berikut:

Token Developer Project ID Tingkat akses Penjelasan
abcdefghijkl1234567890 1234567890 Akses Standar Token developer dan project ID saling terkait.
abcdefghijkl1234567890 5678912345 Akses Standar Token developer dan project ID saling terkait.
abcdefghijkl1234567890 45678912345 Akses Standar Token developer dan project ID saling terkait.
xyzabcdefghi6789012345 1231235678 Akses Dasar Token developer dan project ID saling terkait.
asdfgflkjhjz7654321012 -- -- Akses API token developer tidak ditransfer ke project mana pun karena tidak pernah digunakan untuk melakukan panggilan API.
qwertypoiuyu6543298790 9876564900 Menguji Akses Akun Akses API token developer dicabut karena tidak aktif selama 90 hari. Tingkat akses API project secara default adalah akses Akun Pengujian.
-- 7171234567 Menguji Akses Akun Project ini adalah project baru yang belum digunakan dengan token developer apa pun. Tingkat akses API project secara default adalah Akses Akun Pengujian.

Saya memiliki lebih dari satu token developer yang disetujui. Project mana yang akan Anda alihkan tingkat akses API-nya?

Tingkat akses setiap token developer yang disetujui akan ditransfer ke project Google Cloud yang terkait dengan token developer tersebut. Lihat contoh.

Saya menggunakan beberapa project Google Cloud. Project mana yang akan Anda alihkan tingkat akses API-nya?

Jika Anda menggunakan beberapa project Google Cloud dengan token developer yang disetujui dalam 90 hari terakhir, semua project tersebut akan menerima tingkat akses API yang sama dengan token developer Anda. Lihat contoh.

Tingkat akses API ditetapkan ke project yang tidak lagi saya gunakan. Bagaimana cara memperbaiki masalah ini?

Jika akses Google Ads API ditetapkan ke project Google Cloud yang tidak lagi Anda gunakan, Anda tidak perlu melakukan tindakan tambahan. Google akan mencabut akses API untuk project yang tidak digunakan setelah 90 hari tidak aktif.

Tingkat akses API tidak ditetapkan ke project Google Cloud saya. Bagaimana cara memperbaiki masalah ini?

Project Google Cloud Anda tidak mewarisi tingkat akses token developer Anda, kemungkinan karena Anda tidak pernah menggunakan token developer dan project Cloud untuk melakukan panggilan API, atau akses API token developer Anda baru-baru ini berakhir karena tidak ada aktivitas. Untuk memperbaiki masalah ini, ajukan permohonan tingkat akses API yang sesuai untuk project tersebut dari halaman Ringkasan Google Ads API. Lihat contoh.

Di mana saya dapat melihat tingkat akses API project saya?

Anda dapat melihat tingkat akses API project Google Cloud dari halaman Ringkasan Google Ads API.

Bagaimana cara mengajukan permohonan tingkat akses API yang lebih tinggi?

Anda dapat mengajukan permohonan tingkat akses API yang lebih tinggi untuk project Google Cloud Anda dari halaman Ringkasan Google Ads API.

Apa yang terjadi pada permohonan akses API saya yang tertunda?

Semua permohonan Akses Dasar yang tertunda yang Anda mulai dari Pusat API akun pengelola Google Ads sebelum 9 September 2026 akan ditutup. Anda harus mengajukan permohonan ulang untuk Akses Dasar dari halaman Ringkasan Google Ads APIproject Google Cloud Anda. Jika Anda terpengaruh oleh perubahan ini, Anda akan menerima email berisi petunjuk yang diperlukan.

Semua aplikasi Akses Standar yang menunggu persetujuan yang Anda mulai dari Pusat API akun pengelola Google Ads Anda pada 9 September 2026 akan ditinjau seperti biasa. Jika disetujui, project Google Cloud yang terkait dengan token developer Anda akan diberi Akses Standar.

Dapatkah saya mengaitkan ulang token developer yang disetujui dengan project Google Cloud baru?

Sebelumnya, tim Google Ads API mendukung pengaitan ulang token developer dengan project Google Cloud baru berdasarkan kasus per kasus. Hal ini tidak lagi didukung mulai 9 September 2026, karena kami telah menghentikan penggunaan token developer. Jika Anda perlu menggunakan project Google Cloud baru, Anda harus mengajukan permohonan akses API yang sesuai dari halaman Ringkasan Google Ads API project Google Cloud Anda.

Saya memiliki token developer yang disetujui, tetapi tidak pernah menggunakannya. Dapatkah saya menggunakan token developer ini?

Tidak, Anda tidak dapat menggunakan token developer ini. Ada dua kemungkinan:

  1. Akses token developer Anda dapat dicabut karena tidak aktif: Sesuai dengan kebijakan Google, Google dapat mencabut token API Anda jika tidak digunakan selama 90 hari berturut-turut. Jika Anda sudah lama tidak menggunakan token developer, kemungkinan tingkat aksesnya telah dicabut karena tidak aktif. Jika demikian, ajukan kembali permohonan akses API untuk project Google Cloud Anda dari halaman Ringkasan Google Ads API. Lihat contoh.

  2. Token developer Anda baru saja disetujui, tetapi Anda tidak pernah menggunakannya sebelum 9 September 2026: Karena Anda tidak pernah menggunakan token developer yang disetujui dengan project Google Cloud sebelum 9 September 2026, tingkat aksesnya tidak ditransfer ke project Cloud. Akibatnya, Anda tidak dapat menggunakan token developer Anda lagi. Kami akan menampilkan error CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION jika Anda mencoba melakukan panggilan API ke akun produksi dengan token developer ini. Untuk memperbaiki error, ajukan permohonan akses API yang sesuai dari halaman Ringkasan Google Ads API project Google Cloud Anda. Lihat contoh.

Dalam kedua kasus ini, Anda dapat mengajukan permohonan untuk tingkat Akses Eksplorer dan Akses Dasar serta mendapatkan peninjauan otomatis; Anda tidak perlu lagi bekerja sama dengan tim Kepatuhan Google untuk menyelesaikan proses peninjauan. Jika Anda memerlukan Akses Standar, Anda memerlukan peninjauan manual. Namun, Anda dapat membagikan detail token developer yang disetujui saat mengajukan permohonan Akses Standar, sehingga tim Kepatuhan dapat meninjau permohonan Akses Standar baru Anda sebagaimana mestinya.

Dapatkah saya berhenti mengirim token developer sebagai bagian dari permintaan API?

Ya, Anda dapat berhenti mengirim token developer sebagai bagian dari permintaan API Anda. Jika Anda menggunakan library klien, Anda mungkin perlu mengupgrade ke versi terbarunya. Periksa log perubahan library untuk mengonfirmasi apakah library mendukung pembuatan panggilan API tanpa menentukan token developer.

Saya berpartisipasi dalam program uji coba tingkat akses yang dikelola Cloud. Apa pengaruhnya bagi saya?

Program uji coba tingkat akses yang dikelola Cloud diperkenalkan sebagai cara bagi developer Google Cloud untuk melakukan panggilan API tanpa mengirim token developer sebagai bagian dari permintaan API. Karena kami telah menghentikan penggunaan token developer, program ini akan dihentikan.

Tingkat akses token developer aktif Anda telah ditransfer ke project Google Cloud Anda, sehingga kode yang ada akan terus berfungsi tanpa perubahan apa pun. Jika perlu menggunakan project Google Cloud baru, Anda harus mengajukan permohonan akses API dari halaman Ringkasan Google Ads API project Google Cloud Anda.

Token developer saya adalah bagian dari daftar yang diizinkan. Apa pengaruhnya bagi saya?

Google dapat menjalankan program uji coba yang memberi beberapa developer akses ke fitur eksperimental. Akses ke fitur ini terkadang diberikan dengan menambahkan token developer Anda ke daftar yang diizinkan. Jika Anda merupakan bagian dari program uji coba tersebut, Anda tidak perlu melakukan tindakan apa pun.

Kami telah memperbarui semua program uji coba untuk menggunakan project Google Cloud, bukan token developer, sebagai mekanisme daftar yang diizinkan dan mentransfer status daftar yang diizinkan token developer ke project Google Cloud terkait. Kode yang ada akan terus berfungsi tanpa perubahan apa pun. Jika Anda terus mengalami masalah, hubungi Account Manager Google Anda yang mendaftarkan Anda ke program uji coba.

Saya memiliki token developer yang disetujui, dan saya ingin menggunakannya dengan project Google Cloud baru. Apakah itu diizinkan?

Tidak, Anda tidak dapat menggunakan project Google Cloud baru dengan token developer yang disetujui. Karena Anda tidak pernah menggunakan token developer yang disetujui dengan project Google Cloud baru sebelum 9 September 2026, tingkat aksesnya tidak ditransfer ke project Cloud. Kami akan menampilkan error CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION jika Anda mencoba melakukan panggilan API dengan token developer ini, karena token developer tidak lagi digunakan untuk menentukan tingkat akses API Anda. Untuk memperbaiki error, ajukan permohonan akses API yang sesuai dari halaman Ringkasan Google Ads API project Google Cloud Anda. Lihat contoh.

Token developer saya bocor ke pihak eksternal. Apakah saya perlu mereset token developer saya?

Tidak, Anda tidak perlu mereset token developer dalam kasus ini. Karena kami telah mentransfer tingkat akses API token developer Anda ke project Google Cloud Anda, pengguna yang tidak berwenang tidak dapat lagi menggunakan token developer Anda dengan project Google Cloud mereka sendiri. Namun, Anda bebas mereset token developer dari Pusat API jika ingin melakukannya.

Apa yang terjadi pada Pusat API?

Halaman Pusat API yang ada di dalam akun pengelola Google Ads tidak digunakan lagi dan akan dihapus dalam waktu dekat. Jika sudah memiliki token developer, Anda masih dapat login ke akun pengelola Google Ads dan melihat detailnya. Namun, informasi ini hanya diberikan sebagai referensi Anda. Jangan lakukan tugas apa pun yang terkait dengan Tingkat akses token developer, seperti mengajukan permohonan tingkat akses API yang lebih tinggi dari halaman ini.

Jika perlu mengajukan permohonan tingkat akses API yang lebih tinggi, Anda harus melakukannya dari halaman Ringkasan Google Ads API project Google Cloud Anda.

Apakah saya masih memerlukan akun pengelola Google Ads untuk menggunakan Google Ads API?

Anda tidak lagi memerlukan akun pengelola Google Ads untuk menggunakan Google Ads API. Anda hanya memerlukan akun pengelola jika Anda perlu menautkan dan mengelola beberapa akun menggunakan API.

Saya adalah developer baru. Bagaimana cara mendaftar ke Google Ads API?

Ikuti petunjuk di panduan Memulai untuk mendaftar ke Google Ads API. Jangan mendaftar untuk mendapatkan token developer dari Pusat API akun pengelola Google Ads Anda; aplikasi ini tidak akan diproses. Pusat API akan dihentikan dalam waktu dekat.

Berikutnya
Tingkat akses & penggunaan yang diizinkan