Erreurs et avertissements

L'API Display & Video 360 peut renvoyer un certain nombre d'erreurs et d'avertissements. Une solution d'API saine doit gérer ces erreurs.

Erreurs d'API

Les requêtes adressées à l'API qui n'effectuent pas l'action prévue renvoient une erreur. Les réponses d'erreur doivent être détectées et traitées.

Une réponse d'erreur de l'API comporte un code de réponse HTTP, un message d'erreur et un état Google RPC code. Son format est le suivant :

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

Voici une liste des erreurs d'API courantes et des actions recommandées :

Codes d'erreur
`400`	`INVALID_ARGUMENT` Un problème est survenu concernant votre demande. Consultez le champ de message dans la réponse d'erreur et mettez à jour votre demande en conséquence.
`401`	`UNAUTHENTICATED` Votre demande n'a pas pu être authentifiée correctement. Vérifiez que vous incluez des identifiants OAuth valides dans votre requête. Pour en savoir plus, consultez notre guide de démarrage rapide.
`403`	`PERMISSION_DENIED` Vous ne disposez pas des autorisations nécessaires pour effectuer cette demande. Vérifiez que votre compte utilisateur dispose des autorisations appropriées pour le partenaire ou l'annonceur concerné.
`404`	`NOT_FOUND` Impossible de trouver la ressource que vous essayez de récupérer. Vérifiez que l'ID que vous utilisez est correct et qu'il correspond au type de ressource récupéré.
`409`	`ABORTED` La ressource que vous essayez de modifier est en cours de modification ailleurs. Patientez quelques secondes, puis réessayez d'envoyer la demande.
`429`	`RESOURCE_EXHAUSTED` Vous avez dépassé votre limite de fréquence ou votre quota de requêtes quotidiennes. Utilisez la console Google Cloud pour examiner votre utilisation de l'API. Mettez à jour votre workflow pour qu'il s'exécute dans les limites de quota existantes. Pour en savoir plus, consultez notre guide sur l'optimisation de l'utilisation.
`500`	`INTERNAL` Une erreur interne s'est produite au niveau de l'API. Patientez quelques secondes, puis réessayez d'envoyer la demande. Si l'erreur persiste, contactez l'assistance.
`504`	`DEADLINE_EXCEEDED` L'API a mis trop de temps à traiter la demande. Patientez quelques secondes, puis réessayez d'envoyer la demande. Si l'erreur persiste, contactez l'assistance.

Erreurs SDF

L'API Display & Video 360 utilise des tâches de longue durée pour produire des fichiers de données structurées (SDF). Les erreurs de création des fichiers SDF sont renvoyées dans le operation terminé. Le champ error contient les détails. Voici un exemple tronqué :

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

Si le message d'erreur n'est pas clair, nous vous recommandons de procéder comme suit :

Vérifiez que votre utilisateur dispose au moins du rôle utilisateur Standard pour le partenaire ou l'annonceur parent.
Vérifiez que les ID fournis dans le filtre sont exacts. Les ID doivent correspondre au type de ressource prévu et être des ressources enfants de l'ID racine.
Assurez-vous que votre utilisateur a moins de 20 tâches de téléchargement SDF simultanées.

Si des erreurs persistent, contactez l'assistance.

Avertissements non bloquants

Les avertissements non bloquants indiquent un problème susceptible d'avoir un impact sur la diffusion des annonces d'un élément de campagne. Des avertissements similaires s'affichent dans l'UI. Ces avertissements sont passifs et répertoriés dans l'élément de campagne.

La cause première d'un avertissement peut avoir une incidence sur la diffusion d'un élément de campagne. Dans certains cas, cela peut même empêcher complètement la diffusion des annonces.

Prévention

Certains avertissements non bloquants sont dus à une mauvaise configuration d'un élément de campagne :

Période de diffusion : un élément de campagne ne diffusera pas d'annonces si sa période de diffusion n'est pas valide ou si la période de diffusion de son ordre d'insertion a expiré. Assurez-vous qu'un élément de campagne a une période de diffusion qui correspond à celle de son ordre d'insertion.
Créations attribuées : un élément de campagne ne peut pas être diffusé si aucune création valide ne lui est attribuée.
Ciblage : la diffusion d'un élément de campagne peut être affectée ou même empêchée si son ciblage n'est pas correctement attribué.

Avant d'utiliser les configurations d'un élément de campagne existant dans un nouvel élément de campagne, assurez-vous qu'il ne génère aucun avertissement.

Surveillance

Des avertissements non bloquants peuvent s'afficher pendant la diffusion d'un élément de campagne. Surveillez vos éléments de campagne actifs pour détecter de nouveaux avertissements et vous assurer qu'ils sont diffusés correctement. Récupérez les éléments de campagne de manière groupée à l'aide d'une requête list. Si un élément de campagne renvoie un avertissement inattendu, résolvez le problème dès que possible pour réduire l'impact sur la diffusion.

Des avertissements peuvent être ajoutés même si les paramètres ou le ciblage n'ont pas changé. Voici quelques exemples :

L'ordre d'insertion est mis en veille ou expire.
Une liste d'utilisateurs ou une option de ciblage est obsolète.