Instalowanie biblioteki klienta Pythona
Aby zainstalować bibliotekę klienta Pythona w środowisku lokalnym:
- Wyodrębnij plik tarball z biblioteki klienta języka Python.
W tym samym katalogu uruchom to polecenie:
python -m pip install .
Aby dokończyć instalację, postępuj zgodnie z instrukcjami wyświetlanymi w terminalu.
Konfiguracja w pliku YAML
Podczas inicjowania klienta możesz podać plik YAML zawierający niezbędne informacje uwierzytelniające potrzebne do wysyłania żądań. Do tego pliku uzyskuje się dostęp podczas inicjowania klienta za pomocą metody load_from_file
.
Podczas tworzenia pliku YAML postępuj zgodnie z przykładem podanym poniżej, aby określić token odświeżania, identyfikator klienta i tajny klucz klienta.
Aby określić lokalizację pliku search-ads-360.yaml
, możesz przekazać ścieżkę jako ciąg znaków do metody podczas jej wywołania:
from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file("path/to/search-ads-360.yaml")
Jeśli nie podasz ścieżki, biblioteka będzie szukać pliku w katalogu $HOME
:
from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file()
Pola konfiguracji
Konfiguracja biblioteki klienta obsługuje te pola.
Pola ogólne:
refresh_token
: Twój 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 w przypadku procesów aplikacji na komputery i aplikacji internetowych
Jeśli używasz ścieżki aplikacji na komputerach lub w przeglądarce, obsługiwane są te klucze:
# 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