Bu özellik, API erişim düzeylerinizin bir Google Cloud kuruluşu tarafından yönetilmesine olanak tanır ve size aşağıdaki avantajları sağlar:
Geliştirici jetonlarını güvenli hale getirmeye gerek yoktur: API erişimi, Google Cloud kuruluşu üzerinden yönetilir. Bu sayede, artık geliştirici jetonlarını güvence altına alma veya sızdırma konusunda endişelenmenize gerek kalmaz. API çağrılarınızda geliştirici jetonunuzu göndermeyi atlayabilirsiniz, ancak yine de bir erişim jetonu göndermeniz gerekir.
Farklı uygulamalar için ayrı Google API Konsolu projeleri tutma: Google Cloud kuruluşu altında bağlı tüm projeler, kuruluşun API erişim düzeyini devralır. Bu, ayrıntılı proje yönetimi, farklı uygulamalar için ayrı projeler ve ekip üyeleriniz için birden fazla Google API Konsolu projesi gibi amaçlarla bu kuruluş altında birden fazla Google API Konsolu projesi oluşturmanıza olanak tanır.
Ayrıntılı kota izleme ve yönetimi: Ayrı ayrı projelerin API kullanımını izleyebilir veya API kullanımını sınırlayabilirsiniz.
Ön koşullar
Onaylanmış geliştirici jetonu
Bu seçeneği kullanmak için onaylanmış bir geliştirici jetonunuz olması gerekir. Mevcut bir geliştirici jetonunu, Google Ads yönetici hesabınızın API Merkezi sayfasında bulabilirsiniz. Oturum açın, ardından ARAÇLAR VE AYARLAR > KURULUM > API Merkezi'ne gidin.
Bir Google Cloud kuruluşu
Google Ads API, geliştirici jetonunuzu bir Google Cloud kuruluşuyla ilişkilendirir ve API erişim düzeylerinizi belirlemek için kullanır. Google Cloud kuruluşu oluşturmanın birden çok yolu vardır.
Senaryo Uygulanacak adımlar Mevcut bir Google Workspace veya Google Cloud Identity müşterisiyseniz Büyük olasılıkla zaten bir kuruluş kaynağınız var. Gerekirse kontrol edebilir ve buradan oluşturabilirsiniz. Google Workspace veya Google Cloud Identity kullanmıyorsunuz Google Cloud Identity'nin ücretsiz sürümüne kaydolun. Ardından kuruluş kaynağınızı oluşturun. Önceki seçeneklerin hiçbiri sizin için uygun değil Pilot programa kaydolduğunuzda ve Google'dan sizin için kuruluş kaynağı oluşturmasını istediğinizde yaşadığınız senaryoyu açıklayın. Bu kuruluş kaynağı Google'a ait ve ücretsiz olarak yönetilir. Google API Konsolu projelerinizi pilot programa hazırlama
Pilot program için Google Ads API ile kullandığınız Google API Konsolu projelerini aşağıdaki gibi hazırlamanız gerekiyor:
Senaryo Uygulanacak adımlar Google Cloud kuruluşunuz zaten var veya önceki adımda bir Google Cloud kuruluşu oluşturdunuz Google Ads API'yi etkinleştirdiğiniz tüm Google API Konsolu projelerinin bu kuruluş altında olduğundan emin olun. Değilse kuruluşun altına taşıyın. Mevcut bir Google Workspace veya Google Cloud Identity müşterisiyseniz Google API Konsolu projeleri zaten kuruluşunuzda yer alıyor olabilir. Dolayısıyla bu adımı atlayabilirsiniz.
Google Cloud kuruluşunuz yok ve önceki adımda bir Google Cloud kuruluşu oluşturamadınız Google Ads API yönetici hesabınızda ve Google API Konsolu projenizde yönetici kullanıcı olduğunuzdan emin olun. Pilot başvurunuz onaylandıktan sonra ek adımlar gerçekleştirebilmek için bu izne ihtiyacınız vardır. Güncel bir API iletişim e-postası
Google Ads API iletişim e-posta adresinizin güncel olduğundan emin olun. API iletişim bilgileriniz, Google Ads API yönetici hesabınızın API Merkezi sayfasında listelenmiştir. Oturum açın, ardından ARAÇLAR VE AYARLAR > KURULUM > API Merkezi'ne gidin.
Pilot programa kaydolma
Pilot programa kaydolun. Ardından Google Uygunluk ekibi, başvurunuzu inceler ve onay durumu ve ek ayrıntıların yer aldığı API iletişim e-posta adresinize e-posta gönderir.
Google'dan sizin için bir Google Cloud kuruluşu oluşturmasını istediyseniz şu adımları da uygulayabilirsiniz:
Google, sizin için Google'a ait bir Cloud kuruluş kaynağı oluşturur. Google Ads API yönetici hesabınızın tüm yöneticilerine, yeni oluşturulan kuruluşta
roles/resourcemanager.projectCreatorrolü verilecektir.Google, yeni oluşturulan kuruluş kaynağının ayrıntılarını API iletişim e-posta adresinize gönderir.
Google API Konsolu hesabınızda oturum açmanız ve Google API Konsolu projenizi yeni kuruluş altına taşıma talimatlarını uygulamanız gerekir.
Projelerinizin yeni kuruluşa taşındığını Google'a bildirmek için e-postayı yanıtlayın.
Google Uygunluk ekibi, başvurunuzu inceler ve onay durumu ve ek ayrıntıların yer aldığı API iletişim e-posta adresinize e-posta gönderir.
API isteklerinizi değiştirin
Uygulamanızı, API çağrıları yaparken developer-token üstbilgisi göndermeyi durduracak şekilde değiştirebilirsiniz. Bu, isteğe bağlı ancak önerilen bir adımdır. Pilot programdaysanız Google Ads API sunucusu, API isteklerinin bir parçası olarak gönderilirse developer-token öğesini yoksayar.
Java
Çok yakında!
.NET
Google Ads API.NET kitaplığının 17.1 .0 veya daha yeni bir sürümünü indirip yükleyin.
Ardından, kodunuzu aşağıdaki şekilde değiştirin:
// Create a client.
GoogleAdsClient client = new GoogleAdsClient();
// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;
// Make the API calls.
...
PHP
Çok yakında!
Python
Çok yakında!
Ruby
Çok yakında!
Perl
Çok yakında!
HTTP istemcisi (REST)
HTTP isteklerinizde developer-token üstbilgisini atlayın:
curl -i -X POST https://googleads.googleapis.com/v16/customers/CUSTOMER_ID/googleAds:searchStream \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "login-customer-id: LOGIN_CUSTOMER_ID" \
--data-binary "@query.json"
Sık sorulan sorular
Bu değişiklik, Google Ads API'yi kullanabilmek için Google Workspace veya Google Cloud müşterisi olmam gerektiği anlamına mı geliyor?
Hayır. Google Cloud kuruluşuna sahip olmanız gerekir. Bu kuruluş birçok farklı şekilde edinilebilir. Bu şart, şu anda Google Ads API'yi kullanmak için bir Google API Konsolu projesine ihtiyaç duymanıza benzer.
API erişim düzeylerimi değiştirmem gerekiyor. Bunu nasıl yapabilirim?
API erişim düzeylerinde değişiklik isteğinde bulunmak için şimdilik API Merkezi'ni kullanmaya devam etmeniz gerekir.
Bu pilot programa katılmak için herhangi bir kesinti var mı?
Hayır, yok. Google Ads API, onaylandıktan sonra otomatik olarak kuruluş düzeyindeki API erişim düzeylerini kullanmaya başlar.
Bu pilot uygulamaya katılmak için ne kadar çaba gerekiyor?
Minimum kod değişikliği ile karşılaşabilirsiniz. Çoğu geliştirici, uygulamasındaki değişiklikleri 30 dakikadan daha kısa bir sürede tamamlayabilmelidir.
Bu pilot programa katılırsam benden ücret alınır mı?
Genel olarak hayır, bu pilot programa kaydolursanız sizden ücret alınmaz. Google Ads API ücretsiz olarak sunulmaktadır ve Google, Google Ads API fiyatlandırma modelinde herhangi bir değişiklik yapmamaktadır.
Google Cloud kuruluşu edinmek için olası senaryolar şunlardır:
Mevcut bir Google Workspace veya Google Cloud Identity müşterisi olmanız gerekir:
Bu ürünlerin düzenli kullanımı için her zamanki gibi ücretlendirilirsiniz. Bu pilot programa katılmak amacıyla Google Cloud kuruluşu oluşturduğunuz için sizden ücret alınmaz.
Google Cloud Identity ücretsiz sürüm hesabı oluşturduysanız:
Bu pilot programa katılmak amacıyla Google Cloud Identity ücretsiz sürüm hesabına kaydolurken veya Google Cloud kuruluşu oluştururken sizden ücret alınmaz.
Google sizin için bir Cloud kuruluş kaynağı oluşturdu:
Bu, Google tarafından yönetilen dahili bir Cloud kuruluş kaynağıdır. Bu nedenle sizden ücret alınmaz.
Farklı araçlar için birden fazla geliştirici simgesi var. Bu pilot program beni nasıl etkileyecek?
Bu kullanım alanı desteklenmediği için bu pilota katılamazsınız.
Bu durum, Google Ads API'yi kullanarak yönettiğim hesaplardaki mevcut API yetkilendirmelerini etkiler mi?
Hayır, bu değişiklik, Google Ads API'yi kullanarak yönettiğiniz Google Ads hesaplarına yönelik mevcut API yetkilendirmelerini etkilemez.
Bu pilot programa kaydoldum ve bir sorunum var veya geri bildirimde bulunuyorum. Destek ekibiyle nasıl iletişime geçebilirim?
API teknik destek sayfasını kullanarak Google Ads API ekibiyle iletişime geçin ve sorununuzun yapısını açıklayın. Mümkün olduğunda kuruluşunuzun kimliğiniz ile istek ve yanıt günlükleri gibi ayrıntıları ekleyin.