googleads shopping samples

Proben für die Content -API für das Einkaufs- und Herstellerzentrum -API

Diese Codeproben werden nach Plattform oder Sprache organisiert. Jedes Sprachverzeichnis enthält eine README mit weiteren Informationen zum Ausführen der Beispiele für diese bestimmte Sprache. Hier decken wir die Einrichten der Authentifizierung und die gemeinsame Konfigurationsdatei, die von allen Beispielen verwendet wird.

Weitere Informationen zu den APIs finden Sie in der Dokumentation für die Content -API zum Einkaufen und zur API des Herstellerzentrums.

Wählen Sie Ihre Authentifizierungsmethode

Überprüfen Sie vor dem Anfängen den Abschnitt "Erste Schritte" der Content -API zur Einkaufsdokumentation. Möglicherweise möchten Sie stattdessen Servicekonten verwenden, um den Authentifizierungsfluss zu vereinfachen. Diese Beispiele unterstützen auch die Standard -Anmeldeinformationen von Google Application.

Die Einrichtung der Authentifizierung für die Herstellerzentrum -API ähnelt der Content -API. Stellen Sie einfach sicher, dass Sie die API des Herstellerzentrums in der API -Konsole auswählen. Beide APIs können ausgewählt werden, wenn Sie Proben für beide APIs ausprobieren möchten.

Einrichten der Authentifizierung und Beispielkonfiguration

1. Erstellen Sie das Verzeichnis $(HOME)/shopping-samples um die Konfiguration zu speichern.

   Wenn Sie sich nicht sicher sind, wo sich dies in Ihrem speziellen Setup befindet, führen Sie die Beispiele aus (folgt dem sprachspezifischen README ). Fehler aus den Stichproben, die sich entweder mit diesem Verzeichnis oder den nicht vorhandenen Dateien beziehen, liefern den vollständigen Pfad für das erwartete Verzeichnis/die erwarteten Dateien.

   Erstellen Sie in diesem Verzeichnis auch die folgenden Unterverzeichnisse, je nachdem, welche API Sie versuchen möchten:

   • content für die Content -API zum Einkaufen
   • manufacturers für die Herstellerzentrum -API

   Platzieren Sie die nachstehend beschriebenen Dateien im entsprechenden Unterverzeichnis für die API, die Sie ausprobieren möchten.

2. Richten Sie Ihre gewünschte Authentifizierungsmethode ein.

   Wenn Sie Google Application Standard -Anmeldeinformationen verwenden:

   • Befolgen Sie die Anweisungen auf der Seite "Standard -Anmeldeinformationen" Google Application.

   Wenn Sie ein Servicekonto verwenden:

   • Setzen Sie die JSON-Datei, die Sie heruntergeladen haben, beim Erstellen des Dienstkontos in den Datei service-account.json in den entsprechenden API-Konfigurations-Unterverzeichnissen ein.

   Wenn Sie eine OAuth2 -Client -ID verwenden:

   • Laden Sie Ihre OATH2-Client client-secrets.json Anmeldeinformationen in die entsprechenden API-Konfigurations-Unterverzeichnisse herunter.

     HINWEIS: Die Samples gehen davon aus, dass Sie eine OAuth2 -Client -ID verwenden, mit der eine Loopback -IP -Adresse zum Abrufen von Token verwendet werden kann. Wenn Sie sich nicht sicher sind oder nicht sicher sind, besuchen Sie bitte die Seite [OAuth2.0 für Mobile & Desktop -Apps] (https://developers.google.com/identity/protocols/oAuth2installledApp) Seite und befolgen Neue OAuth2 -Client -ID für die Proben.

   Sie können mehrere Authentifizierungsmethoden einrichten, um verschiedene Flows auszuprobieren. Beachten Sie jedoch, dass die Samples immer die ersten Anmeldeinformationen verwenden, die in der Reihenfolge geladen werden können:

   1. Google Application Standard -Anmeldeinformationen
   2. Servicekonten Anmeldeinformationen
   3. OAuth2 Client -Anmeldeinformationen

3. Jeder Satz von Proben verwendet eine andere Konfigurationsdatei. Nehmen Sie für die Content-API zum Einkaufen den Beispiel merchant-info.json aus dem Repository-Root und kopieren Sie ihn in $(HOME)/shopping-samples/content . Ändern Sie als nächstes den Inhalt angemessen. Es enthält ein JSON -Objekt mit den folgenden Feldern:

   Feld	Typ	Beschreibung
   merchantId	Nummer	Die Merchant Center -ID, gegen die Proben drohen.
   accountSampleUser	Saite	Wenn nicht leer, kann die E-Mail-Adresse für den Benutzer Beispiele für den Accounts hinzufügen/entfernen.
   accountSampleAdWordsCID	Nummer	Wenn die adWords-Kunden-ID nicht Null in Beispielen für den Accounts Service verlinkt/entlinket wird.

   Nehmen Sie für die Hersteller-Center-API den Beispiel manufacturer-info.json aus dem Repository-Root und kopieren Sie sie in $(HOME)/shopping-samples/manufacturers . Ändern Sie als nächstes den Inhalt angemessen. Es enthält ein JSON -Objekt mit den folgenden Feldern:

   Feld	Typ	Beschreibung
   manufacturerId	Nummer	Die Herstellerzentrum -ID für Proben gegen.
   websiteUrl	Saite	Die mit dem Herstellerzentrumskonto verknüpfte URL (ohne nachfolgende Schrägstriche).

   Wenn Sie OAuth2-Client-Anmeldeinformationen verwenden, werden Ihre Token-Details nach dem autorisierten Zugriff in der Datei stored-token.json im Probenkonfigurationsverzeichnis gespeichert. Wenn Sie Probleme haben, die sich authentifizieren, entfernen Sie diese Datei und Sie werden aufgefordert, den Zugriff neu zu autorisieren.

Probieren Sie die Proben aus

Nachdem Sie sowohl die gemeinsame Beispielkonfigurationsdatei konfiguriert als auch Ihre Authentifizierungsanmeldeinformationen eingerichtet haben, ist es an der Zeit, die enthaltenen Beispiele zu erstellen und auszuführen. Wie bereits erwähnt, gibt es sprachspezifische Anweisungen in den README in jedem Sprach-Unterverzeichnis. Viel Spaß!

Mögliche Probleme

• Wenn Sie die Content -API zum Einkaufen verwenden, können Sie beim Ausführen bestimmter Beispiele einen Fehler erhalten, wenn Sie keine Steuereinstellungen in Ihrem Konto eingerichtet haben. Wenn Sie einen Fehler "fehlende Steuereinstellungen" erhalten, legen Sie Ihre Steuereinstellungen im Händlerzentrum fest, bevor Sie diese Beispiele ausprobieren. Die Auswahl der Einstellung "Steuern in den Vereinigten Staaten nicht erheben" ist ausreichend.