Konfigurowanie biblioteki klienta

Do skonfigurowania Content API for Shopping zalecamy użycie bibliotek klienta interfejsu API Google. W tym przewodniku jako przykładu używamy bibliotek klienta Python Content API, 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 w GitHubie.

Aby skonfigurować bibliotekę klienta interfejsu API Google dla języka Python, wykonaj te czynności:

1. Utwórz katalog na pliki konfiguracyjne i uwierzytelniające biblioteki klienta. W katalogu głównym utwórz te katalogi:

   ~/shopping-samples/content/

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

   1. Otwórz bibliotekę interfejsów API Google.
   2. Wybierz projekt z menu u góry strony. Jeśli jeszcze go nie masz, utwórz go, klikając Nowy projekt.
   3. Jeśli interfejs Content API for Shopping nie został jeszcze włączony w tym projekcie, wyszukaj go na liście interfejsów Google API i włącz go.
   4. Na pasku bocznym po lewej stronie wybierz Dane logowania. Aby to zobaczyć, konieczne może być kliknięcie strzałki w lewo w lewym górnym rogu.
   5. Aby skonfigurować konto usługi, kliknij Utwórz dane logowania, a następnie wybierz Konto usługi.
   6. Nadaj nazwę nowemu kontu usługi. Jest 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. Kliknij Gotowe.
   7. Przejdziesz na stronę Konta usługi, na której możesz uzyskać dostęp do nowego konta usługi.

3. Aby uzyskać klucz prywatny w formacie JSON, kliknij konto usługi, a następnie kartę Klucze. Kliknij Dodaj klucz > Utwórz nowy klucz, a potem wybierz JSON jako typ klucza. Kliknij Utwórz, aby pobrać klucz prywatny na komputer. Nowy klucz zostanie pobrany automatycznie.

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

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

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

7. W pliku merchant-info.json dodaj ten tekst:

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

8. Dodaj nowe konto usługi jako użytkownika na swoim koncie Merchant Center. Jeśli jesteś deweloperem zewnętrznym, poproś o wykonanie tego kroku klienta.

   1. Otwórz konto Merchant Center.
   2. W ustawieniach konta Merchant Center kliknij Osoby i dostęp.

   3. Kliknij + Dodaj osobę i użyj identyfikatora konta usługi jako adresu e-mail nowego użytkownika.

   4. Korzystanie z usługi Accounts wymaga dostępu administracyjnego, więc wybierz Administrator.

   5. Kliknij Dodaj użytkownika, aby zapisać ustawienia i wrócić do listy użytkowników. Identyfikator konta usługi jest podany wraz z wybraną rolą użytkownika.

   6. Powtórz ten proces w przypadku wszystkich innych kont usług, które chcesz dodać.

9. Sklonuj (lub pobierz i rozpakuj) repozytorium GitHub googleads/googleads-shopping-samples w dowolnym miejscu na komputerze. Nie musi ono znajdować się w katalogu domowym ani w ~/shopping-samples/content/.

10. Jeśli repozytorium zostało pobrane i rozpakowane, a nie sklonowane, zmień nazwę rozpakowanego katalogu na googleads-shopping-samples.

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

    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 prośbę o wstawienie nowego produktu.