Display & La version 2 de l'API Video 360 s'arrêtera le 3 septembre 2024. Migrez vers la version 3 avant cette date pour éviter une interruption de service.

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

Erreurs et avertissements

Cette page présente les différents types d'erreurs et d'avertissements lors de l'utilisation de l'écran l'API Video 360.

Erreurs d'API

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

Une réponse d'erreur prend le format suivant et inclut un code de réponse HTTP, un message d'erreur et un état associé au 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 actions recommandées à effectuer. si elles sont renvoyées:

Code	RPC	Action recommandée
`400`	`INVALID_ARGUMENT`	Votre demande pose problème. Consultez les "message" dans la réponse d'erreur et modifiez votre demande en conséquence.
`401`	`UNAUTHENTICATED`	Votre demande n'a pas pu être authentifiée correctement. Vérifiez que vous incluez un protocole OAuth valide 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 effectuer cette opération votre demande. Vérifiez que votre compte utilisateur a les autorisations appropriées pour le partenaire annonceur.
`404`	`NOT_FOUND`	La ressource que vous tentez de récupérer ne peut pas peuvent être trouvées. Vérifiez que la pièce d'identité que vous utilisez est correct et pour le type de ressource récupéré.
`409`	`ABORTED`	La ressource que vous tentez de modifier modifié ailleurs. Patientez quelques secondes, puis relancer la requête.
`429`	`RESOURCE_EXHAUSTED`	Vous avez dépassé votre limite de débit ou quota de requêtes quotidien. Examinez votre utilisation de l'API à l'aide du console Google APIs et modifier votre pour utiliser le quota existant des limites. Pour en savoir plus, consultez notre page sur l'optimisation des quotas. Si vos opérations ne peuvent pas être effectuées dans les un quota quotidien donné, vous pouvez demander un quota supplémentaire.
`500`	`INTERNAL`	L'API a rencontré une erreur interne. Veuillez patienter. secondes, puis relancez la requête. Si l'erreur le problème persiste, contactez l'assistance.
`504`	`DEADLINE_EXCEEDED`	Le traitement de la requête par l'API a pris trop de temps. Patientez quelques secondes, puis relancez la requête. Si l'erreur persiste, contactez l'assistance.

Erreurs SDF

L'écran et L'API Video 360 utilise une méthode asynchrone pour Générer et télécharger des fichiers de données structurées Pour cette les erreurs générées lors de la génération du fichier de données structurées sont renvoyées dans le fichier de téléchargement. Une tâche de téléchargement de fichiers SDF se terminant dans error est Marqué comme terminé, mais avec un champ d'erreur renseigné au lieu d'un nom de ressource multimédia dans le champ response, comme 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 s'affiche lorsque vous essayez de générer des fichiers SDF, doit le suivre en conséquence. Si le message d'erreur n'est pas clairement exploitables, recommandent les actions suivantes:

Vérifier que votre utilisateur dispose des autorisations appropriées pour le parent les ressources pour les partenaires ou les annonceurs.
Vérifiez que les ID fournis dans le filtre filter sont corrects. correspondent au type de ressource souhaité et s'inscrivent dans le contexte un ID racine donné.
Assurez-vous de ne pas dépasser la limite de 20 téléchargements de fichiers SDF simultanés de tâches par utilisateur.

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

Avertissements non bloquants

Les avertissements non bloquants sont attribués aux éléments de campagne pour indiquer pouvant avoir une incidence sur la diffusion d'un élément de campagne. Des avertissements similaires sont transmis dans l'UI par le biais d'une bannière de notification. Ces avertissements sont passifs dans le champ warningMessages d'un élément de campagne.

Bien qu'ils soient passifs, les problèmes à l'origine de ces avertissements peuvent avoir une incidence sur la diffusion au point de l'empêcher complètement.

Prévention

De nombreux problèmes qui provoquent des avertissements non bloquants peuvent être évités en configuration des paramètres de l'élément de campagne, dont les suivants:

Période de diffusion: si la période de diffusion d'un élément de campagne n'est pas valide ou si la que la période de diffusion de l'ordre d'insertion parent a expiré, l'élément de campagne génère une et ne s'affichera pas. Pour éviter ce dernier problème, assurez-vous qu'une ligne La période de diffusion de l'élément ne prend pas fin après celle de son insertion parente. commande.
Créations attribuées: s'il n'existe aucune création valide. est attribué à un élément de campagne, celui-ci génère un avertissement sont diffusées.
Ciblage: si le ciblage d'un élément de campagne n'est pas est attribué correctement, l'élément de campagne peut générer un avertissement et la diffusion impactés, voire évités complètement.

Si vous dupliquez des configurations à partir d'un élément de campagne existant, assurez-vous que l'élément de campagne existant ne génère aucun avertissement imprévu.

Surveillance

Des problèmes entraînant des avertissements non bloquants peuvent survenir lorsqu'un élément de campagne période de diffusion. Pour vous assurer que vos éléments de campagne sont diffusés correctement, surveillez vos lignes de commande actives pour détecter les nouveaux avertissements. Les éléments de campagne 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 en 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, l'abandon des listes d'utilisateurs ou d'autres méthodes de ciblage.