Geliştirici jetonu

Geliştirici jetonu, uygulamanızı Google Ads API'ye bağlamak için kullanılan 22 karakterlik alfanümerik bir dizedir. Geliştirici jetonlarının desteği 9 Eylül 2026'da sonlandırıldı. Bu kılavuzda, mevcut geliştiricilere yardımcı olmak için değişiklikler özetlenmekte ve bu taşıma işlemiyle ilgili sık sorulan sorular listelenmektedir.

Neler değişiyor?

Geliştirici jetonunun kullanımdan kaldırılması kapsamında Google Ads API'ye ilk katılım deneyiminde ve API erişim yönetiminde çeşitli değişiklikler yaptık. Bu bölümde, önemli değişiklikler vurgulanmaktadır.

API erişim düzeyleri, Google Cloud projeleriyle ilişkilendirilir.

Geliştirici jetonları 9 Eylül 2026'da kullanımdan kaldırılacak. Mevcut ve etkin geliştirici jetonu erişim düzeyiniz, son API etkinliğine göre Google Cloud projelerinize otomatik olarak aktarıldı. API çağrısı başlıklarınızda geliştirici jetonları göndermeye devam edebilirsiniz ancak bu isteğe bağlıdır ve API sunucuları tarafından yok sayılır. Mevcut kodunuz herhangi bir değişiklik yapılmadan çalışmaya devam edecektir. API erişim düzeyleriniz artık OAuth kimlik bilgilerinizi oluşturmak için kullandığınız Google Cloud projesi tarafından belirlenir.

Google Ads API için yeni kaydolma deneyimi

Artık Google Ads API'ye erişim için doğrudan Google Cloud Console'da kaydolabilirsiniz. Bunun için Google Ads yönetici hesabı gerekmez. Bu işlemler Google Cloud Console'a taşındığından ve API Merkezi sayfasından başlatılırsa işlenmeyeceğinden, API Merkezi sayfasından geliştirici jetonu için kaydolmayın veya Google Ads yönetici hesabınızdaki API Merkezi sayfasından API erişimi için başvuruda bulunmaya çalışmayın.

Yeni API erişimi yönetimi deneyimi

Google Ads yönetici hesaplarındaki API Merkezi sayfasında API erişimine başvurma ve API erişim düzeylerini yönetme gibi tüm yeni kaydolma ve API erişim yönetimi işlevlerini kullanımdan kaldırdık. Bu işlevler artık Google Cloud Console'daki Google Ads API'ye Genel Bakış sayfasında kullanılabilir.

Geçmişteki geliştirici ayrıntılarınıza başvurmak için API Merkezi sayfasına erişmeye devam edebilirsiniz. Bu sayfanın desteği gelecekte tamamen sonlandırılacak.

Yeni hata kodları

Google Ads API'nin v25 sürümü, bir üretim hesabına çağrı yapmak için Test Hesabı Erişim düzeyine sahip bir Google Cloud projesi kullanmayı denerseniz CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION hatası verir. Eski API sürümleri bunun yerine ACTION_NOT_PERMITTED hatası verir. Bu hatayla karşılaşırsanız Google Cloud projeniz için Google Ads API'ye Genel Bakış sayfasına gidin ve Explorer erişimi için başvurun.

Temel ve Standart Erişim için marka doğrulaması gerekir.

Yeni Temel ve Standart Erişim uygulamaları için Google Cloud projenizin marka doğrulamasını tamamlamanız gerekir. Mevcut erişim sahiplerinin marka doğrulamasını tamamlaması zorunlu olmasa da bu işlem önerilir.

Temel erişim uygulamaları artık otomatikleştirildi ve marka doğrulama ile gönderimden sonraki birkaç dakika içinde incelenecek.

Bu süreç güncellemeleri nedeniyle, bekleyen tüm Temel API erişimi uygulamaları bu geçiş kapsamında kapatılacak. Etkilenen başvuru sahipleri ayrıntıların yer aldığı bir e-posta alır ve Google Ads API'ye Genel Bakış sayfasından API erişimi için yeniden başvuruda bulunmalıdır.

Yeni API iletişim e-posta adresleri

API Merkezi sayfası kullanımdan kaldırılmaya hazırlanırken, Google Cloud projenizdeki sahip ve düzenleyici kullanıcı listesini, yönetimle ilgili ve zorunlu uyumluluk iletişimleri için tek kanal olarak kullanmaya başlayacağız. Sorunsuz bir geçiş sağlamak için API Merkezi'nde listelenen e-posta adresine zorunlu hizmet duyuruları (MSA'lar) göndermeye geçici olarak devam edeceğiz. İletişim kanallarımızın geçişini tamamladığımızda sizi bilgilendireceğiz.

Mevcut bir geliştiriciyseniz yapmanız gerekenler

Google Cloud projenizin API erişim düzeylerini inceleyin: Mevcut bir geliştiriciyseniz Google Cloud projelerinizin Google Ads API'ye Genel Bakış sayfasını inceleyerek mevcut geliştirici jetonunuzla aynı API erişim düzeyine sahip olduklarından emin olmanızı öneririz. Karşılaştığınız tutarsızlıkları gidermek için bu rehberdeki talimatları uygulayın.

API iletişim e-posta adresinizi inceleyin: Google Cloud projenizin IAM (Kimlik ve Erişim Yönetimi) sayfasına gidin. Etkin Ads geliştiricilerinizin ve hesap yöneticilerinizin Google Cloud projenizde uygun sahip veya düzenleyici rollerine atandığını doğrulayın. Google Ads API'de gelecekte yapılacak değişiklikler hakkında sizi bilgilendirmek için bu e-posta adreslerine Zorunlu Hizmet Duyuruları (MSA'lar) göndermeye başlayacağız. Geçici bir süre boyunca, API merkezinizde listelenen iletişim e-posta adresine HSS'leri göndermeye devam edeceğiz ve bu süreç güncellendiğinde sizi bilgilendireceğiz.

Uygulama kodunuzu düzeltin: API çağrıları kapsamında geliştirici jetonu göndermeyi durdurmak için uygulamanızı güncellemenizi öneririz. İstemci kitaplıklarının, Google Ads MCP sunucusunun ve Google Ads API Developer Assistant'ın güncellenmiş sürümlerini yayınladık. Bu sürümler, geliştirici jetonu ayarlamadan API çağrıları yapmanıza olanak tanır. Google Ads API'nin gelecekteki bir ana sürümünde API çağrılarında geliştirici jetonlarını reddetmeye başlayacağız. Uygulamanız bu kitaplıkları kullanıyorsa uygulama bağımlılıklarını en son sürümü kullanacak şekilde güncelleyin.

Daha fazla yardıma ihtiyacınız olursa veya başka sorularınız varsa Google Ads API Destek Ekibi ile iletişime geçin.

Sık sorulan sorular

API erişim düzeylerine ne olur?

Google Ads API'de API erişim düzeyleri uygulanmaya devam eder. Ancak bu krediler artık geliştirici jetonunuz yerine Google Cloud Console projenize verilir. API çağrıları yaptığınızda API erişim düzeyleriniz artık OAuth kimlik bilgilerinizi oluşturmak için kullandığınız Google Cloud projesi tarafından belirlenir.

API erişim düzeylerinin aktarılacağı projeler nasıl belirlendi?

9 Eylül 2026'dan önce onaylanmış bir geliştirici jetonunuz varsa bu jetonun erişim düzeyleri Google Cloud projelerinize aşağıdaki şekilde aktarılmıştır:

  • Onaylanmış geliştirici jetonunuzla API çağrıları yapmak için hangi Cloud projelerinin kullanıldığını belirlemek amacıyla son 90 günün API çağrı günlüklerini inceledik.
  • Geliştirici jetonunun API erişim düzeylerini, belirlenen tüm Cloud projelerine atadık.

Bu değişiklikten sonra çeşitli erişim düzeylerine sahip birden fazla Cloud projem olabilir mi?

Evet, farklı API erişim düzeylerine sahip birden fazla Google Cloud projeniz olabilir. Örneğin, bir Google Cloud projesinde Temel Erişim, başka bir Google Cloud projesinde ise Standart Erişim olabilir.

Örnek

Örneğin, aşağıdaki ayrıntılara sahip 4 geliştirici jetonunuz ve 6 Cloud projeniz olduğunu varsayalım:

  • Geliştirici Jetonu 1: abcdefghijkl1234567890, Standart Erişime sahip. 1234567890, 5678912345, 45678912345 proje kimlikleriyle kullanılmıştır.
  • Geliştirici jetonu 2: xyzabcdefghi6789012345 Temel erişime sahip. 1231235678 proje kimlikleriyle kullanılmıştır.
  • Geliştirici jetonu 3: asdfgflkjhjz7654321012 Temel erişime sahip ancak API çağrısı yapmak için hiç kullanılmadı. Yakın zamanda onaylanmış olması
  • Geliştirici jetonu 4: qwertypoiuyu6543298790 Standart erişime sahipti ancak son 90 gün içinde kullanılmadı. Proje kimliği 9876564900, geçmişte bu geliştirici jetonuyla kullanıldı.
  • Bulut projesi: Bulut projesi kimliği: 7171234567, API çağrısı yapmak için geliştirici jetonlarından herhangi biriyle hiç kullanılmamıştır.

API erişim düzeyleri, geliştirici jetonlarından Google Cloud projelerine aşağıdaki şekilde aktarılır:

Geliştirici simgesi Proje kimliği Erişim düzeyi Açıklama
abcdefghijkl1234567890 1234567890 Standart Erişim Geliştirici jetonu ve proje kimliği birbirleriyle ilişkilendirilmiş olmalıdır.
abcdefghijkl1234567890 5678912345 Standart Erişim Geliştirici jetonu ve proje kimliği birbirleriyle ilişkilendirilmiş olmalıdır.
abcdefghijkl1234567890 45678912345 Standart Erişim Geliştirici jetonu ve proje kimliği birbirleriyle ilişkilendirilmiş olmalıdır.
xyzabcdefghi6789012345 1231235678 Temel Erişim Geliştirici jetonu ve proje kimliği birbirleriyle ilişkilendirilmiş olmalıdır.
asdfgflkjhjz7654321012 -- -- Geliştirici jetonunun API erişimi, API çağrısı yapmak için hiç kullanılmadığından herhangi bir projeye aktarılmadı.
qwertypoiuyu6543298790 9876564900 Test Hesabı Erişimi Geliştirici jetonunun API erişimi, 90 gün boyunca işlem yapılmadığı için iptal edildi. Projenin API erişim düzeyi varsayılan olarak Test Hesabı erişimi olur.
-- 7171234567 Test Hesabı Erişimi Bu, herhangi bir geliştirici jetonuyla kullanılmamış yeni bir projedir. Projenin API erişim düzeyi varsayılan olarak Test Hesabı Erişimi'dir.

Birden fazla onaylanmış geliştirici jetonum var. API erişim düzeylerini hangi projeye aktaracaksınız?

Onaylanan her geliştirici jetonunun erişim düzeyleri, bu geliştirici jetonuyla ilişkili Google Cloud projelerine aktarılır. Örneğe göz atın.

Birden fazla Google Cloud projesi kullanıyorum. API erişim düzeylerini hangi projeye aktaracaksınız?

Son 90 gün içinde onaylanmış geliştirici jetonunuzla birden fazla Google Cloud projesi kullandıysanız bu projelerin tümü, geliştirici jetonunuzla aynı API erişim düzeylerini alır. Örneğe göz atın.

API erişim düzeyleri, artık kullanmadığım bir projeye atanmış. Bu sorunu nasıl düzeltebilirim?

Google Ads API erişimi artık kullanmadığınız bir Google Cloud projesine atanmışsa sizin tarafınızdan başka bir işlem yapılması gerekmez. Google, kullanılmayan proje için 90 gün boyunca işlem yapılmadığında API erişimini iptal eder.

Google Cloud projemde API erişim düzeyleri atanmamış. Bu sorunu nasıl düzeltebilirim?

Google Cloud projeniz, geliştirici jetonunuzun erişim düzeyini devralmadı. Bunun nedeni, büyük olasılıkla geliştirici jetonunuzu ve Cloud projesini API çağrısı yapmak için hiç kullanmamış olmanız veya geliştirici jetonunuzun API erişiminin son zamanlarda etkinlik olmaması nedeniyle sona ermiş olmasıdır. Sorunu düzeltmek için Google Ads API'ye Genel Bakış sayfasından ilgili proje için uygun API erişim düzeyine başvurun. Örneğe göz atın.

Projelerimin API erişim düzeylerini nerede görebilirim?

Google Cloud projenizin API erişim düzeyini Google Ads API'ye Genel Bakış sayfasından görebilirsiniz.

Daha yüksek API erişim düzeyleri için nasıl başvurabilirim?

Google Cloud projeniz için Google Ads API'ye Genel Bakış sayfasından daha yüksek API erişim düzeyleri için başvuruda bulunabilirsiniz.

Beklemede olan API erişimi uygulamama ne olur?

Google Ads yönetici hesabınızın API Merkezi'nden 9 Eylül 2026 tarihinden önce başlattığınız tüm bekleyen Temel Erişim uygulamaları kapatılacak. Google Cloud projenizin Google Ads API'ye Genel Bakış sayfasından Temel Erişim için yeniden başvurmanız gerekir. Bu değişiklikten etkileniyorsanız gerekli talimatları içeren bir e-posta alırsınız.

Google Ads yönetici hesabınızın API Merkezi'nden 9 Eylül 2026 itibarıyla başlattığınız tüm beklemedeki Standart Erişim uygulamaları her zamanki gibi incelenecektir. Başvurunuz onaylanırsa geliştirici jetonunuzla ilişkili Google Cloud projesine Standart Erişim verilir.

Onaylanmış geliştirici jetonumu yeni bir Google Cloud projesiyle yeniden ilişkilendirebilir miyim?

Geçmişte Google Ads API Ekibi, geliştirici jetonunun yeni bir Google Cloud projesiyle yeniden ilişkilendirilmesini her destek kaydı için ayrı ayrı destekliyordu. Geliştirici jetonlarının desteği sonlandırıldığından bu özellik, 9 Eylül 2026 itibarıyla artık desteklenmeyecek. Yeni bir Google Cloud projesi kullanmanız gerekiyorsa Google Cloud projenizin Google Ads API'ye Genel Bakış sayfasından uygun API erişimi için başvuruda bulunmanız gerekir.

Onaylanmış bir geliştirici jetonum var ancak hiç kullanmadım. Bu geliştirici jetonunu kullanabilir miyim?

Hayır, bu geliştirici jetonunu kullanamazsınız. İki olasılık vardır:

  1. Geliştirici jetonu erişiminiz, etkinlik olmaması nedeniyle iptal edilebilir: Google politikalarına göre, API jetonunuz art arda 90 gün boyunca kullanılmadığı takdirde Google tarafından iptal edilebilir. Geliştirici jetonunuzu bir süredir kullanmadıysanız erişim düzeyleri, etkinlik olmaması nedeniyle iptal edilmiş olabilir. Bu durumda, Google Ads API'ye Genel Bakış sayfasından Google Cloud projeniz için API erişimine yeniden başvurun. Örneğe göz atın.

  2. Geliştirici jetonunuz yakın zamanda onaylandı ancak 9 Eylül 2026'dan önce hiç kullanmadınız: Onaylanan geliştirici jetonunuzu 9 Eylül 2026'dan önce bir Google Cloud projesiyle hiç kullanmadığınız için erişim düzeyleri Cloud projesine aktarılmadı. Bu nedenle, geliştirici jetonunuzu artık kullanamazsınız. Bu geliştirici jetonuyla bir üretim hesabına API çağrısı yapmaya çalışırsanız CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION hatası gösterilir. Hatayı düzeltmek için Google Cloud projenizin Google Ads API'ye Genel Bakış sayfasından uygun API erişimi için başvurun. Örneğe göz atın.

Bu iki durumda da Explorer Access ve Basic Access seviyesi uygulamalarına başvurabilir ve bunların otomatik olarak incelenmesini sağlayabilirsiniz. İnceleme sürecini tamamlamak için artık Google'ın Uygunluk Ekibi ile çalışmanız gerekmez. Standart erişime ihtiyacınız varsa manuel inceleme gerekir. Ancak Standart Erişim için başvururken onaylanmış geliştirici jetonu ayrıntılarınızı paylaşabilirsiniz. Böylece Uygunluk Ekibi, yeni Standart Erişim başvurunuzu buna göre inceleyebilir.

API isteklerimin bir parçası olarak geliştirici jetonları göndermeyi durdurabilir miyim?

Evet, API istekleriniz kapsamında geliştirici jetonları göndermeyi durdurabilirsiniz. İstemci kitaplığı kullanıyorsanız en yeni sürüme yükseltmeniz gerekebilir. Kitaplığın geliştirici jetonu belirtmeden API çağrıları yapmayı destekleyip desteklemediğini onaylamak için kitaplığın değişiklik günlüklerini kontrol edin.

Cloud tarafından yönetilen erişim düzeyi pilot programına katılmıştım. Bu durum beni nasıl etkiler?

Bulut tarafından yönetilen erişim düzeyi pilot programı, Google Cloud geliştiricilerinin API isteğinin bir parçası olarak geliştirici jetonu göndermeden API çağrıları yapabilmesi için kullanıma sunulmuştur. Geliştirici jetonlarının desteği sonlandırıldığından bu program da sonlandırılacaktır.

Etkin geliştirici jetonunuzun erişim düzeyleri Google Cloud projenize aktarıldı. Bu nedenle, mevcut kodunuz herhangi bir değişiklik yapılmadan çalışmaya devam etmelidir. Yeni bir Google Cloud projesi kullanmanız gerekiyorsa Google Cloud projenizin Google Ads API'ye Genel Bakış sayfasından API erişimi için başvuruda bulunmanız gerekir.

Geliştirici jetonum, izin verilenler listesindeydi. Bu durum beni nasıl etkiler?

Google, bazı geliştiricilere deneysel özelliklere erişim imkanı veren pilot programlar yürütebilir. Bu özelliklere erişim bazen geliştirici jetonunuzu izin verilenler listesine ekleyerek sağlanır. Bu tür bir pilot programa katıldıysanız herhangi bir işlem yapmanız gerekmez.

Tüm pilot programları, izin verilenler listesi mekanizması olarak geliştirici jetonları yerine Google Cloud projelerini kullanacak şekilde güncelledik ve geliştirici jetonunun izin verilenler listesi durumunu ilişkili Google Cloud projelerine aktardık. Mevcut kodunuz herhangi bir değişiklik yapılmadan çalışmaya devam etmelidir. Sorun yaşamaya devam ederseniz sizi pilot programa kaydeden Google Hesap Yöneticinizle iletişime geçin.

Onaylanmış bir geliştirici jetonum var ve bunu yeni bir Google Cloud projesiyle kullanmak istiyorum. Buna izin veriliyor mu?

Hayır, onaylanmış geliştirici jetonunuzla yeni bir Google Cloud projesi kullanamazsınız. Onaylanmış geliştirici jetonunuzu 9 Eylül 2026'dan önce yeni Google Cloud projesiyle hiç kullanmadığınız için erişim düzeyleri Cloud projesine aktarılmadı. Geliştirici jetonları artık API erişim seviyelerinizi belirlemek için kullanılmadığından bu geliştirici jetonuyla API çağrısı yapmaya çalışırsanız CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION hatası alırsınız. Hatayı düzeltmek için Google Cloud projenizin Google Ads API'ye Genel Bakış sayfasından uygun API erişimi için başvurun. Örneğe göz atın.

Geliştirici jetonum harici olarak sızdırıldı. Geliştirici jetonumu sıfırlamam gerekiyor mu?

Hayır, bu durumda geliştirici jetonunu sıfırlamanız gerekmez. Geliştirici jetonunuzun API erişim düzeylerini Google Cloud projenize aktardığımız için yetkisiz bir kullanıcı artık geliştirici jetonunuzu kendi Google Cloud projesiyle kullanamaz. Ancak isterseniz geliştirici jetonunu API Merkezi'nden sıfırlayabilirsiniz.

API Merkezi'ne ne olacak?

Google Ads yönetici hesabındaki mevcut API Merkezi sayfasının desteği sonlandırıldı ve yakın gelecekte kaldırılacak. Zaten bir geliştirici jetonunuz varsa Google Ads yönetici hesabınızda oturum açıp ayrıntıları görüntüleyebilirsiniz. Ancak bunlar yalnızca referans amaçlıdır. Bu sayfadan daha yüksek API erişim düzeylerine başvurmak gibi geliştirici jetonu erişim düzeyleriyle ilgili hiçbir görev yapmayın.

Daha yüksek API erişim düzeyleri için başvurmanız gerekiyorsa bunu Google Cloud projenizin Google Ads API'ye Genel Bakış sayfasından yapmanız gerekir.

Google Ads API'yi kullanmak için Google Ads yönetici hesabına ihtiyacım var mı?

Google Ads API'yi kullanmak için artık Google Ads yönetici hesabına ihtiyacınız yok. API'yi kullanarak birden fazla hesabı bağlamanız ve yönetmeniz gerekiyorsa yönetici hesabına ihtiyacınız vardır.

Yeni bir geliştiriciyim. Google Ads API'ye nasıl kaydolabilirim?

Google Ads API'ye kaydolmak için Başlangıç kılavuzundaki talimatları uygulayın. Google Ads yönetici hesabınızın API Merkezi'nden geliştirici jetonu için kaydolmayın. Bu başvurular işleme alınmaz. API Merkezi, yakın gelecekte kullanımdan kaldırılacak.

Sonraki
Erişim düzeyleri ve izin verilen kullanım