Google Ads Developer Token Kaldırıldı: API Erişimi Artık Nasıl Alınıyor?

Google Ads API'ye bağlanmak için yıllardır tek bir şey gerekiyordu: bir yönetici hesabı açıp API Center'dan 22 karakterlik developer token'ı almak. O süreç 9 Eylül 2026'da tamamen kaldırıldı. Erişim artık Google Cloud projesine bağlı ve seviyeler değişti. Bu yazıda yeni akışı, seviye limitlerini ve mevcut entegrasyonuna ne olduğunu anlatıyorum.

Tam olarak ne değişti?

Google'ın kendi dokümanındaki ifade net:

Developer tokens were sunset on September 9, 2026.

Eski dünyada erişim kişiye bağlıydı: bir Google Ads yönetici hesabı (MCC) açar, API Center'dan tek bir developer token alır, onu bütün projelerinde kullanırdın. Token bir taneydi ve seviyesi de tekti.

Yeni dünyada erişim projeye bağlı. Hangi Google Cloud projesi OAuth kimlik bilgilerini üretiyorsa, erişim seviyesi o projenin seviyesidir. İki yol var ve ikisi de aynı mantıkla çalışıyor:

• Kullanıcı kimlik doğrulaması kullanıyorsan → OAuth istemci kimliğinin ait olduğu proje
• Servis hesabı kullanıyorsan → servis hesabının bulunduğu proje

Pratikte en büyük fark şu: artık yönetici hesabı açmadan API erişimi alabiliyorsun. Kayıt doğrudan Google Cloud Console üzerinden yapılıyor. Eskiden MCC zorunluydu ve bu, tek bir hesabı yönetmek isteyen geliştirici için gereksiz bir adımdı.

İkinci büyük fark: tek token sınırı kalktı. Farklı Cloud projelerini farklı seviyelerde tutabiliyorsun. Bir projeyi müşteri işinde Basic'te, bir denemeyi Test'te tutmak artık mümkün.

Google bunu neden yaptı?

Dokümanda gerekçe yazmıyor, o yüzden tahmin yürütmeyeceğim. Ama değişikliğin şekline bakınca iki şey görünüyor.

Birincisi, developer token kişiye bağlı bir sırdı ve sızması halinde iptal etmekten başka çare yoktu. Cloud projesine bağlı erişim, Google'ın zaten olgun olan proje ve kimlik altyapısını kullanıyor: erişimi kısıtlamak, denetlemek ve kotalamak orada daha kolay.

İkincisi, başvuru süreci otomatikleşti. Dokümandaki ifade şöyle: Basic seviye başvuruları artık otomatik ve marka doğrulaması tamamlandıktan sonra dakikalar içinde inceleniyor. Eski developer token başvurusunda günlerce beklemek sıradandı.

Yeni erişim seviyeleri ve limitler

Dört seviye var. Aradaki fark sadece işlem sayısı değil, hangi hesaplara erişebildiğin.

Sıfırdan erişim: adım adım

Akış doğrusal. Her seviye bir öncekinin üstüne biniyor, atlama yok.

1. Google Cloud projesinde API'yi etkinleştir Cloud Console'da projeyi aç, Google Ads API'yi etkinleştir. Bu adımı tamamladığın anda Test erişimi otomatik geliyor, başvuru yok. Buradan itibaren test hesaplarıyla kod yazabilirsin.
2. OAuth kimlik bilgilerini üret Aynı proje içinde OAuth istemci kimliği ve gizli anahtarı oluştur, refresh_token'ı al. Kritik nokta: erişim seviyesini belirleyen şey bu kimlik bilgilerinin hangi projeye ait olduğu. Yanlış projede üretilmiş bir istemci kimliği, doğru projenin seviyesini taşımaz.
3. Explorer için başvur API Overview sayfasından başvuru yapılıyor. Çoğu durumda otomatik onaylanıyor. Bu seviyeden itibaren gerçek reklam hesaplarına bağlanabiliyorsun, ama günde 2.880 işlemle ve yukarıdaki kısıtlarla.
4. Marka doğrulamasını tamamla Basic'e geçmenin ön şartı. Cloud projesi için yapılıyor, bir sonraki bölümde ayrıntısı var.
5. Basic için başvur Marka doğrulaması bittikten sonra başvuru otomatik işliyor. Doküman "dakikalar içinde" diyor, pratikte tamamının oturması yaklaşık 10 iş gününü bulabiliyor. Günlük 15.000 işlem, çoğu otomasyon için fazlasıyla yeterli.
6. Standard sadece gerekiyorsa Sınırsız işlem istiyorsan. Burada otomatik onay yok, elle denetim var ve sistemini ayrıntılı anlatman gerekiyor. Ajans değilsen ya da yüzlerce hesap yönetmiyorsan Basic'te kal.

Marka doğrulaması

Basic'in önündeki tek kapı bu ve yeni sistemin eskiye göre en belirgin eklentisi.

Doğrulama Cloud projesi için yapılıyor, kişi için değil. Yani aynı doğrulanmış marka altında birden fazla proje yönetiyorsan işleyiş buna göre kurulur.

Başvurudan önce iki şeyi hazırla: API'yi kullanacak uygulamanın hangi alan adında yaşadığı ve o alan adının sana ait olduğunu gösterecek doğrulama. Alan adı sahipliği ile OAuth ekranındaki uygulama bilgileri birbirini tutmuyorsa süreç uzuyor.

Basic'e geçtikten sonra erişimin hangi izinli kullanım kategorisinde olduğu da belirleniyor: reklam yönetimi, sadece raporlama, ya da anahtar kelime araştırması. Kuracağın sistem hangisiyse başvuruda onu seç — sonradan değiştirmek yeni başvuru demek.

Mevcut entegrasyonuna ne oldu?

Çalışan bir entegrasyonun varsa paniğe gerek yok. Google, mevcut developer token'ların erişim seviyesini son dönemdeki API etkinliğine bakarak Cloud projelerine otomatik aktardı.

Yani kodun çalışmaya devam ediyor olabilir. Ama üç şeyi kontrol etmeden "sorun yok" deme:

• Hangi projeye aktarıldı? Birden fazla Cloud projen varsa seviye, son dönemde aktif olan projeye gitti. Kullandığın proje o değilse seviyen beklediğinden düşük olabilir.
• Kodundaki token alanı. İstemci kitaplığının yapılandırmasında developer token satırı hâlâ duruyorsa, o satırın yeni sistemde ne anlama geldiğini kontrol et.
• Seviyenin kendisi. Eskiden Basic'tiysen Basic'te olmalısın, ama aktarım etkinliğe bakarak yapıldığı için uzun süre uyuyan bir entegrasyon aşağı düşmüş olabilir.

Sık sorulan sorular

Bundan sonrası

Erişim bir başlangıç, kendi başına bir şey yapmıyor. API'den asıl değeri, eylem başına maliyeti ve reklam harcaması getirisini otomatik okuyup bir karara bağladığında alırsın. Bütçe sızıntısı tarafına bakmak istersen Google Ads bütçe sızıntıları yazısı somut bir başlangıç noktası veriyor.