Do skonfigurowania Content API for Shopping zalecamy używanie bibliotek klienta interfejsu API Google. W tym przewodniku jako przykład używamy bibliotek klienta Content API w języku Python, ale są one dostępne w wielu popularnych językach programowania i upraszczają typowe zadania związane z interfejsem API, takie jak uwierzytelnianie, wysyłanie żądań i analizowanie odpowiedzi. Aby uzyskać pomoc w konfigurowaniu bibliotek klienta w innych językach, zapoznaj się z plikiem README.md w repozytorium googleads/googleads-shopping-samples na GitHubie.
Aby skonfigurować bibliotekę klienta interfejsu API Google dla języka Python, wykonaj te czynności:
Utwórz katalog na pliki konfiguracyjne i uwierzytelniające biblioteki klienta. W katalogu głównym utwórz te katalogi:
~/shopping-samples/content/
Aby pobrać dane logowania konta usługi, wykonaj te czynności:
- Otwórz bibliotekę interfejsów API Google.
- W menu u góry strony wybierz projekt. Jeśli nie masz jeszcze projektu, utwórz go, klikając Nowy projekt.
- Jeśli nie masz jeszcze włączonego Content API for Shopping w tym projekcie, wyszukaj go na liście interfejsów API Google i włącz.
- W lewym górnym rogu kliknij menu nawigacyjne (☰), wybierz Interfejsy API i usługi, a następnie Dane logowania.
- Aby skonfigurować konto usługi, kliknij Utwórz dane logowania, a następnie Konto usługi.
- Nazwij nowe konto usługi. Będzie to też domyślna nazwa użytkownika identyfikatora konta usługi. Zapisz identyfikator konta usługi, w tym część po znaku „@”, aby użyć go później. Kliknij Utwórz, a następnie wykonaj opcjonalne czynności związane z przyznawaniem dostępu do projektu i użytkowników i kliknij Gotowe.
- Przekierujemy Cię na stronę Konta usługi, na której możesz uzyskać dostęp do nowego konta usługi.
Aby uzyskać klucz prywatny JSON, kliknij konto usługi, a następnie kartę Klucze. Kliknij Dodaj klucz > Utwórz nowy klucz, a następnie jako typ klucza wybierz JSON. Kliknij Utwórz , aby pobrać klucz prywatny na komputer. Nowy klucz zostanie pobrany automatycznie.
Zmień nazwę pobranego pliku danych logowania na service-account.json.
Przenieś plik service-account.json do home directory/shopping-samples/content/.
W home directory/shopping-samples/content/ utwórz pusty merchant-info.json plik.
W pliku merchant-info.json dodaj ten tekst:
{ "merchantId": your Merchant Center merchant ID, "accountSampleUser": "the email address associated with your Merchant Center account" }Dodaj nowe konto usługi jako użytkownika na swoim koncie Merchant Center. Jeśli jesteś deweloperem zewnętrznym, musisz poprosić o to klienta.
- Wejdź na konto Merchant Center.
- W ustawieniach konta Merchant Center wybierz Osoby i dostęp.
Kliknij + Dodaj osobę i jako adres e-mail nowego użytkownika użyj identyfikatora konta usługi.
Korzystanie z usługi
Accountswymaga dostępu administratora, więc wybierz Administrator.Kliknij Dodaj użytkownika , aby zapisać preferencje i wrócić do listy użytkowników. Identyfikator konta usługi jest wyświetlany z wybraną rolą użytkownika.
Powtórz ten proces w przypadku wszystkich innych kont usług, które chcesz dodać.
Sklonuj (lub pobierz i rozpakuj) repozytorium googleads/googleads-shopping-samples na GitHubie w dowolnym miejscu na komputerze. Nie musi to być katalog główny ani ~/shopping-samples/content/.
Jeśli zamiast klonowania repozytorium pobierzesz je i rozpakujesz, zmień nazwę rozpakowanego katalogu na googleads-shopping-samples.
Aby zainstalować wymagane zależności przykładowe, w oknie terminala przejdź do katalogu googleads-shopping-samples/python/ i uruchom:
pip install -r requirements.txt
Biblioteka klienta interfejsu API Google dla języka Python jest teraz skonfigurowana i gotowa do użycia z Content API. W następnej sekcji utworzysz i wyślesz żądanie wstawienia nowego produktu.