Grundlegende Nutzung

Die grundlegende Verwendung der Clientbibliothek sieht so aus:

Installation

Die empfohlene Methode zum Installieren der Bibliothek ist die Verwendung von Bundler. 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

Mit diesem Befehl wird Bundler verwendet, um Ihre Gemfile.lock zu aktualisieren und die genaue Version des Gems und aller Abhängigkeiten des Gems, die installiert wurden, zu sperren. 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 neue Neben- oder Hauptversionen also manuell 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

Um Ihre API-Aufrufe zu authentifizieren, konfigurieren Sie 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 Bundler.require nicht verwendet wird) müssen Sie das Gem explizit in Ihrem Code einbinden:

require 'google/ads/google_ads'

Initialisieren Sie den Client (die Konfiguration wird standardmäßig aus ~/google_ads_config.rb geladen) 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

Beispiele auf GitHub zeigen detaillierter, wie die Bibliothek verwendet wird.

Nachdem Sie sich mit den Beispielen vertraut gemacht haben, können Sie sich die Factories ansehen. Sie bieten eine Reihe von Convenience-Methoden auf hoher Ebene 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 angemessen 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 Problems zu ermitteln. Außerdem können Sie eine Hilfsfunktion einrichten, um die Fehler zu beheben. Beispiel für einen Fehler-Handler auf GitHub