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 :
GOOGLE_APPLICATION_CREDENTIALS
.- Identifiants utilisateur configurés via la Google Cloud CLI (gcloud CLI).
- 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
.