Hizmet Hesapları

Bu kılavuzda, hizmet hesaplarıyla Google Ads API'ye nasıl erişileceği açıklanmaktadır.

Hizmet hesabı, bireysel bir son kullanıcı yerine uygulamanıza ait bir hesaptır. Hizmet hesapları, bir web uygulaması ile Google hizmeti arasında sunucudan sunucuya etkileşimlere olanak tanır. Uygulamanız, hizmet hesabı adına Google API'lerini çağırır. Böylece kullanıcılar projeye doğrudan dahil olmaz.

Önemli Bilgi: Bir hizmet hesabı yalnızca aynı Google Workspace'teki kullanıcıların (e-posta adresleri) kimliğine bürünebilir.

Hizmet hesapları, insan yetkilendirmesi gerektirmeyen bir OAuth2 akışı kullanır. Bunun yerine, yalnızca uygulamanızın erişebileceği bir anahtar dosyası kullanılır.

Hizmet hesaplarını kullanmanın iki önemli avantajı vardır:

• Google API erişimi için yetkilendirme, bir yapılandırma adımı olarak yapılır. Böylece kullanıcı etkileşimleri gerektiren diğer OAuth2 akışlarıyla ilişkili karmaşıklıkların önüne geçilir.
• OAuth2 onay akışı, uygulamanızın gerekirse başka kullanıcıların kimliğine bürünmesine olanak tanır.

Önemli Bilgi: Alana özgü bir özelliğe (ör. kimliğe bürünme) ihtiyacınız yoksa hizmet hesapları yerine OAuth2 masaüstü uygulaması veya web uygulaması akışını kullanmanızı önemle tavsiye ederiz. OAuth2 masaüstü uygulaması ve web uygulaması akışları, hesaba erişim izni vermek için ilk kullanıcı etkileşimi gerektirir ancak bunların kurulumu çok daha kolaydır.

OAuth2 masaüstü uygulaması akışında, gerektiğinde yeni bir erişim jetonu almak için yenileme jetonu (geçerlilik süresi hiçbir zaman dolmaz) kullanabilirsiniz. İstemci kitaplıklarımızdan birini kullanırken bir yapılandırma dosyası doldurarak uygulamanızı yetkilendirebilirsiniz.

Ön koşullar

• mydomain.com veya mybusiness.com gibi, sahibi olduğunuz bir Google Workspace alanı.
• Google Ads API geliştirici jetonu ve isteğe bağlı olarak bir test hesabı.
• Kullandığınız dilin istemci kitaplığı.
• Google Ads API için yapılandırılmış bir Google API Konsolu projesi.
• Erişmek istediğiniz Google Ads hesabında gerekli izinlere sahip bir Google Ads kullanıcısı Google Ads, hizmet hesaplarının kimliğe bürünme olmadan kullanılmasını desteklemez.

Hizmet hesabına erişim kurulumu

Kullanıcı kimliğine bürünme yalnızca alan düzeyinde kontrol edildiğinden, Google OAuth2 ile hizmet hesapları ve onay akışı kullanmak için kendi alanınızın Google Workspace'e kayıtlı olması gerekir. Böylece uygulamanız ve kullanıcıları, alandaki herhangi bir kullanıcının kimliğine bürünebilir.

1. Bir hizmet hesabı ve kimlik bilgileri oluşturarak başlayın.

   Hizmet hesabı anahtarını JSON biçiminde indirin ve hizmet hesabı kimliğini not edin.

2. Hizmet hesabı kimliğini ve Google Ads API kapsamını (https://www.googleapis.com/auth/adwords) alan yöneticinizle paylaşın.

   Alan yöneticisinden hizmet hesabınıza alan genelinde yetki vermesini isteyin.

3. Alan adı yöneticisiyseniz yardım merkezi talimatlarını tamamlayın.

Artık hizmet hesabını OAuth2 onayı akışıyla Google Ads hesabınıza erişmek için kullanabilirsiniz.

İstemci kitaplığı yapılandırması

İstemci kitaplığınızı yapılandırma talimatları için aşağıdan dilinizi seçin.

Java

OAuth Hizmet Hesabı Akışı.

.NET

OAuth Hizmet Hesabı Akışı.

Python

OAuth Hizmet Hesabı Akışı.

PHP

OAuth Hizmet Hesabı Akışı.

Ruby

OAuth Hizmet Hesabı Akışı.

Perl

OAuth Hizmet Hesabı Akışı.

Güvenlikle ilgili sorunlar

Hizmet hesabında Google Workspace alanınız için alan düzeyinde yetki denetimi bulunduğundan, bir hizmet hesabının yetkilendirildiği Google hizmetlerine erişmesine olanak tanıyan anahtar dosyasının korunması önemlidir. Bu durum özellikle ilgili hizmet hesabı, alandaki herhangi bir kullanıcının kimliğine bürünebildiği için geçerlidir.

Bir diğer iyi uygulama da hizmet hesaplarının yalnızca gereken minimum API grubuna erişmesine izin vermektir. Bu, hizmet hesabının anahtar dosyasının güvenliği ihlal edildiğinde saldırganın erişebileceği veri miktarını sınırlandırmak için alınan önleme amaçlı bir önlemdir.