Python

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:

  1. zmiennej środowiskowej GOOGLE_APPLICATION_CREDENTIALS.
  2. Dane logowania użytkownika skonfigurowane w Google Cloud CLI (gcloud CLI).
  3. 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.