Method: vitals.errors.reports.search

Recherche tous les rapports d'erreur reçus pour une application.

Requête HTTP

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{parent=apps/*}/errorReports:search

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Ressource parente des rapports, indiquant l'application pour laquelle ils ont été reçus.

Format : apps/{app}

Paramètres de requête

Paramètres
interval

object (DateTimeInterval)

Intervalle de date et d'heure pour rechercher les rapports d'erreur. Les heures de début et de fin doivent être alignées sur des heures entières et utiliser UTC comme fuseau horaire (ou être vides, auquel cas UTC sera également utilisé).

Si cette valeur est définie, seuls les rapports d'erreur survenus au cours de l'intervalle seront renvoyés. Si aucune valeur n'est spécifiée, l'intervalle par défaut des dernières 24 heures sera utilisé.

pageSize

integer

Nombre maximal de rapports à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur.

Si aucune valeur n'est spécifiée, 50 rapports au maximum sont renvoyés. La valeur maximale est 100. Les valeurs supérieures sont réduites à 100.

pageToken

string

Jeton de page reçu d'un appel reports.search précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à reports.search doivent correspondre à l'appel ayant fourni le jeton de page.

filter

string

Prédicat de sélection permettant de récupérer uniquement un sous-ensemble de rapports.

Pour en savoir plus sur les bases du filtrage, consultez AIP-160.

** Noms de champs acceptés :**

  • apiLevel : ne correspond qu'aux rapports d'erreur qui se sont produits dans les versions d'Android demandées (spécifiées sous forme de niveau d'API numérique). Exemple : apiLevel = 28 OR apiLevel = 29.
  • versionCode : ne correspond qu'aux rapports d'erreur qui se sont produits dans les codes de version d'application demandés. Exemple : versionCode = 123 OR versionCode = 456.
  • deviceModel : correspond aux problèmes d'erreur survenus dans les appareils demandés. Exemple : deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand : correspond aux problèmes d'erreur survenus dans les marques d'appareils demandées. Exemple : `deviceBrand = "Google".
  • deviceType : correspond aux rapports d'erreur qui se sont produits sur les types d'appareils demandés. Exemple : deviceType = "PHONE".
  • errorIssueType : ne correspond qu'aux rapports d'erreur des types demandés. Candidats valides : CRASH, ANR, NON_FATAL. Exemple : errorIssueType = CRASH OR errorIssueType = ANR.
  • errorIssueId : ne correspond qu'aux rapports d'erreur appartenant aux ID de problèmes d'erreur demandés. Exemple : errorIssueId = 1234 OR errorIssueId = 4567.
  • errorReportId : établit une correspondance entre les rapports d'erreur et l'ID de rapport d'erreur demandé. Exemple : errorReportId = 1234 OR errorReportId = 4567.
  • appProcessState : établit une correspondance avec les rapports d'erreur sur l'état du processus d'une application, indiquant si une application s'exécute au premier plan (visible par l'utilisateur) ou en arrière-plan. Candidats valides : FOREGROUND, BACKGROUND. Exemple : appProcessState = FOREGROUND.
  • isUserPerceived : correspond aux rapports d'erreur perçus par les utilisateurs. Il n'est accompagné d'aucun opérateur. Exemple : isUserPerceived.

** Opérateurs compatibles :**

  • Opérateurs de comparaison : seul l'opérateur de comparaison d'égalité est accepté. Le champ filtré doit apparaître à gauche de la comparaison.
  • Opérateurs logiques : les opérateurs logiques AND et OR peuvent être utilisés pour créer des filtres complexes suivant une forme normale conjonctive (CNF), c'est-à-dire conjonctions de disjonctions. L'opérateur OR est prioritaire sur AND. Il n'est donc pas nécessaire d'utiliser des parenthèses lors de la création de la CNF.

L'opérateur OR n'est compatible qu'avec les disjonctions qui s'appliquent au même champ, par exemple : versionCode = 123 OR versionCode = ANR. L'expression de filtre versionCode = 123 OR errorIssueType = ANR n'est pas valide.

** Exemples **

Voici quelques expressions de filtrage valides : * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse avec une liste paginée de rapports d'erreurs correspondant à la requête de recherche.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "errorReports": [
    {
      object (ErrorReport)
    }
  ],
  "nextPageToken": string
}
Champs
errorReports[]

object (ErrorReport)

Rapports d'erreur trouvés.

nextPageToken

string

Jeton de page permettant d'extraire la page de rapports suivante.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/playdeveloperreporting

Pour en savoir plus, consultez OAuth 2.0 Overview.