Bu özellik, API erişim düzeylerinizin bir Google Cloud kuruluşu tarafından yönetilmesine olanak tanıyarak size şu avantajları sağlar:
Artık geliştirici jetonlarını güvence altına almanıza gerek yok: API erişimi Google Cloud kuruluşu üzerinden yönetildiğinden artık geliştirici jetonlarını güvence altına alma veya jetonları sızdırma konusunda endişelenmenize gerek yoktur. 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 sürdürün: Google Cloud kuruluşu kapsamında bağlı herhangi bir proje, kuruluşun API erişim düzeyini devralır. Bu sayede bu kuruluş altında 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 birden fazla Google API Konsolu projesi oluşturabilirsiniz.
Daha hassas kota izleme ve yönetimi: Bağımsız projelerin API kullanımını izleyebilirsiniz veya API kullanımını sınırlayabilirsiniz.
Ön koşullar
Onaylı bir 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ğına sahipsinizdir. Kontrol edebilir ve gerekirse bir etiket 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ğil Pilot programa kaydolurken ve Google'dan sizin için bir kuruluş kaynağı oluşturmasını istediğinizde karşılaştığınız senaryoyu açıklayın. Google, bu kuruluş kaynağının ücretsiz olarak sahibi olacak ve yönetecektir. Google API Konsolu projelerinizi pilot program için hazırlama
Pilot program için Google Ads API ile kullandığınız Google API Konsolu projelerini aşağıdaki şekilde hazırlamanız gerekir:
Senaryo Uygulanacak adımlar Zaten bir Google Cloud kuruluşuna sahipsiniz veya önceki adımda kuruluş oluşturdunuz Google Ads API'yi etkinleştirdiğiniz tüm Google API Konsolu projelerinin bu kuruluş kapsamı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 muhtemelen zaten kuruluşunuzda yer almaktadır, bu nedenle bu adımı atlayabilirsiniz.
Google Cloud kuruluşunuz yok ve önceki adımda kuruluş oluşturamadını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 başvurunuz 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-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, ardından ARAÇLAR VE AYARLAR > KURULUM > API Merkezi'ne gidin.
Pilot programa kaydolun
Pilot programa kaydolun. Google Uygunluk ekibi başvurunuzu inceler ve onay durumunu ve diğer ayrıntıları e-posta yoluyla API iletişim e-posta adresinize gönderir.
Google'dan sizin için bir Google Cloud kuruluşu oluşturmasını istediyseniz uygulamanız gereken birkaç ek adım 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ü verilecek.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şı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 durumunu ve diğer ayrıntıları e-posta yoluyla API iletişim e-posta adresinize gönderir.
API isteklerinizi değiştirme
Uygulamanızı, API çağrıları yaparken developer-token üst bilgisini göndermeyi durduracak şekilde değiştirebilirsiniz. Bu, isteğe bağlı olsa da önerilen bir adımdır. Pilot programda yer alıyorsanız Google Ads API sunucusu, API isteklerinin bir parçası olarak gönderilirse developer-token parametresini yoksayar.
Java
Çok yakında!
.NET
Google Ads API.NET kitaplığının 17.1 .0 veya daha yeni sürümünü indirip yükleyin.
Daha sonra, 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/v17/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 elde edilebilen bir Google Cloud kuruluşuna ihtiyacınız vardır. Bu gereklilik, şu anda Google Ads API'yi kullanmak için bir Google API Konsolu projesine ihtiyaç duyduğunuza benzer.
API Erişim düzeylerimi değiştirmem gerekiyor. Bunu nasıl yapabilirim?
API erişim düzeylerinde herhangi bir değişiklik yapılmasını istemek için şimdilik API Merkezi'ni kullanmaya devam etmeniz gerekir.
Bu pilot programa kaydolmak için herhangi bir kesinti söz konusu mu?
Hayır, yok. Google Ads API, onaylandıktan sonra kuruluş düzeyindeki API erişim düzeylerini otomatik olarak kullanmaya başlayacaktır.
Bu pilot uygulamaya katılmak için ne kadar çaba göstermeniz gerekiyor?
Minimum düzeyde kod değişikliği beklenir. Çoğu geliştirici, uygulamalarındaki değişiklikleri 30 dakikadan daha kısa sürede tamamlayacaktır.
Bu pilot uygulamaya kaydolursam ücretlendirilecek miyim?
Genel olarak hayır, bu pilot uygulamaya 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.
Bir Google Cloud kuruluşu edinmek için olası senaryolar şunlardır:
Mevcut bir Google Workspace veya Google Cloud Identity müşterisiyseniz:
Bu ürünlerin düzenli kullanımı için her zamanki gibi ücretlendirilirsiniz. Bu pilot programa katılım amacıyla bir Google Cloud kuruluşu oluşturduğunuz için sizden ücret alınmaz.
Bir Google Cloud Identity ücretsiz sürüm hesabı oluşturdunuz:
Google Cloud Identity'nin ücretsiz sürümü 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ş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ğinden pilot programa katılamazsınız.
Bu durum, Google Ads API'yi kullanarak yönettiğim hesaplara ilişkin mevcut API yetkilendirmelerini etkiler mi?
Hayır, bu değişiklik Google Ads API'yi kullanarak yönettiğiniz Google Ads hesaplarındaki mevcut API yetkilendirmelerini etkilemez.
Bu pilot uygulamaya kaydoldum ancak bir sorunum veya geri bildirimim var. Destek ekibiyle nasıl iletişime geçebilirim?
API teknik destek sayfasını kullanarak Google Ads API ekibiyle iletişime geçin ve sorununuzun mahiyetini açıklayın. Mümkün olduğunda kuruluş kimliğiniz ile istek ve yanıt günlükleri gibi ayrıntıları ekleyin.