Konfiguration

Die Konfiguration erfolgt mithilfe einer Config-Klasse. Sie haben mehrere Möglichkeiten, auf diesen Kurs zuzugreifen wie das Schreiben einer Konfigurationsdatei, das Angeben von Werten bei der Erstellung oder das Laden von Werten aus Umgebungsvariablen.

Konfigurationsdatei

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

Wenn Sie bei der Instanziierung keine Argumente verwenden:

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

sucht die Bibliothek an dem Ort, der im Feld GOOGLE_ADS_CONFIGURATION_FILE_PATH. Wenn diese Variable gleich nicht festgelegt ist, sucht die Bibliothek im Verzeichnis HOME 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 die google_ads_config.rb aus das GitHub-Repository und ändern Sie es in das Aktualisierungstoken, die Client-ID, und den Clientschlüssel.

Dynamische Konfiguration

Sie können die Konfiguration dynamisch beim Instanziieren der Bibliothek einrichten, 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 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 Objekt Config unterstützt die folgenden Felder.

Allgemeine Felder:

  • refresh_token: Ihr OAuth-Aktualisierungstoken.
  • client_id: Deine OAuth-Client-ID.
  • client_secret: Ihr OAuth-Clientschlüssel
  • developer_token: Ihr Entwicklertoken für den Zugriff auf die API.
  • login_customer_id: Sehen Sie sich die Dokumentation zur Log-in-Kundennummer.

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

  • log_level: Die Mindestanzahl von Meldungen auf Logebene, die protokolliert werden sollen. Beispiel: Wenn Sie 'DEBUG' angeben, sehen Sie alle Logeinträge. Außerdem geben Sie an, 'INFO' schließt Nachrichten zur Fehlerbehebung aus, zeigt aber alle anderen Nachrichten an.
  • log_target: Der Ort, an dem Sie sich anmelden möchten, z. B. STDERR.
  • logger: Geben Sie Ihren eigenen benutzerdefinierten Logging an. Wenn Sie dies angeben, werden sowohl log_level und log_target.

Umgebungsvariablen

Sie können die Clientbibliothek mithilfe von Umgebungsvariablen konfigurieren. Sie sind nicht werden standardmäßig geladen und erfordern nach der Instanziierung der um geladen werden zu können. Vollständige Liste der Umgebungsvariablen ansehen unterstützt von allen Sprachen.

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

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

Bei jedem Aufruf wird der aktuelle Status der Umgebungsvariablen wird alles überschrieben, was bereits in Config vorhanden ist. Damit können Sie z. B. eine Standardkonfiguration verwenden, Werte mithilfe von Umgebungsvariablen oder konfigurieren Sie vollständig mit Umgebungsvariablen.

Zusätzlich zu den Umgebungsvariablen, die von allen Bibliotheken unterstützt werden, enthält zwei zusätzliche Variablen:

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