Instalowanie biblioteki klienta w Pythonie
Aby zainstalować bibliotekę klienta Python w środowisku lokalnym:
- Wyodrębnij plik tar biblioteki klienta Pythona.
Uruchom to polecenie w tym samym katalogu:
python -m pip install .
Aby dokończyć instalację, postępuj zgodnie z instrukcjami wyświetlanymi w terminalu.
Konfiguracja przy użyciu pliku YAML
Możesz określić plik YAML do inicjowania klienta, który zawiera niezbędne informacje uwierzytelniające potrzebne do wysyłania żądań. Dostęp do tego pliku jest możliwy po inicjowaniu klienta za pomocą metody load_from_file
.
Podczas tworzenia pliku YAML skorzystaj z przykładu podanego 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 podczas wywoływania metody przekazać ścieżkę jako ciąg znaków do metody:
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 poniższe pola.
Pola ogólne:
refresh_token
: Twój token odświeżania OAuth.client_id
: Twój identyfikator klienta OAuth.client_secret
: Twój tajny klucz klienta OAuth.login_customer_id
: zapoznaj się z dokumentacją dotyczącą identyfikatora klienta loginu.
Obsługiwane klucze przepływów aplikacji na komputer i w aplikacjach internetowych
Jeśli korzystasz z przepływu aplikacji komputerowej lub internetowej, obsługiwane klucze to:
# 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