Google Cloud projenize 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, projenin kullanmasına izin verilen belirli Google Ads API özelliklerini belirler.
Erişim düzeyleri
Tabloda dört farklı API erişim düzeyi sıralı olarak listelenmiştir. Google Ads API erişiminiz yoksa Google Cloud projeniz için Test Hesabı Erişimi düzeyinde erişim elde etmek üzere API'yi etkinleştirerek 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 limiti 1 | Nasıl başvurulur? | İncelemeler genellikle ne kadar sürer? |
|---|---|---|---|---|
| Test hesabı erişim düzeyi | Test hesapları | 15.000 işlem / gün | Test Hesabı Erişimi İçin Başvurun | |
| 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 |
Explorer erişimi için başvuruda bulunma | |
| Temel erişim düzeyi | Test ve üretim hesapları | Hem test hem de üretim hesapları için 15.000 işlem / gün | Temel Erişim için başvurma | |
| 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 | Standart erişim için başvurma | 10 iş günü |
1 "Günlük", Google Cloud projenizle 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'yi etkinleştirdikten sonra Google Cloud projenize TestHesabı erişim düzeyi verilir. Bu, projenin yalnızca test hesaplarına karşı Google Ads API istekleri yapabileceği anlamına gelir.
Test hesabı erişim düzeyi için başvurma
Projeniz için Test Hesabı Erişimi düzeyinin otomatik olarak verilmesi amacıyla Google Cloud projenizde Google Ads API'yi etkinleştirin.
Explorer erişim düzeyi
Google Ads API'ye ilk kaydolma işlemini tamamladıktan sonra Google, Explorer erişim düzeyi için başvurmanıza izin verebilir.
Gezgin erişim düzeyi, Google Cloud projenizin 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ığı tüm hesaplardır. Test hesaplarında reklam yayınlanmaz.
Explorer erişim düzeyi,Google Cloud projenizin üretim hesaplarına karşı günde en fazla 2.880 işlem yürütmesine 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 | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| Planlama | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Hesap Faturalandırması ve Ödemesi | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Explorer erişim düzeyi için başvurma
- Google Cloud projenizde Google Ads API'ye Genel Bakış sayfasına gidin.
- Sayfada mevcut erişim düzeyinizin Test olarak gösterildiğini doğrulayın.
- Erişim düzeyini yükselt bölümünü tıklayarak genişletin.
- Sonraki erişim düzeyinin Kaşif olarak gösterildiğini doğrulayın.
- Explorer erişim düzeyine başvurmak için Erişim için başvur düğmesini tıklayın.
Google, başvurunuzu gönderdikten sonra projenizin API erişim düzeyini otomatik olarak Explorer Access düzeyine yükseltebilir.
Temel erişim düzeyi
Temel erişim düzeyi, Google Cloud projenizin 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ığı tüm hesaplardır. Test hesaplarında reklam yayınlanmaz.
Temel erişim düzeyi,Google Cloud projenizin günde en fazla 15.000 işlem gerçekleştirmesine olanak tanır. Bu, çoğu geliştirici için yeterlidir.
Temel erişim düzeyi için başvurma
- Google Cloud projenizde Google Ads API'ye Genel Bakış sayfasına gidin.
- Sayfada mevcut erişim düzeyinizin Explorer olarak gösterildiğini doğrulayın.
- Erişim düzeyini yükselt bölümünü tıklayarak genişletin.
- Sonraki erişim düzeyi'nin Temel olarak gösterildiğini doğrulayın.
- Projeniz için marka doğrulama işlemini tamamlamadığınızı belirten bir uyarı olmadığından emin olun. Varsa devam etmeden önce talimatları uygulayarak marka doğrulamasını tamamlayın.
- Temel Erişim düzeyi için başvurmak üzere Erişim için başvur düğmesini tıklayın.
Google, başvurunuzu gönderdikten sonra projenizin API erişim düzeyini otomatik olarak Temel Erişim düzeyine yükseltebilir.
Standart erişim düzeyi
Standart erişim düzeyi, Google Cloud projenizin tüm hizmetler için günde sınırsız sayıda işlem yürütmesine olanak tanır. Tek tek hizmetler ve özellikler, bu özelliklere özgü hız sınırlarına ve kısıtlamalara sahip olmaya devam edebilir. Bu sınırlar ve kısıtlamalar, projenizin Standart Erişim düzeyi olsa bile geçerli olmaya devam eder.
Standart erişim düzeyi yalnızca sınırsız Google Ads API işlemleri 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
- Google Cloud projenizde Google Ads API'ye Genel Bakış sayfasına gidin.
- Sayfada mevcut erişim düzeyinizin Temel olarak gösterildiğini doğrulayın.
- Erişim düzeyini yükselt bölümünü tıklayarak genişletin.
- Sonraki erişim düzeyinin Standart olarak gösterildiğini doğrulayın.
- Standart erişim düzeyi başvurusunu başlatmak için Başvuruyu başlat düğmesini tıklayın.
Standart erişim başvurusu, uygulamanızın ayrıntılı bir manuel denetimini içerir. Aracınızın işlevselliği ve hedef kitlesiyle ilgili soruları yanıtlamaya hazır olun. Aracınız kuruluş dışından kullanıcılar tarafından kullanılıyorsa aracınıza demo oturum erişimi sağlamaya hazır olun. Aracınızın Gerekli Minimum İşlevsellik'e uygun olması gerektiğini unutmayın.
Google Uygunluk Ekibi, inceleme süreci boyunca e-posta adresinizi kullanarak sizinle iletişim kurar. Standart erişim başvurunuzun işleme alınması için Uygunluk Ekibi'nin sorularına hızlıca yanıt verin. İnceleme tamamlandıktan sonra Google, inceleme sürecinin nihai sonucuyla ilgili olarak size e-posta gönderir.
API kotaları ve sistem hız sınırları
Erişim düzeyinden bağımsız olarak tüm API işlemleri, sistem hız sınırlarına tabidir. Bu sınırlar, belirli bir süre içinde (ör. saatte) gerçekleştirebileceğiniz işlem sayısını kısıtlar. 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 Standart Erişim düzeylerine sahip Google Cloud projeleri için geçerlidir. İzin verilen kullanım, Google Ads API'nin amaçlanan kullanımına göre tahsis edilir. Bu izinler, aşağıdaki tabloda ayrıntılı olarak açıklandığı gibi, aracınızın API'nin hangi özelliklerini kullanabileceğ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ğlar. |
| Raporlama | Yalnızca GoogleAdsService.Search veya GoogleAdsService.SearchStream istekleri ya da salt okuma çağrıları yapın. Bu, yalnızca API'yi istatistik istemek için kullanan geliştiriciler içindir. |
| Anahtar kelimeleri ve önerileri araştırma | Google Cloud projesinin 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
Google Cloud projeniz 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.