Instalowanie biblioteki klienta w języku Python
Aby zainstalować bibliotekę klienta Pythona w środowisku lokalnym:
- Wyodrębnij plik tarball z biblioteki klienta języka Python.
Uruchom to polecenie w tym samym katalogu:
python -m pip install .Postępuj zgodnie z instrukcjami wyświetlanymi w terminalu, aby dokończyć instalację.
Konfiguracja w pliku YAML
Możesz określić plik YAML, który będzie używany do inicjowania klienta, zawierający niezbędne informacje uwierzytelniające potrzebne do wysyłania żądań. Dostęp do tego pliku jest możliwy, gdy klient zostanie zainicjowany przy użyciu metody load_from_file.
Podczas tworzenia pliku YAML skorzystaj z przykładu poniżej, aby określić token odświeżania, identyfikator klienta i tajny klucz klienta.
Aby określić lokalizację, w której znajduje się plik search-ads-360.yaml, możesz przekazać do metody ścieżkę w postaci ciągu znaków przy jej wywoływaniu:
from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file("path/to/search-ads-360.yaml")
Jeśli nie podasz ścieżki, biblioteka szuka pliku w katalogu $HOME:
from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file()
Pola konfiguracji
Konfiguracja biblioteki klienta obsługuje poniższe pola.
Pola ogólne:
refresh_token: token odświeżania OAuth.client_id: identyfikator klienta OAuth.client_secret: tajny klucz klienta OAuth.login_customer_id: zapoznaj się z dokumentacją login-customer-id.
Obsługiwane klucze do procesów w aplikacjach komputerowych i internetowych
Jeśli używasz aplikacji na komputerze lub stronie internetowej, obsługiwane klucze są następujące:
# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_id: INSERT_CLIENT_ID_HERE
# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_secret: INSERT_CLIENT_SECRET_HERE
# Renewable OAuth credential associated with 1 or more Search Ads accounts.
refresh_token: INSERT_REFRESH_TOKEN_HERE
# Required for manager accounts only: Specify the login customer ID used to
# authenticate API calls. This will be the customer ID of the authenticated
# manager account. You can also specify this later in code if your application
# uses multiple manager account + OAuth pairs.
#
# login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE