Konfiguration

Die Konfiguration erfolgt über die Klasse Config. Sie können auf diese Klasse auf verschiedene Arten zugreifen, z. B. durch Schreiben einer Konfigurationsdatei, Angabe von Werten bei der Erstellung oder Laden von Werten aus Umgebungsvariablen.

Konfigurationsdatei

Sie können eine google_ads_config.rb-Datei angeben, die beim Instanziieren des Clients verwendet werden soll.

Wenn Sie beim Instanziieren eines GoogleAdsClient-Objekts keine Argumente verwenden, sucht die Bibliothek an dem Speicherort, der in der Umgebungsvariable GOOGLE_ADS_CONFIGURATION_FILE_PATH angegeben ist. Wenn diese Variable nicht festgelegt ist, sucht die Bibliothek im Verzeichnis HOME nach der Datei.

Alternativ können Sie beim Instanziieren des GoogleAdsClient-Objekts einen Pfad angeben. In diesem Fall sucht der Client an diesem Pfad nach der Datei.

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

Die einfachste Möglichkeit, diese Datei zu generieren, besteht darin, die Datei google_ads_config.rb aus dem GitHub-Repository zu kopieren und sie so zu ändern, dass sie Ihr Aktualisierungstoken, Ihre Client-ID und Ihren Clientschlüssel enthält.

Dynamische Konfiguration

Sie können die Konfiguration dynamisch einrichten, wenn Sie die Bibliothek instanziieren, oder auch später:

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

Sie können die Konfiguration auch 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.
  • login_customer_id: Weitere Informationen finden Sie in der Dokumentation zur Anmeldekunden-ID.

Protokollierungsfelder. Ausführliche Informationen finden Sie im Leitfaden zur Protokollierung.

  • log_level: Die Mindestprotokollebene für Nachrichten, die protokolliert werden sollen. Wenn Sie beispielsweise 'DEBUG' angeben, werden alle Protokollmeldungen angezeigt. Wenn Sie 'INFO' angeben, werden DEBUG-Meldungen ausgeschlossen, aber alle anderen Meldungen angezeigt.
  • log_target: Der Ort, an dem Sie protokollieren möchten, z. B. STDERR.
  • logger: Geben Sie einen eigenen benutzerdefinierten Logger an. Wenn Sie dies angeben, werden sowohl log_level als auch log_target überschrieben.

Umgebungsvariablen

Sie können die Clientbibliothek mit Umgebungsvariablen konfigurieren. Sie werden nicht standardmäßig geladen und erfordern einen zusätzlichen Aufruf nach dem Instanziieren des Clients, um geladen zu werden. Eine vollständige Liste der Umgebungsvariablen, die von allen Sprachen unterstützt werden, finden Sie hier.

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 wird der aktuelle Status der Umgebungsvariablen durch alles überschrieben, was bereits in der Config vorhanden ist. Mit diesem Mechanismus können Sie beispielsweise eine Standardkonfiguration haben, aber bestimmte Werte mit Umgebungsvariablen überschreiben oder die Konfiguration vollständig mit Umgebungsvariablen vornehmen.

Zusätzlich zu den Umgebungsvariablen, die von allen Bibliotheken unterstützt werden, hat die Ruby-Bibliothek zwei weitere Variablen:

  • GOOGLE_ADS_RUBY_LOG_LEVEL: log_level wie oben beschrieben.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: Geben Sie einen HTTP-Proxy an.