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. En cas d'erreur, l'API renvoie l'un des codes d'erreur canoniques définis par les API Google, mappé à un code d'état HTTP, et 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 informations spécifiques qui vous aideront à déboguer.

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 mal formée. Cela peut être dû à des paramètres manquants ou non valides, tels qu'une plage de dates incorrecte ou un filtre mal formé.
401 UNAUTHENTICATED Identifiants incorrects 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 la section Limites et quotas de l'API de données. Il est possible que vous dépassiez 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 réessayer la requête avec un intervalle exponentiel entre les tentatives. Pour éviter de dépasser les quotas d'erreurs de 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 réessayer la requête avec un intervalle exponentiel entre les tentatives. Pour éviter de dépasser les quotas d'erreurs de serveur, il est important d'implémenter un intervalle exponentiel entre les tentatives avec des limites de nouvelles tentatives.