Konfigurowanie biblioteki klienta

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:

  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. W menu u góry strony wybierz projekt. Jeśli nie masz jeszcze projektu, utwórz go, klikając Nowy projekt.
    3. 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.
    4. W lewym górnym rogu kliknij menu nawigacyjne (☰), wybierz Interfejsy API i usługi, a następnie Dane logowania.
    5. Aby skonfigurować konto usługi, kliknij Utwórz dane logowania, a następnie Konto usługi.
    6. 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.
    7. Przekierujemy Cię na stronę Konta usługi, na której możesz uzyskać dostęp do nowego konta usługi.
  3. 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.

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

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

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

  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, musisz poprosić o to klienta.

    1. Wejdź na konto Merchant Center.
    2. W ustawieniach konta Merchant Center wybierz Osoby i dostęp.
    3. Kliknij + Dodaj osobę i jako adres e-mail nowego użytkownika użyj identyfikatora konta usługi.

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

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

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

  9. 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/.

  10. Jeśli zamiast klonowania repozytorium pobierzesz je i rozpakujesz, zmień nazwę rozpakowanego katalogu na googleads-shopping-samples.

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