Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Kimlik doğrulama ve yetkilendirme

Google Ads API, diğer Google API'leri gibi kimlik doğrulama ve yetkilendirme için OAuth 2.0 protokolünü kullanır. OAuth 2.0, Google Ads API istemci uygulamanızın kullanıcının giriş bilgilerini işlemesi veya depolaması gerekmeden kullanıcının Google Ads hesabına erişmesini sağlar.

Google Ads erişim modelini anlama

Google Ads API ile etkili bir şekilde çalışmak için Google Ads erişim modelinin nasıl çalıştığını anlamanız gerekir. Google Ads erişim modeli kılavuzunu inceleyin.

OAuth iş akışları

Google Ads API ile çalışırken kullanılan üç yaygın iş akışı vardır.

Hizmet hesabı akışı

İş akışınızda herhangi bir kullanıcı etkileşimi gerekmiyorsa bu iş akışını kullanmanız önerilir. Bu iş akışı, kullanıcının Google Ads hesabına hizmet hesabı eklediği bir yapılandırma adımı gerektirir. Uygulama daha sonra kullanıcının Google Ads hesabını yönetmek için hizmet hesabının kimlik bilgilerini kullanabilir. Bunu yapılandırmak için Google Cloud Console'da JSON anahtar dosyasını oluşturup indirin, ardından google_ads_config.rb dosyasını ana dizininize kopyalayın ve hizmet hesabı anahtar dosyanızın konumunu (ve Google Workspace alan genelinde yetki kullanırken kimliğine bürünülecek kullanıcının isteğe bağlı e-posta adresi) belirtecek şekilde değiştirin:

# You can also authenticate using a service account. If "keyfile" is
# specified below, then service account authentication will be assumed and
# the above authentication fields ignored. Read more about service account
# authentication here:
# https://developers.google.com/google-ads/api/docs/oauth/service-accounts
c.keyfile = 'path/to/keyfile.json'
# Optional unless using Google Workspace domain-wide delegation:
c.impersonate = 'INSERT_EMAIL_ADDRESS_TO_IMPERSONATE_HERE'

Bu bilgileri bir dosyada depolamayı tercih etmiyorsanız ve bunun yerine ortam değişkenlerini kullanmak istiyorsanız GOOGLE_ADS_JSON_KEY_FILE_PATH (ve isteğe bağlı olarak GOOGLE_ADS_IMPERSONATED_EMAIL) değişkenini ayarlayabilirsiniz:

export GOOGLE_ADS_JSON_KEY_FILE_PATH="/path/to/your/service-account-key.json"
# Optional unless using Google Workspace domain-wide delegation:
export GOOGLE_ADS_IMPERSONATED_EMAIL="your_email@email.com"

Ayrıca, hizmet hesabı anahtar dosyası yolunu (ve isteğe bağlı olarak kimliğine bürünülmüş e-posta adresini) çalışma zamanında programatik olarak da iletebilirsiniz:

require 'google/ads/google_ads'

client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  config.keyfile = '/path/to/your/service-account-key.json'
  # Optional unless using Google Workspace domain-wide delegation:
  config.impersonate = 'INSERT_EMAIL_ADDRESS_TO_IMPERSONATE_HERE'
end

Alternatif olarak, hizmet hesabı kimlik bilgileri oluşturmak ve credentials.updater_proc değerini config.authentication'ye iletmek için googleauth gem'ini kullanabilirsiniz:

require 'googleauth'
require 'google/ads/google_ads'

# Path to your service account key file.
key_file = '/path/to/your/service-account-key.json'

# Define the scopes needed for the Google Ads API.
scopes = ['https://www.googleapis.com/auth/adwords']

# Create service account credentials.
credentials = File.open(key_file) do |io|
  Google::Auth::ServiceAccountCredentials.make_creds(
    json_key_io: io,
    scope: scopes
  )
end

# Initialize the Google Ads API client with these credentials.
client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  # Inject the service account credential updater proc.
  config.authentication = credentials.updater_proc
end

Daha fazla bilgi için hizmet hesabı iş akışı kılavuzuna bakın.

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

Hizmet hesaplarını kullanamıyorsanız bu iş akışını kullanabilirsiniz. Bu iş akışı için iki yapılandırma adımı gerekir:

Google Ads API kullanılarak yönetilecek tüm hesaplara tek bir kullanıcının erişmesini sağlayın. Genel bir yaklaşım, kullanıcıya bir Google Ads API yönetici hesabına erişim izni vermek ve bu yönetici hesabı altındaki tüm Google Ads hesaplarını bağlamaktır.
Kullanıcı, uygulamanızın kendi adına tüm Google Ads hesaplarını yönetmesine yetki vermek için Google Cloud komut satırı aracı veya GenerateUserCredentials kod örneği gibi bir komut satırı aracı çalıştırır.

OAuth 2.0 kimlik bilgileri, google_ads_config.rb dosyasını ana dizininize kopyalayıp istemci kimliğinizi, istemci gizli anahtarınızı ve yenileme jetonunuzu içerecek şekilde değiştirerek Ruby için yapılandırılabilir:

# Authentication tells the API that you are allowed to make changes to the
# specific account you're trying to access.
# The default method of authentication is to use a refresh token, client id,
# and client secret to generate an access token.
c.client_id = 'INSERT_CLIENT_ID_HERE'
c.client_secret = 'INSERT_CLIENT_SECRET_HERE'
c.refresh_token = 'INSERT_REFRESH_TOKEN_HERE'

İstemci, herhangi bir bağımsız değişken olmadan başlatılırsa yapılandırma dosyasını ana dizinden otomatik olarak okur:

client = Google::Ads::GoogleAds::GoogleAdsClient.new

Alternatif olarak, dosyayı başka bir yerde depolamayı tercih ederseniz bu dosyanın bulunduğu yolu ileterek istemciyi oluşturabilirsiniz:

client = Google::Ads::GoogleAds::GoogleAdsClient.new(
  'path/to/google_ads_config.rb'
)

Bu bilgileri bir dosyada depolamak yerine ortam değişkenlerini kullanmayı tercih ederseniz her birini ayarlayabilirsiniz:

export GOOGLE_ADS_CLIENT_ID="INSERT_CLIENT_ID_HERE"
export GOOGLE_ADS_CLIENT_SECRET="INSERT_CLIENT_SECRET_HERE"
export GOOGLE_ADS_REFRESH_TOKEN="INSERT_REFRESH_TOKEN_HERE"

Bilgileri çalışma zamanında programlı olarak da iletebilirsiniz:

client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  config.client_id = 'INSERT_CLIENT_ID_HERE'
  config.client_secret = 'INSERT_CLIENT_SECRET_HERE'
  config.refresh_token = 'INSERT_REFRESH_TOKEN_HERE'
end

Daha fazla bilgi edinmek için Tek kullanıcılı kimlik doğrulama iş akışı kılavuzuna bakın.

Çok kullanıcılı kimlik doğrulama akışı

Uygulamanızın, kullanıcıların oturum açmasına ve Google Ads hesaplarını kendi adlarına yönetmek için uygulamanıza yetki vermesine izin vermesi durumunda bu iş akışını kullanmanız önerilir. Uygulamanız, OAuth 2.0 kullanıcı kimlik bilgilerini oluşturur ve yönetir. Bu iş akışı, login_customer_id da belirtilerek tek kullanıcılı akışa benzer şekilde yapılandırılabilir.

Yapılandırma dosyası kullanmanız önerilir. google_ads_config.rb dosyasını ana dizininize kopyalayın ve istemci kimliğinizi, istemci gizli anahtarınızı, yenileme jetonunuzu ve müşteri kimliğinizi içerecek şekilde değiştirin:

# Authentication tells the API that you are allowed to make changes to the
# specific account you're trying to access.
# The default method of authentication is to use a refresh token, client id,
# and client secret to generate an access token.
c.client_id = 'INSERT_CLIENT_ID_HERE'
c.client_secret = 'INSERT_CLIENT_SECRET_HERE'
c.refresh_token = 'INSERT_REFRESH_TOKEN_HERE'

# Required for manager accounts only: Specify the login customer ID used to
# authenticate API calls. This will be the customer ID of the authenticated
# manager account. If you need to use different values for this field, then
# make sure to fetch a new copy of the service after each time you change the
# value.
c.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'

İstemci, herhangi bir bağımsız değişken olmadan başlatılırsa yapılandırma dosyasını ana dizinden otomatik olarak okur:

client = Google::Ads::GoogleAds::GoogleAdsClient.new

Alternatif olarak, dosyayı başka bir yerde depolamayı tercih ederseniz bu dosyanın bulunduğu yolu ileterek istemciyi oluşturabilirsiniz:

client = Google::Ads::GoogleAds::GoogleAdsClient.new(
  'path/to/google_ads_config.rb'
)

Bu bilgileri bir dosyada depolamak yerine ortam değişkenlerini kullanmayı tercih ederseniz her birini ayarlayabilirsiniz:

export GOOGLE_ADS_CLIENT_ID="INSERT_CLIENT_ID_HERE"
export GOOGLE_ADS_CLIENT_SECRET="INSERT_CLIENT_SECRET_HERE"
export GOOGLE_ADS_REFRESH_TOKEN="INSERT_REFRESH_TOKEN_HERE"
export GOOGLE_ADS_LOGIN_CUSTOMER_ID="INSERT_LOGIN_CUSTOMER_ID_HERE"

Bilgileri çalışma zamanında programlı olarak da iletebilirsiniz:

client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  config.client_id = 'INSERT_CLIENT_ID_HERE'
  config.client_secret = 'INSERT_CLIENT_SECRET_HERE'
  config.refresh_token = 'INSERT_REFRESH_TOKEN_HERE'
  config.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
end

Daha fazla bilgi edinmek için çok kullanıcılı kimlik doğrulama iş akışı rehberine bakın. Ruby istemci kitaplığı, referans için bir kod örneği içerir. GenerateUserCredentials komut satırı kodu örneği, kullanıcı kimlik doğrulamasının çalışma zamanında nasıl alınacağını gösterir. Bu sayede, kullanıcıların Google Ads hesapları onlar adına yönetilebilir. Bu kod örneğini, kullanıcı kimlik doğrulaması gerektiren masaüstü uygulamaları oluştururken referans olarak kullanabilirsiniz.

Birden çok hesabı yönetme

Kullanıcıların, hesaplara doğrudan erişerek veya bir Google Ads yönetici hesabı üzerinden birden fazla Google Ads hesabını yönetmesi yaygın bir durumdur. Ruby istemci kitaplığı, bu tür durumların nasıl ele alınacağını gösteren aşağıdaki kod örneklerini sağlar:

GetAccountHierarchy kod örneğinde, bir Google Ads yönetici hesabı altındaki tüm hesapların listesinin nasıl alınacağı gösterilmektedir.
ListAccessibleCustomers kod örneğinde, kullanıcının doğrudan erişebildiği tüm hesapların listesinin nasıl alınacağı gösterilmektedir. Bu hesaplar daha sonra login_customer_id ayarı için geçerli değerler olarak kullanılabilir.

Uygulama varsayılan kimlik bilgileri

Ruby istemci kitaplığı (v36.1.0 ve sonraki sürümler) uygulama varsayılan kimlik bilgileri (ADC) ile kimlik doğrulamayı da destekler. Bu özellik, OAuth 2.0 bilgilerini uygulama yapılandırmanızda yapılandırmanıza gerek kalmadan uygulamanız için varsayılan kimlik bilgilerini ayarlamanıza olanak tanır.

Bu, özellikle yerel geliştirme veya farklı Google API'lerine karşı geliştirme için yararlıdır. Gerekli OAuth 2.0 kapsamlarına erişebildikleri sürece aynı kimlik bilgilerini yeniden kullanabilirsiniz.

Google Ads API için, uygulama varsayılan kimlik bilgilerinizin https://www.googleapis.com/auth/adwords OAuth 2.0 kapsamına erişebildiğinden emin olun.

Uygulama varsayılan kimlik bilgilerini kullanmak için Google Cloud komut satırı aracını kullanın ve ADC için kimlik doğrulayın:

gcloud auth application-default login

Bu komut, Google Hesabınızın kimlik doğrulama akışını tamamlamak için bir web tarayıcısı açar. Yetkilendirildikten sonra kimlik bilgilerini standart bir konumda saklar. Ardından, ADC'yi kullanmak için uygulamanızı güncellemeniz gerekir.

google_ads_config.rb dosyasını ana dizininize kopyalayın ve use_application_default_credentials değerini true olarak ayarlayın:

# You can also authenticate using Application Default Credentials (ADC).
# To understand how ADC discovers credentials in a given environment, see:
# https://developers.google.com/identity/protocols/application-default-credentials
c.use_application_default_credentials = true

Bu bilgileri bir dosyada depolamayı tercih etmiyor ve bunun yerine ortam değişkenlerini kullanmak istiyorsanız GOOGLE_ADS_USE_APPLICATION_DEFAULT_CREDENTIALS değerini ayarlayabilirsiniz:

export GOOGLE_ADS_USE_APPLICATION_DEFAULT_CREDENTIALS="true"

Bilgileri çalışma zamanında programatik olarak da iletebilirsiniz. Ruby kodunuzda istemciyi başlatırken config.use_application_default_credentials = true değerini ayarlayın ve açık OAuth 2.0 kimlik bilgileri sağlamayın. Kitaplık, Google Cloud komut satırı aracı tarafından ayarlanan kimlik bilgilerini otomatik olarak algılar ve kullanır:

# Initialize the client using Application Default Credentials.
client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  config.use_application_default_credentials = true

  # Optional: Specify a login customer ID if you are accessing accounts
  # through a manager account.
  # config.login_customer_id = 'YOUR_LOGIN_CUSTOMER_ID'

  # Do NOT include client_id, client_secret, or refresh_token here.
end

Ruby istemci kitaplığını yapılandırmak için kullanılabilen seçenekler hakkında daha fazla bilgi edinmek üzere yapılandırma sayfasına bakın.