Grundlegende Nutzung

Die grundlegende Verwendung der Clientbibliothek sieht so aus:

Installation

Wir empfehlen, die Bibliothek mit Bundler zu installieren. Fügen Sie Ihrem Gemfile eine Zeile hinzu und ersetzen Sie x.y.z durch die Versionsnummer, die Sie verwenden möchten:

gem 'google-ads-googleads', '~> x.y.z'

Führen Sie dann diesen Befehl aus:

bundle install

Dieser Befehl verwendet Bundler, um Ihre Gemfile.lock zu aktualisieren. Dabei wird die genaue Version des Gems und aller installierten Abhängigkeiten des Gems gesperrt. Der pessimistische Versionsoperator "~> x.y.z" sorgt dafür, dass bundle install oder bundle update nur neue Patchversionen in der x.y.*-Reihe installiert. Sie müssen also manuell neue Neben- oder Hauptversionen aktivieren, indem Sie Ihre Gemfile aktualisieren.

Weitere Installationsoptionen

Wenn Sie Bundler nicht verwenden, haben Sie folgende Möglichkeiten:

  1. Installieren Sie diese Bibliothek mit RubyGems:

    gem install google-ads-googleads

  2. Laden Sie das Gem von der Seite „Releases“ herunter und installieren Sie es aus der lokalen Datei:

    gem install google-ads-googleads-[version].gem

Authentifizierung einrichten

Konfigurieren Sie zum Authentifizieren Ihrer API-Aufrufe die Datei google_ads_config.rb und folgen Sie der Anleitung auf der Seite Authentifizierung und Autorisierung.

Nutzung

Ab google-ads-googleads v41.1.0 unterstützt das Gem Bundler Autorequire (Bundler.require). In Versionen vor v41.1.0 (oder wenn Sie Bundler.require nicht verwenden) müssen Sie das Gem explizit in Ihrem Code anfordern:

require 'google/ads/google_ads'

Initialisieren Sie den Client (der standardmäßig die Konfiguration aus ~/google_ads_config.rb lädt) und rufen Sie einen bestimmten Dienst ab, z. B. CampaignService:

# Initialize the client using ~/google_ads_config.rb.
client = Google::Ads::GoogleAds::GoogleAdsClient.new

# Fetch the CampaignService client.
campaign_service = client.service.campaign

Weitere Informationen zur Verwendung der Bibliothek finden Sie in den Beispielen auf GitHub.

Wenn Sie sich mit den Beispielen vertraut gemacht haben, können Sie sich mit Factories beschäftigen. Diese bieten eine Reihe von allgemeinen, praktischen Methoden für die Arbeit mit der Google Ads API.

Fehlerbehandlung

Nicht jeder API-Aufruf ist erfolgreich. Der Server löst Ausnahmen aus, wenn Ihre API-Aufrufe fehlschlagen. Es ist wichtig, API-Fehler zu erfassen und entsprechend zu behandeln.

Eine Google::Ads::GoogleAds::Errors::GoogleAdsError-Instanz wird ausgelöst, wenn ein API-Fehler auftritt. Sie enthält Details, die Ihnen helfen, die Ursache des Fehlers zu ermitteln. Sie können eine Hilfsfunktion einrichten, um die Fehler zu beheben. Ein Beispiel für einen Fehler-Handler auf GitHub.