Réponses d'erreur

Lorsqu'une requête API aboutit, l'API renvoie un code d'état 200 OK ainsi que les données demandées dans le corps de la réponse. Si une erreur se produit, l'API renvoie l'un des codes d'erreur canoniques définis par les API Google, mappé à un code d'état HTTP, ainsi qu'un corps de réponse contenant des informations sur l'erreur. En cas d'erreur, examinez les champs message et status dans le corps de la réponse JSON pour obtenir des détails spécifiques qui vous aideront à résoudre le problème.

Format d'erreur

Si une requête génère une erreur, l'API renvoie un code d'état HTTP approprié et un corps de réponse JSON. La réponse d'erreur contient un objet error avec la structure suivante :

{
  "error": {
    "code": 403,
    "message": "User does not have sufficient permissions for this property.",
    "status": "PERMISSION_DENIED"
  }
}

L'objet error contient les champs suivants :

Champ Description
code Code d'état HTTP, tel que 400, 401, 403, 429 ou 500.
message Description courte de l'erreur.
état Code d'erreur canonique, tel que INVALID_ARGUMENT, UNAUTHENTICATED, PERMISSION_DENIED, RESOURCE_EXHAUSTED ou INTERNAL.

Erreurs fréquentes

Le tableau suivant répertorie les erreurs courantes renvoyées par l'API.

HTTP Status Code Code canonique Motif Description
400 INVALID_ARGUMENT Requête incorrecte La requête est incorrecte. Cela peut être dû à des paramètres manquants ou non valides, comme une plage de dates incorrecte ou un filtre au format incorrect.
401 UNAUTHENTICATED Identifiants non valides La requête ne dispose pas d'identifiants d'authentification valides pour la ressource cible. Cela peut se produire si le jeton d'accès OAuth 2.0 est manquant, non valide ou expiré. Suivez les instructions de la section S'authentifier avec OAuth 2.0 pour obtenir un jeton valide.
403 PERMISSION_DENIED Autorisations insuffisantes L'utilisateur authentifié n'a pas accès à la propriété Google Analytics demandée.
429 RESOURCE_EXHAUSTED Quota dépassé La requête a été refusée, car les limites de quota de l'API ont été atteintes. Pour en savoir plus, consultez Limites et quotas de l'API Data. Vous dépassez peut-être les limites par projet ou par propriété.
500 INTERNAL Erreur de serveur interne Une erreur inattendue du serveur s'est produite. Il s'agit généralement d'un problème temporaire. Il est recommandé de relancer la requête avec un intervalle exponentiel entre les tentatives. Pour éviter de dépasser les quotas d'erreurs du serveur, il est important d'implémenter un intervalle exponentiel entre les tentatives avec des limites de nouvelles tentatives.
503 UNAVAILABLE Service indisponible Le service est momentanément indisponible. Il s'agit généralement d'un problème temporaire. Il est recommandé de relancer la requête avec un intervalle exponentiel entre les tentatives. Pour éviter de dépasser les quotas d'erreurs du serveur, il est important d'implémenter un intervalle exponentiel entre les tentatives avec des limites de nouvelles tentatives.