Wypróbuj

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:

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

  1. Utwórz konto Manufacturer Center.

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

  1. Otwórz Eksplorator interfejsów API w dokumentacji dla programistów dotyczącej Accounts.Products.list.

  2. Upewnij się, że na liście w sekcji „Użytkownicy” na karcie Ustawienia jest widoczne konto Google.

  3. W menu interfejsów API 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 i kliknij Wykonaj.

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

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

  1. Zainstaluj Apache Maven, jeśli jeszcze nie jest zainstalowany.

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

  3. W podkatalogu java utwórz przykłady środowiska Java:

    $ mvn compile
    
  4. Teraz uruchom kod ProductsListSample (przykład w przypadku Product Certification to ListProductCertificationsSample):

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  5. 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>
    
  6. Po skonfigurowaniu próbek kodu ponownie uruchom kod ProductsListSample.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  7. 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.

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