Method: vitals.errors.reports.search
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eSearches all error reports for a specified app based on provided criteria like date/time, Android version, device, or error type.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the app and can include optional filters to narrow down the search.\u003c/p\u003e\n"],["\u003cp\u003eThe response returns a list of error reports matching the query and a token for retrieving additional pages if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This outlines how to search for app error reports using the `errorReports:search` endpoint. The `GET` request requires a `parent` path parameter (app ID) and supports query parameters such as `interval` (date range), `pageSize` (report limit), `pageToken` (pagination), and `filter` (criteria for report subset, examples: apiLevel, versionCode, etc.). The request body must be empty. The response provides a paginated list of `errorReports`, and a `nextPageToken` for subsequent pages. Authorization requires the `playdeveloperreporting` OAuth scope.\n"],null,[]]