Method: vitals.errors.reports.search

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

Requête HTTP

GET https://playdeveloperreporting.googleapis.com/v1beta1/{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/heure de recherche des rapports d'erreur. Le début et la fin doivent être alignés sur les heures et utiliser UTC comme fuseau horaire (ou être vide, auquel cas UTC sera également utilisé).

Si cette valeur est définie, seuls les rapports d'erreur survenus pendant l'intervalle sont 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, un maximum de 50 rapports sera renvoyé. La valeur maximale est 100. Les valeurs supérieures à 100 sont forcées à 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 ne récupérer qu'un sous-ensemble des rapports.

Pour connaître les principes de base du filtrage, consultez AIP-160.

** Noms de champs acceptés:**

  • apiLevel: ne établit une correspondance que pour les rapports d'erreur qui se sont produits dans les versions d'Android demandées (spécifiées en tant que niveau d'API numérique). Exemple : apiLevel = 28 OR apiLevel = 29.
  • versionCode: établit une correspondance avec les rapports d'erreur qui ne concernent que les codes de version d'application demandés. Exemple : versionCode = 123 OR versionCode = 456.
  • deviceModel: établit une correspondance avec les erreurs survenues sur les appareils demandés. Exemple: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: établit une correspondance avec les erreurs survenues dans les marques d'appareils demandées. Exemple: `deviceBrand = "Google".
  • deviceType: établit une correspondance avec les rapports d'erreur enregistrés dans les types d'appareils demandés. Exemple : deviceType = "PHONE".
  • errorIssueType: établit une correspondance avec les rapports d'erreurs des types demandés uniquement. Candidats valides: JAVA_CRASH, NATIVE_CRASH, ANR. Exemple : errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH.
  • errorIssueId: établit une correspondance uniquement avec les rapports d'erreurs appartenant aux ID de problèmes d'erreur demandés. Exemple : errorIssueId = 1234 OR errorIssueId = 4567.
  • appProcessState: établit une correspondance entre les rapports d'erreur sur l'état de 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: établit une correspondance avec les rapports d'erreur repérés par l'utilisateur. Il n'est accompagné d'aucun opérateur. Exemple : isUserPerceived.

** Opérateurs compatibles:**

  • Opérateurs de comparaison: le seul opérateur de comparaison accepté est l'égalité. Le champ filtré doit apparaître sur le côté gauche de la comparaison.
  • Opérateurs logiques: les opérateurs logiques AND et OR peuvent être utilisés pour créer des filtres complexes selon une forme normale conjonctive (CNF), par exemple conjonctions de disjonctions. L'opérateur OR prévaut sur AND. L'utilisation de parenthèses n'est donc pas nécessaire lors de la compilation de CNF.

L'opérateur OR n'est pris en charge que pour créer des 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 détectés.

nextPageToken

string

Jeton de page permettant de récupérer 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 la présentation d'OAuth 2.0.