À partir du 8 septembre 2025, chaque nouvelle ligne devra indiquer si elle diffusera ou non des annonces à caractère politique dans l'Union européenne (UE). Les importations de fichiers SDF et les appels à l'API Display & Video 360 qui ne fournissent pas de déclarations échoueront. Pour savoir comment mettre à jour votre intégration afin d'effectuer cette déclaration, consultez notre page sur les abandons de compatibilité.

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 lorsque vous utilisez l'API Display & Video 360.

Erreurs de l'API

Les requêtes envoyées à l'API qui ne peuvent pas être traitées renvoient un message d'erreur. Les requêtes renvoyant des erreurs sont décomptées du quota utilisateur et seront prises en compte lors de l'examen des demandes de quota supplémentaires. Les réponses d'erreur doivent être traitées et gérées pour éviter les erreurs futures.

Une réponse d'erreur se présente sous 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 d'erreurs API courantes, ainsi que l'action recommandée à effectuer si elles sont renvoyées:

Code	RPC	Action recommandée
`400`	`INVALID_ARGUMENT`	Un problème est survenu concernant votre demande. Examinez le champ de message dans la réponse d'erreur et modifiez votre requête en conséquence.
`401`	`UNAUTHENTICATED`	Votre demande n'a pas pu être correctement authentifiée. 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 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.
`429`	`RESOURCE_EXHAUSTED`	Vous avez dépassé votre limite de débit ou votre quota de requêtes quotidien. Examinez votre utilisation des API à l'aide de la console Google API et modifiez votre workflow pour qu'il respecte les limites de quota existantes. Pour en savoir plus, consultez notre page sur l'optimisation des quotas.
`500`	`INTERNAL`	L'API a rencontré une erreur interne. Patientez quelques secondes, puis réessayez. 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 réessayez. 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 (SDF). Pour cette raison, les erreurs générées lors de la génération de SDF sont renvoyées dans la tâche de téléchargement de SDF terminée. Une tâche de téléchargement SDF se terminant par error est marquée comme terminée, mais 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 vous recevez un message d'erreur exploitable lorsque vous essayez de générer des fichiers SDF, vous devez le suivre en conséquence. Si le message d'erreur ne permet pas de prendre une action claire, nous vous recommandons de procéder comme suit:

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

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

Avertissements non bloquants

Des avertissements non bloquants sont attribués aux éléments de campagne pour indiquer un problème pouvant avoir une incidence sur leur diffusion. Des avertissements similaires sont communiqués dans l'UI 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 à l'origine de ces avertissements peuvent avoir un impact sur la diffusion d'un élément de campagne au point de l'empêcher complètement.

Prévention

De nombreux problèmes qui génèrent des avertissements non bloquants peuvent être évités en configurant correctement les paramètres des lignes, y compris les suivants:

Période de diffusion: si la période de diffusion d'un élément de campagne est non valide ou si la période de diffusion de l'ordre d'insertion parent est expirée, 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 plus tard que celle de son 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 ne diffuse pas de contenu.
Ciblage: si le ciblage d'un élément de campagne n'est pas correctement attribué, il peut générer un avertissement, et la diffusion peut être affectée ou complètement empêchée.

Si vous répliquez des configurations à partir d'un élément de campagne existant, assurez-vous qu'il ne génère pas d'avertissements inattendus.

Surveillance

Des problèmes pouvant entraîner des avertissements non bloquants peuvent survenir lorsqu'un élément de campagne est en cours d'exécution. Pour vous assurer que vos éléments de campagne sont diffusés correctement, surveillez les nouveaux avertissements générés pour vos éléments de campagne actifs. Vous pouvez récupérer les lignes 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 des listes d'utilisateurs ou d'autres types de ciblage.