Bu özellik, API erişim seviyelerinizin bir Google Cloud kuruluşu tarafından yönetilmesine olanak tanır ve aşağıdaki avantajları sağlar:
Geliştirici jetonlarının güvenliğini sağlamaya gerek yok: 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ırma konusunda endişelenmenize gerek yok. API çağrılarınızda geliştirici jetonunuzu göndermeyi atlayabilirsiniz ancak yine de erişim jetonu göndermeniz gerekir.
Farklı uygulamalar için ayrı Google API Konsolu projeleri kullanın: Google Cloud kuruluşunun altına bağlanan 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çlar doğrultusunda bu kuruluş altında birden fazla Google API Konsolu projesi oluşturabilirsiniz.
Daha ayrıntılı kota izleme ve yönetimi: Projelerin API kullanımını izleyebilir veya API kullanımını sınırlayabilirsiniz.
Ö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, ardından 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şuyla ilişkilendirir ve API erişim seviyelerinizi belirlemek için 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 Zaten bir kuruluş kaynağınız olabilir. Gerekirse kontrol edip bir tane 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çeneklerin hiçbiri sizin için uygun değilse Pilot programa kaydolurken senaryonuzu açıklayın ve Google'dan sizin için bir kuruluş kaynağı oluşturmasını isteyin. Bu kuruluş kaynağının sahibi Google'dır ve Google bu kaynağı ücretsiz olarak yönetir. Google API Konsolu projelerinizi pilot programa hazırlama
Google Ads API ile kullandığınız Google API Konsolu projelerini pilot program için 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şun altında olduğundan emin olun. Aksi takdirde kuruluşun altına taşıyın. Mevcut bir Google Workspace veya Google Cloud Identity müşterisiyseniz Google API Konsolu projeleri zaten kuruluşunuzun altındadır. Bu nedenle bu adımı atlayabilirsiniz.
Google Cloud kuruluşunuz yoksa ve önceki adımda oluşturamadıysanız Hem Google Ads API yönetici 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-postası
Google Ads API iletişim e-postanızı güncelleyin. API iletişim bilgileriniz, Google Ads API yönetici hesabınızın API Center sayfasında listelenir. 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 API iletişim e-posta adresinize onay durumunu ve ek bilgileri içeren bir e-posta gönderir.
Google'dan sizin için bir Google Cloud kuruluşu oluşturmasını istediyseniz birkaç ek adım daha uygulamanız gerekir:
Google, 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, API iletişim e-posta adresinize yeni oluşturulan kuruluş kaynağının ayrıntılarını içeren bir e-posta gönderir.
Google API Konsolu hesabınızda oturum açmanız ve Google API Konsolu projenizi yeni kuruluşun altına taşımayla ilgili talimatları 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 API iletişim e-posta adresinize onay durumunu ve ek bilgileri içeren bir e-posta gönderir.
API isteklerinizi değiştirme
Uygulamanızı, API çağrıları yaparken developer-token üstbilgisini 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önderilen developer-token değerini yoksayar.
Java
Çok yakında!
.NET
Google Ads API.NET kitaplığının 17.1 .0 veya sonraki bir sürümünü indirip yükleyin.
Ardından kodunuzu aşağıdaki gibi 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 üst bilgisini çıkarın:
curl -i -X POST https://googleads.googleapis.com/v18/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 kullanmak için Google Workspace veya Google Cloud müşterisi olmam gerektiği anlamına mı geliyor?
Hayır. Birçok yöntemle edinilebilen bir Google Cloud kuruluşunuz olmalıdır. Bu şart, Google Ads API'yi şu anda kullanmak için bir Google API Konsolu projesine ihtiyacınız olmasına benzer.
API erişim düzeylerimi değiştirmem gerekiyor. Bunu nasıl yapabilirim?"
API erişim seviyelerinde değişiklik isteğinde bulunmak için şimdilik API Center'ı kullanmaya devam etmeniz gerekir.
Bu pilot programa kaydolurken herhangi bir kesinti yaşanır mı?
Hayır, yok. Google Ads API, onaylandıktan sonra kuruluş düzeyindeki API erişim düzeylerini otomatik olarak kullanmaya başlar.
Bu pilot programa katılmak ne kadar çaba gerektirir?
Minimum düzeyde kod değişikliği yapmanız gerekir. Çoğu geliştirici, uygulamalarında gerekli değişiklikleri 30 dakikadan kısa sürede tamamlayabilir.
Bu pilot programı etkinleştirirsem benden ödeme alınır mı?
Genel olarak hayır, bu pilot programa kaydolduğunuzda sizden ödeme 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şturmanız için sizden ücret alınmaz.
Google Cloud Identity ücretsiz sürümü hesabı oluşturduysanız:
Google Cloud Identity ücretsiz sürümüne kaydolurken veya bu pilot programa katılmak için 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ğı olduğundan sizden ücret alınmaz.
Farklı araçlar için birden fazla geliştirici jetonum var. Bu pilot program beni nasıl etkiler?
Bu kullanım alanı desteklenmediğinden bu pilot programa katılamazsınız.
Bu durum, Google Ads API'yi kullanarak yönettiğim hesaplar için mevcut API yetkilendirmelerini etkiler mi?
Hayır, bu değişiklik Google Ads API'sini kullanarak yönettiğiniz Google Ads hesaplarına yönelik mevcut API yetkilendirmelerini etkilemez.
Bu pilot uygulamayı etkinleştirdim ve bir sorun veya geri bildirim var. 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 doğasını açıklayın. Mümkünse kuruluş kimliğiniz ve istek ve yanıt günlükleri gibi ayrıntıları ekleyin.