Tek kullanıcılı kimlik doğrulama iş akışı

Hizmet hesabı iş akışına benzer şekilde, tek kullanıcılı kimlik doğrulama akışı, uygulamanın gerekli tüm hesaplara erişmesine izin vermek için Google Ads kullanıcı arayüzü tarafından sunulan yetkilendirme ve kullanıcı yönetimi özelliklerini kullanır. Bu kimlik doğrulama iş akışı iki adımdan oluşur:

• Uygulama tarafından yönetilmesi gereken tüm Google Ads hesaplarına tek bir kullanıcıya erişim izni verirsiniz.
• Kullanıcı, uygulamanıza Google Ads hesaplarını kendi adına yönetme yetkisi verir. Böylece uygulama, tüm Google Ads hesaplarına erişim izni alır.

Yalnızca bir kullanıcı söz konusu olduğundan, kendi OAuth 2.0 kullanıcı kimlik doğrulama akışınızı oluşturmak yerine gcloud CLI veya GenerateUserCredential kod örneği gibi araçları kullanabilirsiniz.

Bu iş akışının ilgili bir kullanım alanı, hesaplarınıza az sayıda kullanıcı girişiyle (ör. 3-4 kullanıcı) erişilebildiği durumlardır. Bu durumda, tam teşekküllü bir OAuth çok kullanıcılı kimlik doğrulama iş akışı oluşturmak için gereken geliştirme çabası, gcloud CLI gibi bir komut satırı aracı kullanarak 3-4 kullanıcı için yetkilendirme elde etmek için gereken çabayla karşılaştırıldığında haklı gösterilemez.

Dezavantajlar

Bu akışın hizmet hesabı iş akışına kıyasla bazı dezavantajları vardır:

1. Kullanıcı kimlik doğrulama iş akışı, Google Cloud Console'da bir OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturmanızı gerektirir. Bu işlem, hizmet hesabı ve anahtar oluşturmaktan daha fazla yapılandırma adımı içerir.
2. Yetkili kullanıcı ekipten veya şirketten ayrılırsa kullanıcıyı hesaplarınızdan kaldırdığınızda ya da kullanıcı hesabını devre dışı bıraktığınızda uygulamanız çalışmayı durdurabilir. Hizmet hesapları tek tek kullanıcılara bağlı olmadığından bu risk önlenir.
3. Google Ads hesabını yetkilendiren kullanıcı, Google Hesabı'nda geçiş anahtarlarını etkinleştirmelidir. Bu sayede, Google Hesabı'nın yetersiz güvenlik, kötü amaçlı yazılım veya kimlik avı nedeniyle güvenliğinin ihlal edilmesini önleyebilir. Geçiş anahtarlarını etkinleştirmek için hizmet hesapları gerekmez ve bu saldırı modlarının bazıları doğrudan hizmet hesapları için geçerli olmadığından bu soruna karşı daha az savunmasızdırlar.

Kimlik bilgisi oluşturma

1. Uygulamanız için OAuth kullanıcı rızası ekranı yapılandırın ve https://www.googleapis.com/auth/adwords'ı OAuth 2.0 kapsamı olarak ekleyin. Ayrıntılar için OAuth kullanıcı rızası ekranınızı ayarlama başlıklı makaleyi inceleyin.

2. Talimatları uygulayarak bir istemci kimliği ve istemci gizli anahtarı oluşturun. OAuth 2.0 istemcisini oluşturduktan sonra onay iletişim kutusundaki JSON'ı indir düğmesini tıklayarak istemcinin JSON dosyasını indirin. Dosyayı credentials.json olarak kaydedin.

3. Uygulamanızı kullanarak yönetmek istediğiniz tüm Google Ads hesaplarına erişimi olan bir kullanıcı hesabı belirleyin. Erişimi eksik olan hesaplar varsa bu kullanıcıya hesap erişimi verin.

4. gcloud CLI'yı indirip yükleyin. Yüklendikten sonra, komut satırı isteminden gcloud version komutunu çalıştırarak aracın doğru şekilde çalıştığını doğrulayın. Çıkış şu şekilde görünür:

   gcloud version

   Google Cloud SDK 492.0.0
   alpha 2024.09.06
   beta 2024.09.06
   bq 2.1.8
   bundled-python3-unix 3.11.9
   core 2024.09.06
   enterprise-certificate-proxy 0.3.2
   gcloud-crc32c 1.0.0
   

5. Önceki adımda oluşturulan credentials.json dosyasıyla gcloud CLI aracını çalıştırarak OAuth 2.0 yenileme jetonu oluşturun. Yenileme jetonunun gcloud CLI'nin varsayılan projesi yerine Google API Konsolu projeniz kapsamında verilmesi için --client-id-file parametresini iletmeniz gerekir:

   gcloud auth application-default login \
     --scopes=https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
     --client-id-file=PATH_TO_CREDENTIALS_JSON

6. gcloud komutu, yeni bir tarayıcı penceresinde Google Hesabı oturum açma penceresi açar ve sizi OAuth 2.0 kimlik doğrulama adımlarına yönlendirir. Önceki adımlarda seçtiğiniz kullanıcı olarak oturum açtığınızdan emin olun. Uygulamanız doğrulanmamışsa uyarı ekranı görebilirsiniz. Bu gibi durumlarda Gelişmiş bağlantısını ve ardından PROJECT_NAME (güvenli değil) sitesine git seçeneğini tıklayabilirsiniz.

7. Kapsamları doğruladıktan sonra izin vermek için Devam düğmesini tıklayın. Tarayıcı, kimlik doğrulamanın başarılı olduğunu belirten https://cloud.google.com/sdk/auth_success adresine gider. Sayfada aşağıdaki mesaj gösterilir:

   Authorization code granted. Close this tab.

   gcloud komutu aşağıdaki mesajı yazdırır:

   Credentials saved to file: [/****/.config/gcloud/application_default_credentials.json]
   

   application_default_credentials.json dosyasını açın. İçeriği aşağıdakine benzer:

   {
     "account": "",
     "client_id": "******.apps.googleusercontent.com",
     "client_secret": "******",
     "refresh_token": "******",
     "type": "authorized_user",
     "universe_domain": "googleapis.com"
   }
   

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

İstemci kitaplığınızı nasıl yapılandıracağınızla ilgili talimatlar için programlama dilinize karşılık gelen sekmeyi seçin. Yetkili kullanıcınız müşteri hesaplarına bir Google Ads yönetici hesabı üzerinden erişiyorsa login-customer-id (veya loginCustomerId) değerini, tire içermeyen 10 haneli yönetici hesabı müşteri kimliği olarak ayarlayın.

api.googleads.clientId=INSERT_OAUTH2_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_OAUTH2_CLIENT_SECRET_HERE
api.googleads.refreshToken=INSERT_OAUTH2_REFRESH_TOKEN_HERE
api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.APPLICATION,
    OAuth2ClientId = "INSERT_OAUTH2_CLIENT_ID_HERE",
    OAuth2ClientSecret = "INSERT_OAUTH2_CLIENT_SECRET_HERE",
    OAuth2RefreshToken = "INSERT_OAUTH2_REFRESH_TOKEN_HERE",
    LoginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE",
};
GoogleAdsClient client = new GoogleAdsClient(config);

client_id: INSERT_OAUTH2_CLIENT_ID_HERE
client_secret: INSERT_OAUTH2_CLIENT_SECRET_HERE
refresh_token: INSERT_OAUTH2_REFRESH_TOKEN_HERE
login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE
use_proto_plus: True

[GOOGLE_ADS]
loginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"

[OAUTH2]
clientId = "INSERT_OAUTH2_CLIENT_ID_HERE"
clientSecret = "INSERT_OAUTH2_CLIENT_SECRET_HERE"
refreshToken = "INSERT_OAUTH2_REFRESH_TOKEN_HERE"

Google::Ads::GoogleAds::Config.new do |c|
  c.client_id = 'INSERT_OAUTH2_CLIENT_ID_HERE'
  c.client_secret = 'INSERT_OAUTH2_CLIENT_SECRET_HERE'
  c.refresh_token = 'INSERT_OAUTH2_REFRESH_TOKEN_HERE'
  c.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
end

clientId=INSERT_OAUTH2_CLIENT_ID_HERE
clientSecret=INSERT_OAUTH2_CLIENT_SECRET_HERE
refreshToken=INSERT_OAUTH2_REFRESH_TOKEN_HERE
loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

curl \
  --data "grant_type=refresh_token" \
  --data "client_id=CLIENT_ID" \
  --data "client_secret=CLIENT_SECRET" \
  --data "refresh_token=REFRESH_TOKEN" \
  https://oauth2.googleapis.com/token

curl -i -X POST \
  https://googleads.googleapis.com/v26/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"

{
  "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}