Python

Google fournit une bibliothèque cliente Python pour interagir avec l'API Ad Manager. Nous vous recommandons d'utiliser la bibliothèque cliente avec PyPI.

Pour commencer, créez un projet dans l'IDE de votre choix ou ajoutez le à un projet existant. Google publie les artefacts des bibliothèques clientes PyPI en tant que google-ads-admanager.

pip install google-ads-admanager

Configurer les identifiants

La bibliothèque cliente Python utilise OAuth2 et les identifiants par défaut de l'application. (ADC) pour s'authentifier.

L'ADC recherche les identifiants dans l'ordre suivant :

  1. GOOGLE_APPLICATION_CREDENTIALS.
  2. Identifiants utilisateur configurés via la Google Cloud CLI (gcloud CLI).
  3. Lors de l'exécution sur Google Cloud, le compte de service associé à la ressource Google Cloud

Pour créer et configurer vos identifiants ADC, consultez Authentification.

Faites votre première demande

Chaque service possède un objet ServiceClient avec des valeurs synchrones et asynchrones pour chaque méthode REST. L'exemple suivant indique un objet Network de manière synchrone.

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)

Pour obtenir des exemples d'autres méthodes et ressources, consultez le dépôt GitHub googleapis/google-cloud-python

Gérer les erreurs

Toutes les erreurs d'API étendent la classe de base GoogleAPIError.

Le champ "Motif de l'erreur" identifie les types d'erreurs de manière unique. Utilisez ce champ pour déterminer comment gérer l'erreur.

try:
  network = client.get_network(request=request)
  print(network)
except GoogleAPIError as e:
  # Handle error
  print(e.reason)

Les erreurs de l'API Ad Manager incluent également un requestId unique que vous pouvez fournir à l'assistance pour obtenir de l'aide le dépannage. L'exemple suivant extrait les requestId à partir d'un 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'])

Configurer les paramètres de proxy

La bibliothèque cliente Python respecte les paramètres de variable d'environnement http_proxy et https_proxy.