Wypróbuj

Interfejs Manufacturer Center API umożliwia aplikacjom bezpośrednią współpracę z platformą Manufacturer Center. Na początek udostępniamy przykładowe fragmenty kodu w Javie i .NET.

Ten przewodnik pomoże Ci utworzyć pierwszą aplikację za pomocą interfejsu Manufacturer Center API. Zanim zaczniesz kodować, musisz wykonać kilka czynności.

Skonfiguruj konto Manufacturer Center

  1. Utwórz konto Manufacturer Center.
  2. Pamiętaj, aby podać adres e-mail użyty do utworzenia tego konta Manufacturer Center, ponieważ będziesz go później potrzebować. Na zrzutach ekranu zobaczysz, że jest on reprezentowany przez producent_użytkownik@example.com.

Pierwsze żądanie API (bez wiersza kodu)

  1. Otwórz Eksploratora interfejsów API w dokumentacji dla deweloperów dotyczącej Accounts.Products.list.
  2. Upewnij się, że zalogowane konto Google jest wymienione na karcie „Użytkownicy” w sekcji „Ustawienia”.

  3. Upewnij się, że w eksploratorze interfejsów API w menu Uwierzytelnianiewybierze się Google OAuth 2.0:

  4. Wpisz accounts/{account_id}, zastępując {account_id} identyfikatorem producenta z konta Manufacturer Center w polu &formularz_39 formularza i kliknij Wykonaj.

    Uwaga: jeśli wcześniej nie przyznano Ci uprawnienia OAuth2, wyświetli się prośba o autoryzację połączenia.

  5. Powinna pojawić 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 pojawią się one na liście. W tym momencie możesz przejść do innych żądań i przejrzeć ich działanie. Ponieważ jest to interfejs API typu REST, wszystkie żądania działają podobnie. Następnym krokiem po wdrożeniu produktów jest wypróbowanie Accounts.Products.get.

Tworzenie projektu w Konsoli interfejsów API Google

Żądania do interfejsu Manufacturer Center API są realizowane za pomocą projektu API Console. W tym przypadku zakładamy, że będziesz mieć dostęp do własnego konta Manufacturer Center. Zalecamy więc użycie kont usługi, aby uprościć proces uwierzytelniania. Zapoznaj się z przewodnikiem Konta usługi, aby dowiedzieć się, jak skonfigurować nowe konto usługi, które będzie używane z kontem Manufacturer Center.

Uwaga: jeśli chcesz nawiązywać połączenia w imieniu klientów, którzy mają własne konta Manufacturer Center, przeczytaj przewodnik Autoryzowanie żądań.

Twoje pierwsze autoryzowane żądanie API oparte na języku Java

Gdy masz już skonfigurowane 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 przykładowego. W tym przewodniku używamy przykładów interfejsu Java, aby pokazać, jak używać interfejsu API.

  1. Zainstaluj Apache Maven, jeśli jeszcze nie jest zainstalowany.
  2. Pobierz próbki reklam produktowych ze strony GitHub.

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

    $ mvn compile
            

  4. Teraz uruchom kod ProductsListSample:

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

  5. Jeśli nie wykonasz instrukcji konfiguracji README towarzyszących plikom źródłowym, pojawi się błąd informujący o tym, że nie można znaleźć przykładowej konfiguracji. Aby utworzyć katalog konfiguracji i wypełnić go odpowiednimi informacjami, postępuj zgodnie ze wskazówkami w README. Plik JSON pobrany podczas konfigurowania konta usługi powinien być w tym katalogu o nazwie service-account.json.

  6. Po skonfigurowaniu przykładowych przykładów uruchom ponownie kod ProductsListSample.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
            
  7. Na tym etapie program Java powinien zakończyć wykonywanie i wydrukować listę znalezionych produktów lub komunikat o braku produktów na koncie. Jeśli pojawia się błąd taki jak &Użytkownik nie ma dostępu do konta 1234567890, najprawdopodobniej oznacza to, że konto usługi nie zostało przez Ciebie skonfigurowane jako autoryzowany użytkownik w Manufacturer Center. Z punktu widzenia interfejsu API projekt konsoli API wysyłał żądanie w imieniu użytkownika, którego nie było na liście autoryzowanych administratorów Manufacturer Center, dlatego zaproszenie to zostałoby odrzucone.

  8. Możesz eksperymentować z uruchomieniem ProductsListSample tyle razy, ile chcesz, ponieważ jest to żądanie tylko do odczytu. Możesz też zapoznać się z innymi przykładami, które opracowaliśmy dla języków Java i .NET.