Cette page a été traduite par l'API Cloud Translation.

Erreurs et avertissements

Cette page décrit les différents types d'erreurs et d'avertissements que vous pouvez rencontrer lors de l'utilisation de l'API Display & Video 360.

Erreurs liées à l'API

Les requêtes adressées à l'API qui ne peuvent pas être finalisées renvoient un message d'erreur. Les requêtes renvoyant des erreurs sont comptabilisées dans le quota des utilisateurs et seront prises en compte lors de l'examen des demandes de quota supplémentaire. Les réponses d'erreur doivent être traitées et gérées pour éviter des erreurs futures.

Une réponse d'erreur prend le format suivant et inclut un code de réponse HTTP, un message d'erreur et un état de code RPC Google:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

Vous trouverez ci-dessous une liste des erreurs d'API courantes, ainsi que les mesures recommandées à prendre si elles sont renvoyées:

Code	RPC	Action recommandée
`400`	`INVALID_ARGUMENT`	Votre demande présente un problème. Examinez le champ du message dans la réponse d'erreur et modifiez votre requête en conséquence.
`401`	`UNAUTHENTICATED`	Impossible d'authentifier votre requête correctement. Vérifiez que vous incluez des identifiants OAuth valides dans votre requête. Pour en savoir plus, consultez notre guide de démarrage.
`403`	`PERMISSION_DENIED`	Vous ne disposez pas des autorisations nécessaires pour traiter votre demande. Vérifiez que votre compte utilisateur dispose des autorisations appropriées pour le partenaire ou l'annonceur concerné.
`404`	`NOT_FOUND`	La ressource que vous essayez de récupérer est introuvable. Vérifiez que l'ID que vous utilisez est correct et que le type de ressource est en cours de récupération.
`409`	`ABORTED`	La ressource que vous essayez de modifier a été modifiée ailleurs. Attendez quelques secondes, puis relancez la requête.
`429`	`RESOURCE_EXHAUSTED`	Vous avez dépassé votre limite de débit ou votre quota de requêtes quotidien. Examinez votre utilisation de l'API à l'aide de la console Google APIs, puis modifiez votre workflow pour respecter les limites de quota existantes. Pour en savoir plus, consultez notre page sur l'optimisation des quotas. Si vos opérations ne peuvent pas être effectuées dans les limites de votre quota quotidien, vous pouvez demander un quota supplémentaire.
`500`	`INTERNAL`	L'API a rencontré une erreur interne. Attendez quelques secondes, puis relancez la requête. Si l'erreur persiste, contactez l'assistance.
`504`	`DEADLINE_EXCEEDED`	L'API a mis trop de temps à traiter la requête. Patientez quelques secondes, puis relancez la requête. Si l'erreur persiste, contactez l'assistance.

Erreurs SDF

L'API Display & Video 360 utilise une méthode asynchrone pour générer et télécharger des fichiers de données structurées. C'est pourquoi les erreurs générées lors de la génération de fichiers SDF sont renvoyées dans la tâche de téléchargement terminée. Une tâche de téléchargement de fichiers SDF se terminant dans error est marquée comme terminée, mais elle comporte un champ d'erreur renseigné au lieu d'un nom de ressource multimédia dans le champ response, comme illustré dans cet exemple tronqué:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

Si un message d'erreur exploitable s'affiche lorsque vous tentez de générer des fichiers SDF, suivez-le en conséquence. Si le message d'erreur n'est pas clairement exploitables, nous vous recommandons de prendre les mesures suivantes:

Vérifiez que l'utilisateur dispose des autorisations appropriées pour les ressources parentes du partenaire ou de l'annonceur.
Vérifiez que les ID fournis dans le filtre sont exacts, correspondent au type de ressource prévu et se trouvent dans le contexte de l'ID racine donné.
Assurez-vous de ne pas dépasser la limite de 20 tâches simultanées de téléchargement de fichiers SDF par utilisateur.

Si le problème persiste, contactez l'assistance pour lui signaler le problème.

Avertissements non bloquants

Des avertissements non bloquants sont attribués aux éléments de campagne pour signaler un problème susceptible d'affecter la diffusion d'un élément de campagne. Des avertissements similaires sont communiqués dans l'interface utilisateur via une bannière de notification. Ces avertissements sont passifs et sont répertoriés dans le champ warningMessages d'un élément de campagne.

Bien que passifs, les problèmes qui provoquent ces avertissements peuvent avoir une incidence sur la diffusion d'un élément de campagne au point de l'empêcher complètement.

Prévention

En configurant correctement les paramètres des éléments de campagne, vous pouvez éviter de nombreux problèmes entraînant des avertissements non bloquants. Par exemple:

Période de diffusion: si la période de diffusion d'un élément de campagne n'est pas valide, ou si celle de l'ordre d'insertion parent a expiré, l'élément de campagne génère un avertissement et n'est pas diffusé. Pour éviter ce dernier problème, assurez-vous que la période de diffusion d'un élément de campagne ne se termine pas après celle de l'ordre d'insertion parent.
Créations attribuées: si aucune création valide n'est attribuée à un élément de campagne, celui-ci génère un avertissement et n'est pas diffusé.
Ciblage: si le ciblage d'un élément de campagne n'est pas correctement attribué, celui-ci peut générer un avertissement, et la diffusion peut être affectée ou bloquée du tout.

Si vous dupliquez des configurations à partir d'un élément de campagne existant, assurez-vous que celui-ci ne génère pas d'avertissements imprévus.

Monitoring

Des problèmes entraînant des avertissements non bloquants peuvent survenir pendant la diffusion d'un élément de campagne. Pour vous assurer que vos éléments de campagne sont correctement diffusés, surveillez la présence de nouveaux avertissements dans vos éléments de campagne actifs. Les articles peuvent être récupérés de manière groupée à l'aide de la fonction advertisers.lineItems.list. Si un élément de campagne génère un avertissement inattendu, vous devez résoudre le problème immédiatement pour réduire l'impact sur la diffusion.

Des problèmes peuvent survenir même si les paramètres ou le ciblage d'un élément de campagne n'ont pas changé. Il peut s'agir, par exemple, de la mise en veille ou de l'expiration de l'ordre d'insertion parent, ou de l'abandon de listes d'utilisateurs ou d'autres types de ciblage.