Erişim Düzeyleri ve İzin Verilen Kullanım

Her Google Ads API geliştirici jetonuna bir erişim düzeyi ve "izin verilen kullanım" atanır. Erişim düzeyi, üretim hesaplarını etkileyip etkileyemeyeceğinizi ve günlük olarak yürütebileceğiniz işlem ve istek sayısını belirler. İzin verilen kullanım, geliştirici jetonunun kullanmasına izin verilen belirli Google Ads API özelliklerini belirler.

Erişim düzeyleri

Tabloda dört farklı geliştirici jetonu erişim düzeyi sıralı olarak listelenmiştir. Google Ads API erişiminiz yoksa TestAccountAccess düzeyinde bir geliştirici jetonu almak için kaydolarak başlayabilirsiniz. Uygulamada bazı ek adımları tamamlayarak erişim düzeyini artırabilirsiniz.

Erişim düzeyi	Erişebilir...	Günlük işlem limiti1	Nasıl başvurulur?	İncelemeler genellikle ne kadar sürer?
Test hesabı erişim düzeyi	Test hesapları	15.000 işlem / gün	Talimatlar
Explorer erişim düzeyi	Test ve üretim hesapları	Üretim hesapları için 2.880 işlem / gün Test hesapları için 15.000 işlem / gün	Talimatlar
Temel erişim düzeyi	Test ve üretim hesapları	Hem test hem de üretim hesapları için 15.000 işlem / gün	Talimatlar	2 iş günü
Standart erişim düzeyi	Test ve üretim hesapları	Hem test hem de üretim hesapları için sınırsız işlem / gün	Talimatlar	10 iş günü

¹ "Günlük" ifadesi, geliştirici jetonunuzla API isteklerinin yapıldığı 24 saatlik bir zaman dilimine dayanır. Uygulamanız, son 24 saat içinde erişim düzeyiniz için istek sınırını aşarsa hata alır.

Test hesabı erişim düzeyi

Google Ads API'ye ilk kaydolma işlemini tamamladıktan sonra Test Hesabı Erişim düzeyinde bir geliştirici jetonu verilir. Bu, geliştirici jetonunun yalnızca test hesaplarına karşı Google Ads API istekleri yapabileceği anlamına gelir.

Test hesabı erişim düzeyi için nasıl başvurulur?

Test hesabı erişimi düzeyinin otomatik olarak verilmesi için Google Ads web arayüzünde Google Ads API'ye kaydolma işlemini tamamlayın.

Explorer erişim düzeyi

Google Ads API'ye ilk kaydolma işlemini tamamladıktan sonra Google, bazı durumlarda geliştirici jetonunuzu Test Hesabı Erişimi düzeyinden Gezgin Erişimi düzeyine otomatik olarak yükseltebilir. Gezgin erişim düzeyi, geliştirici jetonunun hem test hesaplarına hem de üretim hesaplarına karşı Google Ads API istekleri yapmasına olanak tanır. Üretim hesapları, gerçek ve canlı Google reklamlarının yayınlandığı hesaplardır. Test hesaplarında reklam yayınlanmaz.

Explorer erişim düzeyi,geliştirici jetonunun üretim hesaplarına karşı günde en fazla 2.880 işlem gerçekleştirmesine olanak tanır. Bu, çoğu geliştiricinin API'yi kullanmaya başlaması ve temel otomasyonlar oluşturması için yeterlidir.

Explorer erişim düzeyi, aşağıdaki özelliklere erişimi kısıtlar. Bu özellikleri kullanmanız gerekiyorsa Temel Erişim düzeyi veya Standart Erişim düzeyi için başvurmanız gerekir.

Kısıtlanmış İşlevsellik	Kısıtlanmış Hizmetler ve Yöntemler
Hesap oluşturma	CustomerService.CreateCustomerClient
Kullanıcı yönetimi	CustomerUserAccessInvitationService CustomerUserAccessService
Planlama	KeywordPlanService KeywordPlanIdeaService KeywordPlanCampaignService KeywordPlanCampaignKeywordService KeywordPlanAdGroupService KeywordPlanAdGroupKeywordService AudienceInsightsService KeywordPlanIdeaService ReachPlanService
Hesap Faturalandırması ve Ödemesi	PaymentsAccountService BillingSetupService AccountBudgetProposalService InvoiceService

Explorer erişim düzeyine nasıl başvurulur?

Google Ads web arayüzünde Google Ads API kaydını tamamlayın. Bazı durumlarda, kaydolma işlemini tamamladığınızda Google, geliştirici jetonunuzu otomatik olarak Explorer Access seviyesine yükseltebilir.

Temel erişim düzeyi

Temel erişim düzeyi, geliştirici jetonunun hem test hesaplarına hem de üretim hesaplarına karşı Google Ads API istekleri göndermesine olanak tanır. Üretim hesapları, gerçek ve canlı Google reklamlarının yayınlandığı hesaplardır. Test hesaplarında reklam yayınlanmaz.

Temel erişim düzeyi,geliştirici jetonunun günde 15.000'e kadar işlem yürütmesine olanak tanır. Bu, çoğu geliştirici için yeterlidir.

Temel erişim düzeyi için nasıl başvurulur?

Test Hesabı Erişim düzeyinde bir geliştirici jetonunuz varsa ve üretim hesabı erişimi için başvurmak istiyorsanız Temel Erişim düzeyi başvuru formunu doldurun. Aşağıdaki adımları tamamladığınızdan emin olun:

1. Test Hesabı Erişimi düzeyinde bir geliştirici jetonunuzun olduğundan emin olun.
2. API merkezindeki API İletişim E-postası'nın güncel olduğundan emin olun. API merkezini görmek için Google Ads yönetici hesabınıza giriş yapmanız gerekir. Geçerli ve düzenli olarak kontrol edilen bir e-posta adresi olmadan başvuru sürecini tamamlayamazsınız. Tüm etkin Google Ads hesaplarınızı API jetonlu Google Ads yönetici hesabına bağladığınızdan emin olun.

Standart erişim düzeyi

Standart erişim düzeyi, geliştirici jetonunun çoğu hizmet için günde sınırsız sayıda işlem yürütmesine olanak tanır. Bu, aşağıdakileri kapsar ancak bunlarla sınırlı değildir: GoogleAdsService Search ve SearchStream. Standart Erişim düzeyindeki sınırlar ve istisnalar hakkında daha fazla bilgi için API kotaları başlıklı makaleyi inceleyin.

Standart erişim düzeyi yalnızca sınırsız Google Ads API işlemi gerektiren geliştiricilere (ör. büyük şirketler veya çok sayıda kullanıcıya hizmet veren araçlar) verilir.

Standart erişim düzeyi için başvurma

Temel Erişim düzeyinde bir geliştirici jetonunuz varsa ve sınırsız Google Ads API işlemleri için başvuruda bulunmak istiyorsanız Standart Erişim düzeyi başvuru formunu doldurun.

Aracınız hariciyse aracınıza demo oturum açma erişimi sağlamaya hazır olun. Aracınızın Gerekli Minimum İşlevsellik politikasına uyması gerektiğini unutmayın.

API kotaları ve sistem hız sınırları

Erişim düzeyinden bağımsız olarak tüm API işlemleri, belirli bir süre içinde (ör. saatte) gerçekleştirebileceğiniz işlem sayısını kısıtlayan sistem hızı sınırlarına tabidir. Sıklık sınırı hatalarını ele alma hakkında daha fazla bilgi edinmek için hata türleri başlıklı makaleyi inceleyin.

Ürün tasarımındaki sınırlamalar, ürün politikası kısıtlamaları, API performansı ve gecikme gibi nedenlerle belirli hizmetler ek sınırlamalar ve kota kısıtlamaları uygulayabilir. Bu kısıtlamalar hakkında daha fazla bilgi edinmek için API kotaları ile ilgili dokümanlara bakın.

İzin verilen kullanım

İzin verilen kullanım yalnızca Temel Erişim ve Standart Erişim düzeylerine sahip geliştirici jetonları için geçerlidir. İzin verilen kullanım, Google Ads API'nin amaçlanan kullanımına göre belirlenir. Bu izinler, aşağıdaki tabloda ayrıntılı olarak açıklandığı gibi, bir geliştirici jetonunun API'nin hangi özellikleri için kullanılabileceğini belirler:

İzin Verilen Kullanım	Açıklama
Reklam oluşturma / yönetme	Google Ads kampanyaları, reklam grupları, reklamlar ve anahtar kelimeler oluşturup yönetmek için API'nin tüm hizmetlerine erişim sağlama.
Raporlama	Yalnızca GoogleAdsService.Search veya GoogleAdsService.SearchStream istekleri ya da salt okuma çağrıları yapın. Bu, API'yi yalnızca istatistik istemek için kullanan geliştiriciler içindir.
Anahtar kelimeleri ve önerileri araştırma	Geliştirici jetonunun RecommendationService, KeywordPlanIdeaService ve KeywordPlanService'a erişmesine izin verin. Bu yalnızca Google Ads kampanyalarının oluşturulmasını ve yönetilmesini kolaylaştırmak için öneri gerektiren araçlar tarafından kullanılır.

İzin verilen kullanımı değiştirme

Geliştirici jetonunuz Temel Erişim düzeyi veya Standart Erişim düzeyi için onaylandıysa izin verilen kullanımı güncelleme başvurusunu doldurabilirsiniz. İzin verilen kullanımınızı güncellemek veya müşterilerinize aracınıza erişim izni vermek istiyorsanız lütfen başvuruyu doldurun.