Konfiguration

Die Konfiguration erfolgt mithilfe einer Config-Klasse. Sie haben mehrere Möglichkeiten, auf diese Klasse zuzugreifen, z. B. indem Sie eine Konfigurationsdatei schreiben, Werte beim Erstellen angeben oder Werte aus Umgebungsvariablen laden.

Konfigurationsdatei

Sie können eine google_ads_config.rb-Datei angeben, die bei der Instanziierung des Clients verwendet werden soll.

Wenn Sie bei der Instanziierung keine Argumente verwenden:

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

sucht die Bibliothek am Speicherort, der in der Umgebungsvariablen GOOGLE_ADS_CONFIGURATION_FILE_PATH angegeben ist. Wenn diese Variable nicht festgelegt ist, sucht die Bibliothek in Ihrem HOME-Verzeichnis nach der Datei.

Alternativ können Sie einen Pfad angeben:

client = Google::Ads::GoogleAds::GoogleAdsClient.new("path/to/file.rb")

In diesem Fall sucht der Client unter diesem Dateipfad nach der Datei.

Am einfachsten erstellen Sie diese Datei, indem Sie google_ads_config.rb aus dem GitHub-Repository kopieren und in Ihr Aktualisierungstoken, die Client-ID und den Clientschlüssel einfügen.

Dynamische Konfiguration

Sie können die Konfiguration bei der Instanziierung der Bibliothek dynamisch einrichten oder auch nachträglich:

client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  config.client_id = 'INSERT_CLIENT_ID_HERE'
  # ... more configuration
end

Sie können die Konfiguration sogar nach der Instanziierung ändern:

client.configure do |config|
  config.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
  # ... more configuration
end

Felder für die Konfiguration

Das Config-Objekt unterstützt die folgenden Felder.

Allgemeine Felder:

  • refresh_token: Ihr OAuth-Aktualisierungstoken.
  • client_id: Ihre OAuth-Client-ID.
  • client_secret: Ihr OAuth-Clientschlüssel.
  • developer_token: Ihr Entwickler-Token für den Zugriff auf die API.
  • login_customer_id: Weitere Informationen finden Sie in der Dokumentation zur Kunden-ID-Anmeldung.

Logging-Felder. Ausführliche Informationen finden Sie im Logging-Leitfaden.

  • log_level: Die Mindestnachrichten auf Logebene, die protokolliert werden sollen. Wenn Sie beispielsweise 'DEBUG' festlegen, werden alle Lognachrichten angezeigt. Wenn Sie 'INFO' angeben, werden FEHLERBEHEBUNGSnachrichten ausgeschlossen, aber alle anderen Meldungen angezeigt.
  • log_target: der Ort, an dem Sie sich anmelden möchten, z. B. STDERR.
  • logger: Geben Sie Ihren eigenen benutzerdefinierten Logger an. Wenn Sie dies angeben, werden sowohl log_level als auch log_target überschrieben.

Umgebungsvariablen

Sie können die Clientbibliothek mithilfe von Umgebungsvariablen konfigurieren. Sie werden nicht standardmäßig geladen und erfordern nach der Instanziierung des Clients einen zusätzlichen Aufruf, damit sie geladen werden können. Weitere Informationen finden Sie in der vollständigen Liste der Umgebungsvariablen, die von allen Sprachen unterstützt werden.

Rufen Sie load_environment_config auf, um die Umgebungsvariablen in Ihre Config zu laden:

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

Bei jedem Aufruf überschreibt der aktuelle Status der Umgebungsvariablen alles, was bereits in Config vorhanden ist. Mit diesem Mechanismus können Sie beispielsweise eine Standardkonfiguration verwenden, aber bestimmte Werte mithilfe von Umgebungsvariablen überschreiben, oder Sie können die Konfiguration vollständig mit Umgebungsvariablen konfigurieren.

Zusätzlich zu den von allen Bibliotheken unterstützten Umgebungsvariablen enthält die Ruby-Bibliothek zwei weitere Variablen:

  • GOOGLE_ADS_RUBY_LOG_LEVEL: Wie oben unter log_level.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: Geben Sie einen HTTP-Proxy an.