Bu özellik, API erişim düzeylerinizin Google Cloud kuruluşları tarafından yönetilmesini sağlar ve aşağıdaki avantajları sunar:
Geliştirici jetonlarının güvenliğini sağlama ihtiyacı ortadan kalktı: API erişimi Google Cloud kuruluşu üzerinden yönetildiğinden artık geliştirici jetonlarının güvenliğini sağlama veya sızdırılma konusunda endişelenmenize gerek kalmaz. Erişim jetonu göndermeniz gerekse de API çağrılarınızda geliştirici jetonunuzu göndermeyi atlayabilirsiniz.
Farklı uygulamalar için ayrı Google API Konsolu projeleri oluşturun: Google Cloud kuruluşu altında bağlantı oluşturulan tüm projeler, kuruluşun API erişim düzeyini devralır. Bu sayede, 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şturabilirsiniz.
Daha ayrıntılı kota izleme ve yönetimi: Tek tek projelerin API kullanımını izleyebilir veya API kullanımına sınır koyabilirsiniz.
Ön koşullar
Onaylanmış bir geliştirici jetonu
Bu seçeneği kullanmak için onaylı bir geliştirici jetonunuz olmalıdır. Mevcut bir geliştirici jetonunu Google Ads yönetici hesabınızdaki API Merkezi'nde bulabilirsiniz. Oturum açın ve Yönetici > API Merkezi'ne gidin. API Merkezi'nde API Erişimi > Geliştirici jetonu'na gidin.
Google Cloud kuruluşu
Google Ads API, geliştirici jetonunuzu bir Google Cloud kuruluşuna bağlar ve API erişim seviyelerinizi belirlemek için bu jetonu kullanır. Google Cloud kuruluşu oluşturmanın birden fazla yolu vardır.
Senaryo Adımlar Mevcut bir Google Workspace veya Google Cloud Identity müşterisiyseniz Büyük olasılıkla zaten bir kuruluş kaynağınız vardır. Gerekirse kontrol edebilir ve oluşturabilirsiniz. Google Workspace veya Google Cloud Identity kullanmıyorsanız Google Cloud Identity'nin ücretsiz sürümüne kaydolun. Ardından kuruluş kaynağınızı oluşturun. Yukarıdaki seçeneklerden hiçbiri sizin için uygun değilse Pilot programa kaydolduğunuzda senaryonuzu açıklayın ve Google'dan sizin için bir kuruluş kaynağı oluşturmasını isteyin. Google, bu kuruluş kaynağının sahibi ve yöneticisi olacaktır. Bu işlem ücretsizdir. Google API Konsolu projelerinizi pilot programa hazırlama
Google Ads API ile kullandığınız Google API Konsolu projelerini pilot programa aşağıdaki şekilde hazırlamanız gerekir:
Senaryo Adımlar Zaten bir Google Cloud kuruluşunuz varsa veya önceki adımda bir kuruluş oluşturduysanız 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 büyük olasılıkla kuruluşunuzun altındadır. Bu nedenle bu adımı atlayabilirsiniz.
Google Cloud kuruluşunuz yoksa ve önceki adımda kuruluş oluşturamadıysanız Hem Google Ads API yöneticisi hesabınızda hem de Google API Konsolu projenizde yönetici kullanıcı olduğunuzdan emin olun. Pilot uygulamanız onaylandıktan sonra ek adımlar gerçekleştirmek için bu izne ihtiyacınız vardır. Güncel bir API iletişim e-posta adresi
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 listelenir. Oturum açın ve ARAÇLAR VE AYARLAR > KURULUM > API Merkezi'ne gidin.
Pilot programa kaydolma
Pilot programa kaydolun. Google Uygunluk Ekibi, başvurunuzu inceleyip API iletişim e-posta adresinize onay durumu ve ek ayrıntılarla ilgili bir e-posta gönderir.
Google'dan sizin için bir Google Cloud kuruluşu oluşturmasını istediyseniz birkaç ek adım daha vardır:
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ü verilir.Google, yeni oluşturulan kuruluş kaynağının ayrıntılarını içeren bir e-postayı 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şun altına taşıma talimatlarını uygulamanız gerekir.
Projelerinizin yeni kuruluş altına taşındığını Google'a bildirmek için e-postayı yanıtlayın.
Google Uygunluk Ekibi, başvurunuzu inceler ve API'nizle ilgili onay durumu ve ek ayrıntılar hakkında bilgi vermek için API'nizle ilgili iletişim e-posta adresinize e-posta gönderir.
API isteklerinizi değiştirme
API çağrıları yaparken developer-token üstbilgisinin gönderilmesini durdurmak için uygulamanızı değiştirebilirsiniz. Bu adım isteğe bağlı olmakla birlikte önerilir. Pilot programdaysanız Google Ads API sunucusu, API isteklerinin bir parçası olarak gönderilirse developer-token değerini 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/v20/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
Bulut tarafından yönetilen erişim düzeyleri hakkında sık sorulan bazı soruları aşağıda bulabilirsiniz.
Bu değişiklik, Google Ads API'yi kullanmak için Google Workspace veya Google Cloud müşterisi olmam gerektiği anlamına mı geliyor?
Hayır. Çeşitli şekillerde edinilebilen bir Google Cloud kuruluşuna ihtiyacınız vardır. Bu koşul, Google Ads API'yi kullanmak için Google API Konsolu projesine sahip olmanız gerektiğine 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 kaydolmak için herhangi bir kesinti süresi 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 programa katılmak için ne kadar çaba gerekir?
Minimum düzeyde kod değişikliği yapılması gerekir. Çoğu geliştirici, uygulamasında değişiklikleri 30 dakikadan kısa sürede tamamlayabilir.
Bu pilot programa kaydolursam benden ödeme alınır mı?
Genel olarak, bu pilot programa kaydolursanız sizden ücret alınmaz. Google Ads API ücretsiz olarak sunulur ve Google, Google Ads API fiyatlandırma modelinde herhangi bir değişiklik yapmaz.
Google Cloud kuruluşu edinmeyle ilgili olası senaryolar şunlardır:
Mevcut bir Google Workspace veya Google Cloud Identity müşterisiyseniz:
Bu ürünlerin normal 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:
Google Cloud Identity Free Edition hesabına kaydolduğunuzda veya bu pilot programa katılmak amacıyla Google Cloud kuruluşu oluşturduğunuzda sizden ücret alınmaz.
Google sizin için bir Cloud kuruluş kaynağı oluşturduysa:
Bu, Google tarafından yönetilen dahili bir Cloud kuruluş kaynağıdır. Bu nedenle, sonuç olarak sizden ücret alınmaz.
Farklı araçlar için birden fazla geliştirici jetonum var. Bu pilot uygulama beni nasıl etkiler?
Bu kullanım alanı desteklenmediği için bu pilot programa 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 katıldım ve sorun yaşıyorum veya geri bildirimde bulunmak istiyorum. Destek ekibiyle nasıl iletişime geçebilirim?
API teknik destek sayfasını kullanarak Google Ads API Ekibi ile iletişime geçin ve sorununuzun niteliğini açıklayın. Mümkün olduğunda kuruluş kimliğiniz, istek ve yanıt günlükleri gibi ayrıntıları ekleyin.