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.
Cloud Console'da Google Ads API'ye Genel Bakış sayfasına gidin
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şlayabilir, ardından üretim hesaplarına erişmek için Google Ads API'ye Genel Bakış sayfasında Explorer erişimi için başvurabilirsiniz.
| 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şvurma | |
| Temel | Test ve üretim hesapları | Hem test hem de üretim hesapları için günde 15.000 işlem | Temel erişim için başvurma | |
| 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" ifadesi, Google Cloud projenizle API isteklerinin yapıldığı 24 saatlik kayan bir zaman dilimini temel alı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ı için 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 elde etmek üzere 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.
Explorer 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.
Explorer erişim düzeyi,Google Cloud projenizin üretim hesaplarında günde 2.880 işlem gerçekleştirmesine 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ükseltme 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 15.000'e kadar işlem yapmasına 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. Uyarı varsa devam etmeden önce marka doğrulamasını tamamlamak için talimatları uygulayı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. Bağımsız hizmet ve özelliklerin, kendilerine özgü sıklık sınırlamaları ve kısıtlamaları olabilir. Projeniz Standart erişim düzeyine sahip olsa bile bu sınırlamalar ve kısıtlamalar 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ükseltme 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şlevleri 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 işlevler ile uyumlu 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 size e-postayla bildirir.
API kotaları ve sistem sıklık sınırları
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ı sınırlamaları, ürün politikası kısıtlamaları, API performansı ve gecikme süresiyle ilgili hususlar gibi nedenlerle her hizmet, ek sınırlar 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 kullanım amacına göre tahsis edilir. 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 öneriler 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.