Die grundlegende Nutzung der Clientbibliothek sieht so aus:
Installation
Die empfohlene Installationsmethode ist die Verwendung von Bundler. Fügen Sie Ihrem Gemfile eine Zeile hinzu und ersetzen Sie dabei „x.y.z“ durch die gewünschte Versionsnummer:
gem 'google-ads-googleads', '~> x.y.z'
Führen Sie dann diesen Befehl aus:
$ bundle install
Mit diesem Befehl wird Bundler verwendet, um die Datei Gemfile.lock zu aktualisieren und die genaue Version des Gems und alle installierten Abhängigkeiten des Gems zu sperren. Der
pessimistische Versionsoperator "~> x.y.z" bewirkt, dass bundle update nur neue Versionen der Reihe x.y.* installiert. Sie müssen neue Versionen also manuell aktivieren,
indem Sie Ihr Gemfile noch einmal aktualisieren.
Weitere Installationsoptionen
Wenn Sie Bundler nicht verwenden, haben Sie folgende Möglichkeiten:
- Installieren Sie diese Bibliothek mit Gem:
terminal $ [sudo] gem install google-ads-googleads - Laden Sie das Gem von der
Seite „Releases“ herunter und installieren Sie es
aus der lokalen Datei:
terminal $ [sudo] gem install google-ads-googleads-[version].gem
Authentifizierung einrichten
Folgen Sie der Anleitung auf der Seite Authentifizierung und Autorisierung, um Ihre API-Aufrufe zu authentifizieren.
Nutzung
So fügen Sie das Gem in Ihren Code ein:
require 'google/ads/google_ads'
So rufen Sie einen bestimmten Dienst ab, z. B. CampaignService:
client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign
Weitere Informationen zur Verwendung der Bibliothek finden Sie in den Beispielen auf GitHub.
Nachdem Sie sich mit den Beispielen vertraut gemacht haben, empfehlen wir Ihnen, sich auch mit Factories zu beschäftigen. Diese bieten eine Reihe von praktischen Methoden auf hoher Ebene für die Arbeit mit der Google Ads API.
Fehlerbehandlung
Nicht jeder API-Aufruf ist erfolgreich. Der Server kann Fehler auslösen, wenn Ihre API-Aufrufe aus irgendeinem Grund fehlschlagen. Es ist wichtig, API-Fehler zu erfassen und entsprechend zu behandeln.
Bei einem API-Fehler wird eine GoogleAdsException-Instanz ausgelöst. Sie enthält Details, mit denen Sie die Ursache des Fehlers ermitteln können. Außerdem können Sie eine Hilfsfunktion einrichten, um die Fehler zu behandeln. Ein Beispiel für einen
Fehlerhandler finden Sie auf GitHub.