Geliştirici jetonu, uygulamanızın Google Ads API'ye bağlanmasını sağlayan 22 karakterlik alfanümerik bir dizedir. Google Ads yönetici hesabınızın API Merkezi sayfasından kaydolarak bir tane edinebilirsiniz. Her API çağrısı yaptığınızda, developer-token http veya gRPC başlığını ayarlayarak isteğin bir parçası olarak geliştirici jetonunu gönderirsiniz.
Her geliştirici jetonuna bir erişim düzeyi atanır. Bu düzey, jetonla günlük olarak yapabileceğiniz API çağrılarının sayısını ve çağrı yapabileceğiniz ortamı kontrol eder.
Geliştirici jetonu için kaydolduğunuzda varsayılan olarak Explorer Access düzeyinde erişim izni verilebilir. Bu sayede, üretim hesaplarına karşı belirli kısıtlamalarla çağrı yapabilirsiniz. Geliştirici jetonu başvurunuzu otomatik olarak inceleyemediğimiz bazı durumlarda, geliştirici jetonunuza Test Hesabı Erişimi düzeyi verebiliriz. Bu, yalnızca test hesaplarına karşı API çağrıları yapmanıza olanak tanır. Kaşif ve test hesabı erişim düzeylerindeki kısıtlamaları kaldırmak için geliştirici jetonunuzun Temel Erişim veya Standart Erişim düzeyinde olmasını talep etmeniz gerekir. Geliştirici jetonu başvurunuz incelenip onaylandıktan sonra geliştirici jetonunuza uygun erişim düzeyi verilir.
Yeni bir geliştirici jetonuna mı ihtiyacınız var?
Yeni bir geliştirici jetonuna kaydolup kaydolmamanız birkaç faktöre bağlıdır. Aşağıda, olası bazı yaygın durumlar verilmiştir:
Senaryo |
Sonraki adımlar |
| Şirketiniz daha önce hiç Google Ads API'yi kullanmadı ve kendi uygulamalarınızı geliştirmek istiyorsunuz | Yeni bir geliştirici jetonu için kaydolun. Daha fazla bilgi |
| Şirketiniz Google Ads API'yi etkin bir şekilde kullanıyor veya geçmişte kullanmış olmalı. | Google genellikle şirket başına bir geliştirici jetonu verir. Bu nedenle, şirketiniz Google Ads API'yi zaten kullanıyorsa mevcut geliştirici jetonunuzu yeniden kullanmanız gerekir. Daha fazla bilgi |
| Şirketiniz Google Ads API'yi zaten kullanıyor ancak yeni bir ürün veya araç da geliştiriyor. | Mevcut geliştirici jetonunuzu kullanamayacağınızdan eminseniz kullanım alanınızı başvuruda açıklayarak yeni bir jeton için başvurabilirsiniz. Bu kılavuzun geri kalanında mevcut geliştirici jetonunuzu kullanabilirsiniz. Daha fazla bilgi |
| Şirketiniz üçüncü taraf bir uygulama kullanıyorsa | Yalnızca kendi uygulamanızı geliştiriyorsanız geliştirici jetonuna ihtiyacınız vardır. Üçüncü taraf uygulaması veya hizmeti kullanıyorsanız bu uygulamanın geliştiricisinin uygulama için geliştirici jetonu alması gerekir. Durumunuzdan emin değilseniz API uygunluk ekibiyle iletişime geçin. |
Kimler geliştirici jetonu için başvurabilir?
Hem şirketler hem de bağımsız geliştiriciler geliştirici jetonu için başvurabilir. Aşağıdaki tabloda, geliştirici jetonuna kaydolurken sağlamanız gereken ayrıntılar özetlenmiştir.
| Şu durumlarda: | Ardından aşağıdaki geliştirici bilgilerini sağlayın: | Ek notlar |
|---|---|---|
| Şirketinizi veya bir ürün ekibini temsil eden bir geliştirici | Şirketinizin adı ve şirketinizin URL'si | Google genellikle şirket başına bir geliştirici jetonu verir ancak ayrı araçlar için ayrı geliştirici jetonlarını duruma göre onaylar. |
| Bir şirketi temsil etmeyen bireysel geliştirici | Şirketinizin adını Individual olarak belirtin. Şirket URL'si yerine GitHub profilinizin URL'si veya LinkedIn profilinizin URL'si gibi alternatif URL'ler sağlayabilirsiniz. |
Çevrimiçi varlığınız olmalı ve Google Ads API ile ne yapmayı planladığınızı değerlendirmemize yardımcı olacak bir URL sağlamalısınız. test.com ve example.com gibi genel URL'ler kabul edilmez. |
Geliştirici jetonu için nasıl başvurulur?
Geliştirici jetonu için başvuruda bulunurken iki adım vardır.
1. adım: Google Ads yönetici hesabı seçin veya oluşturun
Zaten bir Google Ads yönetici hesabınız varsa geliştirici jetonuna başvururken bu hesabı seçin. Bu yönetici hesabı diğer hesaplarınıza henüz bağlı değilse jeton inceleme sürecini kolaylaştırmak ve hesap yönetimini basitleştirmek için bu hesabı hesap hiyerarşinizin kök dizinine yerleştirmenizi öneririz.
Yönetici hesabınız yoksa Yardım Merkezi'ndeki talimatları uygulayarak hesap oluşturabilirsiniz.
2. adım: Google Ads API'ye erişim için başvurun
Geliştirici jetonu inceleme sürecinin tamamlanması biraz zaman alabilir. Daha fazla bilgi
Web tarayıcınızda https://ads.google.com/aw/apicenter adresine gidin. İstenirse Google Ads yönetici hesabınızda oturum açın.
API erişim formunu doldurun ve Hükümler ve Koşullar'ı kabul edin.
Bilgilerinizin doğru olduğundan ve şirketinizin web sitesi URL'sinin çalıştığından emin olun. Web sitesi yayında değilse Google, başvurunuzu işleme alamayabilir ve başvurunuzu reddedebilir.
Sağladığınız API iletişim e-posta adresinin düzenli olarak izlenen bir gelen kutusuna yönlendirdiğinden emin olun. Google'ın API uygunluk ekibi, inceleme sürecinde netleştirmek istediği konularla ilgili olarak bu e-posta adresinden sizinle iletişime geçebilir. Size ulaşılamazsa Google, başvurunuza devam etmeyebilir.
API iletişim e-posta adresinizi API Merkezi'nde düzenleyebilirsiniz. Google'ın size önemli hizmet duyuruları gönderebilmesi için bu bilgileri, başvuru sürecinden sonra bile güncel tutun.
Başvuru sürecini tamamladıktan sonra, geliştirici jetonu API merkezinizde aşağıdaki sonuçlardan biriyle gösterilir:
- Geliştirici jetonunuzun Onaylandı durumunda Explorer Access düzeyi var. Bu, Google'ın Explorer Access düzeyindeki geliştirici jetonu başvurunuzu otomatik olarak inceleyip onaylayabildiği anlamına gelir. Üretim hesabınızda veya test hesabınızda API çağrıları yapmaya başlayabilirsiniz.
- Geliştirici jetonunuzun Test Hesabı Erişimi düzeyinde ve Onay Bekliyor durumunda olması. Bu, Google'ın Explorer Access düzeyi için geliştirici jetonu başvurunuzu otomatik olarak inceleyip onaylayamadığı anlamına gelir. Test hesaplarına karşı API çağrıları yapmaya başlayabilirsiniz. Bu kılavuzu tamamladıktan sonra Temel Erişim düzeyine nasıl başvuracağınızı öğrenmenizi öneririz.
Google Ads yönetici hesabında oturum açıp açmadığınızı doğrulayın.
Geliştirici jetonunuza erişmek için Google Ads yönetici hesabınızda oturum açmanız gerekir. Bu hesap, Google Ads test yönetici hesabı olamaz.
Google Ads yönetici hesabında oturum açıp açmadığınızı doğrulamak için aşağıdaki adımları uygulayın:
Web tarayıcınızda https://ads.google.com/aw/apicenter adresine gidin.
Bir müşteri hesabına giriş yaptıysanız sayfada API Merkezi yalnızca yönetici hesapları tarafından kullanılabilir. mesajı gösterilir.
Sağ üst köşede Test hesabı kırmızı renkte görünüyorsa hesabınız test yöneticisi veya test reklamverendir.
Geliştirici jetonunuzu nerede bulabilirsiniz?
Geliştirici jetonu varsa Google Ads yönetici hesabınızın API Merkezi sayfasında bulabilirsiniz.