Method: vitals.errors.issues.search

Recherche tous les problèmes d'erreur dans lesquels les rapports ont été regroupés.

Requête HTTP

GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/errorIssues:search

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Ressource parente des problèmes d'erreur, 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 problèmes 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 ce champ est défini, seules les erreurs associées à des rapports d'erreur survenues au cours de l'intervalle seront renvoyées. 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 problèmes d'erreur à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur.

Si aucune valeur n'est spécifiée, la recherche affiche 50 problèmes au maximum. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

pageToken

string

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

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

filter

string

Prédicat de sélection permettant de n'extraire qu'un sous-ensemble de problèmes. Les nombres dans les problèmes d'erreur renvoyés ne reflètent que les occurrences correspondant au filtre.

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

** Noms de champs acceptés :**

  • apiLevel : correspond aux problèmes d'erreur survenus uniquement 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 problèmes d'erreur survenus 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 problèmes d'erreur survenus dans les types d'appareils demandés. Exemple : deviceType = "PHONE".
  • errorIssueType : ne correspond qu'aux problèmes d'erreur des types demandés. Candidats valides : CRASH, ANR, NON_FATAL. Exemple : errorIssueType = CRASH OR errorIssueType = ANR.
  • appProcessState : établit une correspondance avec les problèmes d'erreur liés à l'état du processus d'une application, en 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 problèmes d'erreur perçus par l'utilisateur. 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 errorIssueType = ANR n'est pas un filtre 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)

orderBy

string

Spécifie un champ qui sera utilisé pour trier les résultats.

** Dimensions acceptées :**

  • errorReportCount : problèmes de commandes par nombre de rapports d'erreur.
  • distinctUsers : classe les problèmes de commandes par nombre d'utilisateurs uniques concernés.

** Opérations compatibles :**

  • asc pour l'ordre croissant.
  • desc pour l'ordre décroissant.

Format : un champ et une opération, par exemple errorReportCount desc

Remarque : Actuellement, un seul champ est accepté à la fois.

sampleErrorReportLimit

integer

Facultatif. Nombre d'exemples de rapports d'erreur à renvoyer par ErrorIssue. Si aucune valeur n'est spécifiée, la valeur 0 sera utilisée. Remarque : Seuls les nombres 0 et 1 sont actuellement acceptés.

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 des problèmes correspondant à la requête.

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

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

object (ErrorIssue)

ErreurProblèmes détectés.

nextPageToken

string

Jeton de continuation permettant d'extraire la page de données 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.