Konfigurowanie biblioteki klienta

Chcemy przedstawić wersję beta interfejsu Merchant API. To nowa wersja Content API i przyszłość.

Zalecamy korzystanie z bibliotek klienta interfejsu API Google do konfigurowania Content API for Shopping. W tym przewodniku użyliśmy na przykład bibliotek klienckich interfejsu API Python Content API, ale są one dostępne dla wielu popularnych języków programowania i upraszczają wykonywanie typowych zadań związanych z interfejsem API, takich jak uwierzytelnianie, wysyłanie żądań czy analizowanie odpowiedzi. Aby uzyskać pomoc w konfigurowaniu bibliotek klienta dla innych języków, otwórz plik README.md dotyczący języka w repozytorium googleads/googleads-shopping-samples na GitHubie.

Uwaga: aby korzystać z przykładowego kodu w Pythonie, musisz zainstalować kilka wymaganych bibliotek. Dlatego zalecamy, aby przed kontynuowaniem utworzyć środowisko wirtualne Pythona. Więcej informacji znajdziesz w artykule o instalowaniu pakietów przy użyciu pip i środowisk wirtualnych.

Aby skonfigurować bibliotekę klienta interfejsów API Google pod kątem Pythona, wykonaj te czynności:

1. Utwórz katalog na pliki konfiguracji i uwierzytelniania biblioteki klienta. W katalogu głównym utwórz te katalogi:

   ~/shopping-samples/content/

   Uwaga: ta ścieżka wraz z nazwą pliku merchant-info.json utworzonego w kroku 5 są zdefiniowane w pliku python/shopping/content/common.py, który znajduje się w katalogu z przykładami w Content API (pobranym w kroku 7).

2. Aby pobrać dane logowania na konto usługi, wykonaj te czynności:

   1. W Merchant Center w menu Ustawienia wybierz Content API.
   2. Kliknij Authentication (Uwierzytelnianie).
   3. Kliknij [+] UTWÓRZ KLUCZ API.
   4. Jeśli pojawi się taka prośba, przeczytaj i zaakceptuj warunki korzystania z usług.

   Nowy klucz zostanie pobrany automatycznie.

3. Zmień nazwę pobranego pliku danych logowania na service-account.json.

   Uwaga: tę nazwę pliku znajdziesz w pliku _constants.py, który znajduje się w katalogu python/shopping/content/ w katalogu z przykładami Content API pobranym w kroku 7.

4. Przenieś plik service-account.json do folderu home directory/shopping-samples/content/.

5. W pliku home directory/shopping-samples/content/ utwórz pusty plik merchant-info.json.

6. W pliku merchant-info.json dodaj następujący tekst:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

7. Skopiuj (lub pobierz i rozpakuj) googleads/googleads-shopping-samples repozytorium GitHub na dowolne miejsce na komputerze – nie musi to być katalog główny ani katalog ~/shopping-samples/content/.

8. Jeśli repozytorium zostało pobrane i rozpakowane, zamiast klonować, zmień nazwę rozpakowanego katalogu na googleads-shopping-samples.

9. Aby zainstalować wymagane przykładowe zależności, w oknie terminala przejdź do strony googleads-shopping-samples/python/ i uruchom polecenie:

   pip install -r requirements.txt
   

Masz teraz skonfigurowaną bibliotekę klienta interfejsu API Google dla języka Python i gotową do użycia z Content API. W następnej sekcji utworzysz i wyślesz prośbę o wstawienie nowego produktu.