Konfigurowanie biblioteki klienta

Chcielibyśmy przedstawić wersję beta Merchant API. To nowa wersja programu Content API for Shopping i przyszłości.

Aby dowiedzieć się, w jaki sposób interfejs Merchant API może poprawić integrację i jak możesz pomóc kształtować w przyszłości, patrz ogłoszenie interfejsu API sprzedawcy w wersji beta.

Zalecamy użycie metody Biblioteki klienta interfejsów API Google do ustawienia za pomocą Content API for Shopping. Ten przewodnik używa klienta interfejsu Content API w Pythonie biblioteki, ale są one dostępne dla wielu popularnych programów i uprościć typowe zadania związane z interfejsami API, takie jak uwierzytelnianie, wysyłanie żądań i analizowania odpowiedzi. Aby uzyskać pomoc przy konfigurowaniu bibliotek klienta dla innych języków znajdziesz w pliku README.md googleads/googleads-shopping-samples znajdziesz w repozytorium GitHub.

Uwaga: aby używać przykładowego kodu w Pythona. Z tego powodu zalecamy utworzenie wirtualnego środowiska Pythona. zanim przejdziesz dalej. Więcej informacji: Instalowanie 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 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 utworzone w kroku 5 są zdefiniowane w pliku python/shopping/content/common.py. w katalogu z przykładami Content API pobrany w kroku 7.

2. Aby pobrać dane logowania na konto 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 konta utwórz je, klikając Nowy projekt.
   3. Jeśli nie masz jeszcze włączonego interfejsu Content API for Shopping, projektu, wyszukaj go na liście interfejsów API Google i włącz.
   4. Na pasku bocznym po lewej stronie kliknij Dane logowania. Może być konieczne kliknięcie strzałkę w lewo w lewym górnym rogu.
   5. Aby skonfigurować konto usługi, wybierz Utwórz dane logowania, a następnie Konto usługi.
   6. Nazwij nowe konto usługi. Jest to także domyślna nazwa użytkownika dla identyfikator konta usługi. Zapisz identyfikator konta usługi wraz z częścią po znaku „@” do późniejszego użycia. Kliknij Utwórz, a potem przejdź dalej. wybierz opcjonalne kroki przyznawania dostępu projektowi i użytkownikom, a następnie kliknij Gotowe.
   7. Nastąpi przekierowanie na stronę Konta usługi, na której Twoja nowa usługa będzie dostępna dostęp do konta Google.

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

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

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

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

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

7. 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"
   }
   

8. Dodaj nowe konto usługi jako użytkownika do konta Merchant Center. Jeśli jesteś deweloperem zewnętrznym, musisz poprosić swojego klienta o wykonanie tego kroku dla Ciebie.

   1. Otwórz konto Merchant Center.
   2. W ustawieniach konta Merchant Center wybierz Osoby i .

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

      Uwaga: jeśli nie zanotowałeś wcześniej identyfikatora konta usługi, otwórz administrowanie kontami usługi i i wybierz utworzony przez siebie projekt.

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

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

   6. Powtórz te czynności dla wszystkich innych kont usługi, które chcesz dodać.

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

10. Jeśli repozytorium zostało przez Ciebie pobrane i rozpakowane, zamiast klonować, zmień jego nazwę rozpakowany katalog do googleads-shopping-samples.

11. Aby zainstalować wymagane przykładowe zależności, w oknie terminala Przejdź do googleads-shopping-samples/python/ i wpisz:

    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.