Method: vitals.errors.reports.search

string

Obbligatorio. Risorsa padre dei report, che indica l'applicazione per cui sono stati ricevuti.

Formato: apps/{app}

object (DateTimeInterval)

Facoltativo. L'intervallo di date e ore in cui cercare i report sugli errori. Sia l'inizio che la fine devono essere allineati all'ora e utilizzare UTC come fuso orario (o essere vuoti, nel qual caso verrà utilizzato anche UTC).

Se impostato, verranno restituiti solo i report sugli errori che si sono verificati nell'intervallo. Se non specificato, verrà utilizzato l'intervallo predefinito delle ultime 24 ore.

integer

Facoltativo. Il numero massimo di report da restituire. Il servizio potrebbe restituire un numero di report inferiore a questo valore.

Se non specificato, verranno restituiti al massimo 50 report. Il valore massimo è 100; i valori superiori a 100 verranno forzati a 100.

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata reports.search. Forniscilo per recuperare la pagina successiva.

Quando esegui la paginazione, tutti gli altri parametri forniti a reports.search devono corrispondere alla chiamata che ha fornito il token di pagina.

string

Facoltativo. Un predicato di selezione per recuperare solo un sottoinsieme dei report.

Per le nozioni di base sul filtraggio, consulta AIP-160.

** Nomi dei campi supportati:**

• apiLevel: corrisponde solo ai report sugli errori che si sono verificati nelle versioni di Android richieste (specificate come livello API numerico). Esempio: apiLevel = 28 OR apiLevel = 29.
• versionCode: corrisponde solo ai report sugli errori che si sono verificati nei codici versione dell'app richiesti. Esempio: versionCode = 123 OR versionCode = 456.
• deviceModel: corrisponde ai problemi di errore che si sono verificati nei dispositivi richiesti. Esempio: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
• deviceBrand: corrisponde ai problemi di errore che si sono verificati nei brand di dispositivi richiesti. Esempio: `deviceBrand = "Google".
• deviceType: corrisponde ai report sugli errori che si sono verificati nei tipi di dispositivi richiesti. Esempio: deviceType = "PHONE".
• errorIssueType: corrisponde solo ai report sugli errori dei tipi richiesti. Candidati validi: CRASH, ANR, NON_FATAL. Esempio: errorIssueType = CRASH OR errorIssueType = ANR.
• errorIssueId: corrisponde solo ai report sugli errori appartenenti agli ID dei problemi di errore richiesti. Esempio: errorIssueId = 1234 OR errorIssueId = 4567.
• errorReportId: corrisponde ai report sugli errori con l'ID del report sugli errori richiesto. Esempio: errorReportId = 1234 OR errorReportId = 4567.
• appProcessState: corrisponde ai report sugli errori relativi allo stato del processo di un'app, indicando se un'app viene eseguita in primo piano (visibile all'utente) o in background. Candidati validi: FOREGROUND, BACKGROUND. Esempio: appProcessState = FOREGROUND.
• isUserPerceived: corrisponde ai report sugli errori percepiti dall'utente. Non è accompagnato da alcun operatore. Esempio: isUserPerceived.

** Operatori supportati:**

• Operatori di confronto: l'unico operatore di confronto supportato è l'uguaglianza. Il campo filtrato deve essere visualizzato a sinistra del confronto.
• Operatori logici: gli operatori logici AND e OR possono essere utilizzati per creare filtri complessi seguendo una forma normale congiuntiva (CNF), ovvero congiunzioni di disgiunzioni. L'operatore OR ha la precedenza su AND, quindi l'utilizzo delle parentesi non è necessario quando si crea CNF.

L'OR operatore è supportato solo per creare disgiunzioni che si applicano allo stesso campo, ad es. versionCode = 123 OR versionCode = ANR. L'espressione di filtro versionCode = 123 OR errorIssueType = ANR non è valida.

** Esempi **

Alcune espressioni di filtro valide: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)