Method: vitals.errors.issues.search

Effectue une recherche dans toutes les erreurs dans lesquelles 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 erreurs d'erreur, indiquant l'application pour laquelle elles ont été reçues.

Format: apps/{app}

Paramètres de requête

Paramètres
interval

object (DateTimeInterval)

Intervalle de temps pour rechercher les problèmes 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 problèmes liés aux rapports d'erreur associés qui se sont produits 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 d'erreurs à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur.

Si aucune valeur n'est spécifiée, un maximum de 50 problèmes sera renvoyé. La valeur maximale est 1 000. Les valeurs supérieures à 1 000 sont forcées à 1 000.

pageToken

string

Jeton de page, reçu lors 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 qui a fourni le jeton de page.

filter

string

Un prédicat de sélection permettant de ne récupérer qu'un sous-ensemble des problèmes. Le nombre de problèmes renvoyés ne reflète que les occurrences correspondant au filtre.

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

** Noms de champs acceptés:**

  • apiLevel: ne met en correspondance que les problèmes 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 problèmes qui se sont produits uniquement au niveau des codes de version de l'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 erreurs survenues dans les types d'appareils demandés. Exemple : deviceType = "PHONE".
  • errorIssueType: ne met en correspondance que les problèmes des types demandés. Candidats valides: CRASH, ANR. Exemple : errorIssueType = CRASH OR errorIssueType = ANR.
  • appProcessState: établit une correspondance avec les problèmes 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 erreurs repérées 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 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 classer les résultats.

** Dimensions acceptées:**

  • errorReportCount: classe les problèmes en fonction du nombre de rapports d'erreurs.
  • distinctUsers: trie les problèmes en fonction du 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, vous ne pouvez renseigner qu'un seul champ à la fois.

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)

Problèmes détectés.

nextPageToken

string

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