Interfejs Manufacturer Center (MfC) API umożliwia aplikacjom bezpośrednią interakcję z platformą Manufacturer Center. Aby ułatwić Ci rozpoczęcie korzystania z usługi, udostępniamy przykłady kodu w języku Java i .NET.
Ten przewodnik pomoże Ci utworzyć pierwszą aplikację za pomocą interfejsu Manufacturer Center API. Zanim zaczniesz kodować, musisz wykonać kilka czynności.
Obsługa REST
Nasz interfejs API typu REST obsługuje podstawowe operacje CRUD dla 2 różnych typów zasobów:
- Produkt dla właścicieli marek i dostawców danych.
- Oraz Product Certification dla jednostek certyfikacji.
Pozostała część tej dokumentacji będzie przeznaczona głównie dla produktów Product, ale proces ten powinien wyglądać podobnie do certyfikatu usługi.
Konfigurowanie konta Manufacturer Center
Utwórz konto Manufacturer Center.
Pamiętaj, aby użyć adresu e-mail użytego do utworzenia tego konta Manufacturer Center, ponieważ będziesz potrzebny później. Na zrzutach ekranu zobaczysz symbol manufacturer_użytkownik@example.com.
Wyślij pierwsze żądanie do interfejsu API (bez wiersza kodu)
Otwórz Eksplorator interfejsów API w dokumentacji dla programistów dotyczącej
Accounts.Products.list
.Upewnij się, że na liście w sekcji „Użytkownicy” na karcie Ustawienia jest widoczne konto Google.
W menu interfejsów API 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 i kliknij Wykonaj.Powinna wyświetlić się odpowiedź. Gratulacje! Udało Ci się wysłać pierwsze żądanie do interfejsu Manufacturer Center API.
Jeśli nie masz jeszcze żadnych produktów w Manufacturer Center, nie zobaczysz ich na liście. W tym momencie możesz przejść do innych żądań i sprawdzić, jak działają. Ponieważ jest to interfejs API typu REST, wszystkie żądania działają w podobny sposób. Następnym krokiem po wdrożeniu produktów jest wypróbowanie
Accounts.Products.get
.
Tworzenie projektu w konsoli Google API
Żądania do interfejsu Manufacturer Center API są realizowane przez projekt konsoli interfejsu API. W tym miejscu zakładamy, że będziesz mieć dostęp do własnego konta Manufacturer Center, dlatego zalecamy korzystanie z kont usługi, aby uprościć proces uwierzytelniania. Przewodnik po kontach usługi zawiera szczegółowe informacje o konfigurowaniu nowego konta usługi, które ma być używane z kontem Manufacturer Center.
Twoje pierwsze autoryzowane żądanie do interfejsu API korzystające z języka Java
Gdy skonfigurujesz konto usługi i dodasz identyfikator konta usługi do konta Manufacturer Center, możesz uzyskać do niego dostęp za pomocą dostępnego kodu. W tym przewodniku wykorzystano przykłady z Javy za pomocą interfejsu API.
Zainstaluj Apache Maven, jeśli jeszcze nie jest zainstalowany.
Pobierz przykłady Zakupów ze strony GitHub.
W podkatalogu
java
utwórz przykłady środowiska Java:$ mvn compile
Teraz uruchom kod
ProductsListSample
(przykład w przypadku Product Certification toListProductCertificationsSample
):$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
Jeśli nie przestrzegasz wskazówek dotyczących konfiguracji podanych w README wraz z plikami źródłowymi, pojawi się komunikat o błędzie informujący o tym, że nie znaleziono żadnej przykładowej konfiguracji. Postępuj zgodnie ze wskazówkami w README, aby utworzyć katalog konfiguracji i wypełnić go odpowiednimi informacjami. Plik JSON pobrany podczas konfigurowania konta usługi powinien znajdować się w tym katalogu o nazwie
service-account.json
. Pamiętaj, by podać kodowi lokalizację pliku, ustawiając poniższą zmienną środowiskową.export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
Po skonfigurowaniu próbek kodu ponownie uruchom kod
ProductsListSample
.$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
W tym momencie program w języku Java powinien wykonać polecenie i wydrukować listę znalezionych produktów lub informację, że na koncie nie ma żadnych produktów. Jeśli pojawi się błąd taki jak „Użytkownik nie ma dostępu do konta 1234567890”, prawdopodobnie nie skonfigurowano konta użytkownika jako autoryzowanego użytkownika w Manufacturer Center. Z punktu widzenia interfejsu API projekt w konsoli API wysłał żądanie w imieniu użytkownika, który nie znajduje się na liście autoryzowanych administratorów Manufacturer Center, więc ta prośba została oczywiście odrzucona.
Możesz eksperymentować z uruchamianiem
ProductsListSample
tyle razy, ile chcesz, ponieważ jest to żądanie tylko do odczytu. Możesz też zobaczyć inne przykłady, które utworzyliśmy zarówno dla języka Java, jak i .NET.