Jetzt starten

Über die Manufacturer Center API (MfC) können Apps direkt mit der Manufacturer Center-Plattform interagieren. Als Einstiegshilfe 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 noch einige Schritte ausführen.

REST-Support

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

• Produkt für Markeninhaber und Datenpartner.
• Und ProductZertifizierung für Zertifizierungsstellen.

Der Rest dieser Dokumentation bezieht sich hauptsächlich auf Product, der Prozess sollte aber für Product Certification ähnlich sein.

Manufacturer Center-Konto einrichten

1. Erstellen Sie ein Manufacturer Center-Konto.

   Hinweis: Nutzer mit Zertifizierung können auf diese Weise kein Konto erstellen, sondern sich direkt an unseren Support wenden.

2. Achten Sie darauf, welche E-Mail-Adresse Sie zum Erstellen dieses Manufacturer Center-Kontos verwendet haben, da Sie diese später benötigen. Auf den Screenshots sehen Sie diesen Eintrag als [e-mail].

Stellen Sie Ihre erste API-Anfrage (ohne Codezeile)!

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

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

   

3. Achten Sie darauf, dass im APIs Explorer im Drop-down-Menü Authentication (Authentifizierung) die Option Google OAuth 2.0 ausgewählt ist:

   

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

   

   Hinweis: Wenn Sie OAuth2-Berechtigungen noch nicht gewährt 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 Sie noch keine Produkte in Ihrem Manufacturer Center haben, werden keine aufgeführt. An dieser Stelle können Sie auf andere 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 werden über Ihr API Console-Projekt gestellt. In diesem Beispiel 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 für Ihr Manufacturer Center-Konto finden Sie im Leitfaden zu Dienstkonten.

Hinweis: Informationen zu Aufrufen im Namen von Kunden mit eigenen Manufacturer Center-Konten finden Sie im Leitfaden Anfragen autorisieren.

Ihre erste autorisierte API-Anfrage mit Java

Nachdem Sie 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 werden die Java-Beispiele zur Verwendung der API verwendet.

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

2. Laden Sie unsere Shopping-Beispiele von unserer GitHub-Seite herunter.

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

   $ mvn compile
   

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

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

5. Wenn Sie die Anweisungen in der README-Datei für die Quelldateien nicht befolgt haben, wird eine Fehlermeldung angezeigt, 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 Ihres Dienstkontos heruntergeladen haben, sollte in diesem Verzeichnis mit dem Dateinamen service-account.json gespeichert sein. Denken Sie daran, dem Code mitzuteilen, wo sich die 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 Code ProductsListSample 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 abschließen und entweder eine Liste der gefundenen Produkte oder eine Meldung anzeigen, dass in Ihrem Konto keine Produkte vorhanden sind. Wenn Sie eine Fehlermeldung wie „Nutzer kann nicht auf das Konto 1234567890 zugreifen“ erhalten, liegt das wahrscheinlich daran, dass Sie den Dienstkontonutzer im Manufacturer Center nicht als autorisierten Nutzer eingerichtet haben. Aus Sicht der API hat das API-Konsolenprojekt eine Anfrage im Namen eines Nutzers gesendet, der nicht auf der Liste der autorisierten Manufacturer Center-Administratoren steht. Daher würde sie diese Anfrage natürlich ablehnen.

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