Google udostępnia bibliotekę klienta w języku Python umożliwiający interakcję z interfejsem API Ad Managera. Zalecamy używanie biblioteki klienta z PyPI.
Na początek utwórz nowy projekt w wybranym IDE lub dodaj
do istniejącego projektu. Google publikuje artefakty biblioteki klienta w
PyPI jako google-ads-admanager
.
pip install google-ads-admanager
Skonfiguruj dane logowania
Biblioteka klienta Pythona używa do uwierzytelniania protokołu OAuth 2 i domyślnych danych logowania aplikacji (ADC).
ADC wyszukuje dane logowania w tych miejscach:
- zmiennej środowiskowej
GOOGLE_APPLICATION_CREDENTIALS
. - Dane logowania użytkownika skonfigurowane w Google Cloud CLI (gcloud CLI).
- W przypadku działania w Google Cloud konto usługi jest podłączone do zasobu Google Cloud.
Informacje o tworzeniu i konfigurowaniu danych logowania do ADC znajdziesz w sekcji Uwierzytelnianie.
Prześlij pierwszą prośbę
Każda usługa ma obiekt ServiceClient
zarówno synchroniczny, jak i asynchroniczny
dla każdej metody REST. Ten przykład to Network
synchronicznie.
from google.ads import admanager_v1
def sample_get_network():
# Create a client
client = admanager_v1.NetworkServiceClient()
# Initialize request argument(s)
request = admanager_v1.GetNetworkRequest(
name="name_value",
)
# Make the request
response = client.get_network(request=request)
# Handle the response
print(response)
Przykłady innych metod i zasobów znajdziesz w repozytorium GitHub
googleapis/google-cloud-python
Obsługa błędów
Wszystkie błędy interfejsu API rozszerzają klasę bazową GoogleAPIError
.
Pole przyczyna błędu jednoznacznie identyfikuje typy błędów. Używaj w tym polu w celu określenia sposobu postępowania z błędem.
try:
network = client.get_network(request=request)
print(network)
except GoogleAPIError as e:
# Handle error
print(e.reason)
Błędy interfejsu API Ad Managera obejmują też niepowtarzalny identyfikator requestId
, który możesz
przekaż do zespołu pomocy, aby uzyskać pomoc
w rozwiązywaniu problemów. Ten przykład wyodrębnia
requestId
z: GoogleAPIError
;
except GoogleAPIError as e:
requestInfoType = "type.googleapis.com/google.rpc.RequestInfo"
requestInfo = [detail for detail in e.details if detail['@type'] == requestInfoType][0]
print(requestInfo['requestId'])
Konfigurowanie ustawień serwera proxy
Biblioteka klienta w języku Python przestrzega ustawień zmiennej środowiskowej http_proxy
i https_proxy
.