Rozpocznij

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

1. Utwórz konto Manufacturer Center.

2. 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)

1. Otwórz Eksploratora interfejsów API w naszej dokumentacji dla deweloperów aplikacji Accounts.Products.list.

2. Sprawdź, czy zalogowane konto Google jest wymienione w ustawieniu „Użytkownicy” na karcie Ustawienia.

   

3. W narzędziu Google APIs Explorer wybierz Google OAuth 2.0 w menu Uwierzytelnianie:

   

4. 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.

   

5. Powinna wyświetlić się poprawna odpowiedź. Gratulacje! Udało Ci się wysłać pierwsze żądanie do interfejsu API Manufacturer Center.

6. 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.

1. Zainstaluj narzędzie Apache Maven.

2. Pobierz nasze przykłady Zakupów ze strony GitHub.

3. W podkatalogu java utwórz przykłady w Javie:

   $ mvn compile
   

4. Teraz uruchom kod ProductsListSample (przykład dla ProductCertification to ListProductCertificationsSample):

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

5. 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>
   

6. Po skonfigurowaniu przykładowej konfiguracji uruchom ponownie kod ProductsListSample.

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

7. 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.

8. 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.