Interfejs API Manufacturer Center (MfC) umożliwia aplikacjom bezpośrednią współpracę z platformą Manufacturer Center. Na początek oferujemy przykładowy kod w językach Java i .NET.
Ten przewodnik pomoże Ci utworzyć pierwszą aplikację za pomocą interfejsu API Manufacturer Center. Zanim zaczniesz kodować, musisz zrobić kilka rzeczy.
Obsługa REST
Nasz interfejs API typu REST obsługuje podstawowe operacje CRUD dla 2 różnych typów zasobów:
- usługa dla właścicieli marek i dostawców danych.
- ProductCertification dla jednostek certyfikujących.
Pozostała część tej dokumentacji będzie poświęcona głównie usłudze, ale proces powinien przebiegać podobnie w przypadku ProductCertification.
Konfigurowanie konta Manufacturer Center
Utwórz konto Manufacturer Center.
Pamiętaj, który adres e-mail został użyty do utworzenia tego konta Manufacturer Center, ponieważ będzie on potrzebny później. Na zrzutach ekranu jest on przedstawiony w postaci manufacturer_user@example.com.
Wykonaj pierwsze żądanie do interfejsu API (bez wiersza kodu)
Otwórz Eksploratora interfejsów API w naszej dokumentacji dla deweloperów aplikacji
Accounts.Products.list
.Sprawdź, czy zalogowane konto Google jest wymienione w ustawieniu „Użytkownicy” na karcie Ustawienia.
W narzędziu Google APIs Explorer wybierz Google OAuth 2.0 w menu Uwierzytelnianie:
W polu „nadrzędny” formularza wpisz
accounts/{account_id}
, zastępując{account_id}
identyfikatorem producenta z konta Manufacturer Center, a następnie kliknij Wykonaj.Powinna wyświetlić się poprawna odpowiedź. Gratulacje! Udało Ci się wysłać pierwsze żądanie do interfejsu API Manufacturer Center.
Jeśli w Manufacturer Center nie masz jeszcze żadnych produktów, nie będzie ich na liście. W tym momencie możesz przejść do innych żądań i sprawdzić, jak one działają. Jest to interfejs API typu REST, więc wszystkie żądania działają podobnie. Gdy już będziesz mieć produkty, warto wypróbować
Accounts.Products.get
.
Tworzenie projektu w konsoli interfejsów API Google
Żądania do interfejsu API Manufacturer Center są wysyłane przez projekt w konsoli API. Zakładamy, że będziesz korzystać z własnego konta Manufacturer Center, dlatego zalecamy użycie kont usługi, aby uprościć proces uwierzytelniania. Szczegółowe informacje o tym, jak skonfigurować nowe konto usługi do korzystania z konta Manufacturer Center, znajdziesz w przewodniku po kontach usługi.
Twoje pierwsze autoryzowane żądanie do interfejsu API w Javie
Po skonfigurowaniu konta usługi i dodaniu identyfikatora konta usługi do konta Manufacturer Center możesz uzyskać dostęp do swojego konta za pomocą dostępnego kodu próbek. W tym przewodniku wykorzystano przykłady Javy do zademonstrowania korzystania z interfejsu API.
Zainstaluj narzędzie Apache Maven.
Pobierz nasze przykłady Zakupów ze strony GitHub.
W podkatalogu
java
utwórz przykłady w Javie:$ mvn compile
Teraz uruchom kod
ProductsListSample
(przykład dla ProductCertification toListProductCertificationsSample
):$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
Jeśli nie wykonasz instrukcji konfiguracji w pliku README dołączonym do plików źródłowych, pojawi się błąd informujący o tym, że nie znaleziono przykładowej konfiguracji. Postępuj zgodnie z instrukcjami w pliku README, aby utworzyć katalog konfiguracji i wypełnić go odpowiednimi informacjami. Plik JSON pobrany przy konfigurowaniu konta usługi powinien znajdować się w tym katalogu pod nazwą pliku
service-account.json
. Pamiętaj, aby wskazać kodowi, gdzie znajduje się Twój plik, ustawiając tę zmienną środowiskową.export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
Po skonfigurowaniu przykładowej konfiguracji uruchom ponownie kod
ProductsListSample
.$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
W tym momencie program Java powinien zakończyć wykonywanie i wyświetlić listę znalezionych usług lub komunikat o braku produktów na koncie. Jeśli pojawi się błąd „Użytkownik nie ma dostępu do konta 1234567890”, najprawdopodobniej nie został przez Ciebie skonfigurowany użytkownik konta usługi jako autoryzowany użytkownik w Manufacturer Center. Z punktu widzenia interfejsu API projekt Konsoli interfejsów API wysłał żądanie w imieniu użytkownika, który nie znajduje się na liście autoryzowanych administratorów Manufacturer Center, więc oczywiście odrzucałby to żądanie.
Z uruchamianiem
ProductsListSample
możesz eksperymentować tyle razy, ile chcesz, ponieważ jest to żądanie tylko do odczytu. Możesz też zapoznać się z innymi przykładami, które utworzyliśmy dla Javy i .NET.