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 gerçekleştirebileceğ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 sırayla listelenen dört farklı API erişim düzeyi vardır. Google Ads API erişiminiz yoksa Google Cloud projeniz için test erişim düzeyi 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şebilenler... | Günlük işlem sınırı 1 | Nasıl başvurulur? | İncelemeler genellikle ne kadar sürer? |
|---|---|---|---|---|
| Test | Test hesapları | Günde 15.000 işlem | Test erişimi için başvuruda bulunma | |
| Kaşif | Test ve üretim hesapları | Üretim hesapları için günde 2.880 işlem Test hesapları için günde 15.000 işlem |
Explorer erişimi için başvuruda bulunma | |
| Temel | Test ve üretim hesapları | Hem test hem de üretim hesapları için 15.000 işlem / gün | Temel erişim için başvuruda bulunma | |
| Standart | Test ve üretim hesapları | Hem test hem de üretim hesapları için günlük sınırsız işlem | 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 belirlenen istek sınırını aşarsa hata alır.
Erişimi test etme
Google Ads API'yi etkinleştirdikten sonra Google Cloud projenize test erişimi verilir. Bu, projenin yalnızca test hesaplarına karşı Google Ads API istekleri gönderebileceği anlamına gelir.
Test erişimi için başvurma
Projeniz için otomatik olarak test erişimi verilmesi amacıyla Google Cloud projenizde Google Ads API'yi etkinleştirin.
Explorer erişim düzeyi
Google Ads API'ye ilk kaydı 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 yayında olan Google reklamları yayınlayan hesaplardır. Test hesapları reklam yayınlamaz.
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 sınır, çoğu geliştiricinin API'yi kullanmaya başlaması ve temel otomasyonlar oluşturması için yeterlidir.
Keşif 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ıtlı İşlevsellik | Kısıtlanmış Hizmetler ve Yöntemler |
|---|---|
| Hesap oluşturma | CustomerService.CreateCustomerClient |
| Kullanıcı yönetimi | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| Planlama | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Hesap Faturalandırması ve Ödeme | 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üzeyi'nin Explorer 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'a yükseltebilir.
Temel erişim düzeyi
Temel erişim düzeyi, Google Cloud projenizin hem test hesapları hem de üretim hesapları için Google Ads API istekleri göndermesine olanak tanır. Üretim hesapları, gerçek ve yayında olan Google reklamları yayınlayan hesaplardır. Test hesapları reklam yayınlamaz.
Temel erişim düzeyi,Google Cloud projenizin günde en fazla 15.000 işlem yürütmesine 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ükseltme 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ğrulamasını 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üzeyine başvurmak için Erişim için başvur düğmesini tıklayın.
Başvurunuzu gönderdikten sonra Google, projenizin API erişim düzeyini otomatik olarak Temel'e 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 yapmasına olanak tanır. Tek tek hizmetler ve özellikler, bu özelliklere özgü sıklık sınırlamaları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ş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
- 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 açma erişimi sağlamaya hazır olun. Aracınızın Gerekli Minimum İşlevler'e uygun olması gerektiğini unutmayın.
İnceleme süreci boyunca Google Uygunluk Ekibi, e-posta adresinizi kullanarak sizinle iletişim kurar. Standart erişim başvurunuzun ilerlemesi için Uygunluk ekibinden gelen sorulara hemen yanıt verdiğinizden emin olun. İnceleme tamamlandığında Google, inceleme sürecinin nihai sonucunu e-postayla size bildirir.
API kotaları ve sistem sıklık sınırlamaları
Erişim düzeyinden bağımsız olarak tüm API işlemleri, sistem sıklık sınırlarına tabidir. Bu sınırlar, belirli bir süre içinde gerçekleştirebileceğiniz işlem sayısını (saat başına işlem sayısı) kısıtlar. Sıklık sınırlaması hatalarını nasıl ele alacağınız hakkında daha fazla bilgi edinmek için hata türleri bölümüne bakın.
Ürün tasarımındaki sınırlamalar, ürün politikası kısıtlamaları, API performansı ve gecikme süresi 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 belgelere bakın.
İzin verilen kullanım
İzin verilen kullanım yalnızca Standart erişim düzeyine sahip Google Cloud projeleri için geçerlidir. İzin verilen kullanım, Google Ads API'nin amaçlanan kullanımına göre belirlenir. Bu izinler, aracınızın API'nin hangi özelliklerini kullanabileceğini belirler. Bu özellikler aşağıdaki tabloda ayrıntılı olarak açıklanmıştır:
| İzin Verilen Kullanım | Açıklama |
|---|---|
| Reklam oluşturma / yönetme | Google Ads kampanyaları, reklam grupları, reklamlar ve anahtar kelimeler oluşturmak ve 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 okunur ç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 | Google Cloud projesinin RecommendationService, KeywordPlanIdeaService ve KeywordPlanService'e 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ın güncellenmesi için başvuru formunu doldurabilirsiniz. İzin verilen kullanımınızı güncellemek veya müşterilerinize aracınıza erişim izni vermek istiyorsanız başvuruyu doldurun.