Erste Schritte

Über die Manufacturer Center API (MfC) können Apps direkt mit der Manufacturer Center-Plattform interagieren. Für einen leichteren Einstieg stellen wir Codebeispiele in Java und .NET zur Verfügung.

In diesem Leitfaden erfahren Sie, wie Sie Ihre erste Anwendung mit der Manufacturer Center API erstellen. Bevor Sie mit dem Programmieren beginnen können, müssen Sie einige Dinge tun.

REST-Unterstützung

Unsere REST API unterstützt grundlegende CRUD-Vorgänge für zwei verschiedene Arten von Ressourcen:

• Produkt für Markeninhaber und Datenpartner
• und die ProductCertification für Zertifizierungsstellen.

Der Rest dieser Dokumentation wird hauptsächlich für Product verfasst. Das Verfahren für die ProductCertification sollte jedoch ähnlich sein.

Manufacturer Center-Konto einrichten

1. Erstellen Sie ein Manufacturer Center-Konto.

   Hinweis: Nutzer der Zertifizierungsstelle können auf diese Weise kein Konto erstellen. Sie müssen sich jedoch direkt an unseren Support wenden.

2. Merken Sie sich die E-Mail-Adresse, mit der Sie dieses Manufacturer Center-Konto erstellt haben, da Sie diese später benötigen. Auf den Screenshots wird sie als [e-mail] angezeigt.

Stellen Sie Ihre erste API-Anfrage (ohne Codezeile)

1. Rufen Sie den APIs Explorer in unserer Entwicklerdokumentation für Accounts.Products.list auf.

2. Das angemeldete Google-Konto muss auf dem Tab „Einstellungen“ unter „Nutzer“ aufgeführt sein.

   

3. Im APIs Explorer muss im Drop-down-Menü Authentifizierung die Option Google OAuth 2.0 ausgewählt sein:

   

4. Geben Sie in das Feld „Übergeordnetes“ Feld des Formulars accounts/{account_id} ein und ersetzen Sie dabei {account_id} durch Ihre Hersteller-ID aus Ihrem Manufacturer Center-Konto. Klicken Sie dann auf Ausführen.

   

   Hinweis: Wenn Sie bisher noch keine OAuth2-Berechtigung erteilt haben, werden Sie jetzt aufgefordert, den Aufruf zu autorisieren.

5. Sie sollten eine Erfolgsmeldung sehen. Glückwunsch! Sie haben Ihre erste Manufacturer Center API-Anfrage gestellt.

6. Wenn sich noch keine Produkte in Ihrem Manufacturer Center befinden, werden keine Produkte in der Liste angezeigt. An dieser Stelle können Sie zu anderen Anfragen springen und sich ihre Funktionsweise ansehen. Da es sich um eine RESTful API handelt, funktionieren alle Anfragen ähnlich. Sobald Sie Produkte haben, empfiehlt es sich, Accounts.Products.get auszuprobieren.

Google API Console-Projekt erstellen

Anfragen an die Manufacturer Center API erfolgen über Ihr API Console-Projekt. In diesem Fall gehen wir davon aus, dass Sie auf Ihr eigenes Manufacturer Center-Konto zugreifen. Daher empfehlen wir die Verwendung von Dienstkonten, um den Authentifizierungsvorgang zu vereinfachen. Weitere Informationen zum Einrichten eines neuen Dienstkontos zur Verwendung mit Ihrem Manufacturer Center-Konto finden Sie in der Anleitung zu Dienstkonten.

Hinweis :Wenn Sie Anrufe im Namen von Kunden mit eigenen Manufacturer Center-Konten starten möchten, lesen Sie den Leitfaden Anfragen autorisieren.

Ihre erste autorisierte API-Anfrage mit Java

Nachdem Sie nun ein Dienstkonto eingerichtet und die Dienstkonto-ID Ihrem Manufacturer Center-Konto hinzugefügt haben, können Sie mit dem verfügbaren Beispielcode auf Ihr Konto zugreifen. In diesem Leitfaden wird anhand der Java-Beispiele die Verwendung der API veranschaulicht.

1. Installieren Sie Apache Maven, falls noch nicht geschehen.

2. Sie können die Shopping-Beispiele von unserer GitHub-Seite herunterladen.

3. Erstellen Sie die Java-Beispiele im Unterverzeichnis java:

   $ mvn compile
   

4. Führen Sie nun den Code ProductsListSample aus (Beispiel für ProductCertification wäre ListProductCertificationsSample):

   $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
   

5. Wenn Sie die Konfigurationsanweisungen in der README-Datei der Quelldateien nicht befolgt haben, erhalten Sie eine Fehlermeldung, die besagt, dass keine Beispielkonfiguration gefunden wurde. Folgen Sie der Anleitung in der README-Datei, um das Konfigurationsverzeichnis zu erstellen und mit den entsprechenden Informationen zu füllen. Die JSON-Datei, die Sie beim Einrichten des Dienstkontos heruntergeladen haben, sollte sich in dem Verzeichnis mit dem Dateinamen service-account.json befinden. Denken Sie daran, dem Code mitzuteilen, wo sich Ihre Datei befindet, indem Sie die folgende Umgebungsvariable festlegen.

   export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
   

6. Nachdem Sie die Beispielkonfiguration eingerichtet haben, führen Sie den ProductsListSample-Code noch einmal aus.

   $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
   

7. An diesem Punkt sollte das Java-Programm die Ausführung beenden und entweder eine Liste der gefundenen Produkte oder eine Meldung ausgeben, dass in Ihrem Konto keine Produkte vorhanden sind. Wenn Sie eine Fehlermeldung wie „Nutzer kann nicht auf Konto 1234567890 zugreifen“ erhalten, liegt das höchstwahrscheinlich daran, dass Sie den Dienstkontonutzer nicht als autorisierter Nutzer im Manufacturer Center eingerichtet haben. Aus Sicht der API hat das API Console-Projekt eine Anfrage im Namen eines Nutzers gesendet, der nicht auf der Liste der autorisierten Manufacturer Center-Administratoren steht. Daher würde die Anfrage natürlich abgelehnt werden.

8. Sie können die Ausführung von ProductsListSample beliebig oft testen, da es sich um eine schreibgeschützte Anfrage handelt. Sie können sich auch die anderen Beispiele ansehen, die wir für Java und .NET erstellt haben.