Method: vitals.errors.issues.search

Cerca tutti i problemi di errore in cui i report sono stati raggruppati.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

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

Formato: apps/{app}

Parametri di query

Parametri
interval

object (DateTimeInterval)

Facoltativo. L'intervallo di date e ore in cui cercare i problemi di errore. 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 problemi di errore con report sugli errori associati che si sono verificati nell'intervallo. Se non specificato, verrà utilizzato l'intervallo predefinito delle ultime 24 ore.
pageSize

integer

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

Se non specificato, verranno restituiti al massimo 50 problemi di errore. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000.
pageToken

string

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

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

string

Facoltativo. Un predicato di selezione per recuperare solo un sottoinsieme dei problemi. I conteggi nei problemi di errore restituiti rifletteranno solo le occorrenze che corrispondevano al filtro.

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

** Nomi dei campi supportati:**

  • apiLevel: corrisponde solo ai problemi di errore che si sono verificati nelle versioni di Android richieste (specificate come livello API numerico). Esempio: apiLevel = 28 OR apiLevel = 29.
  • versionCode: corrisponde solo ai problemi di errore 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 problemi di errore che si sono verificati nei tipi di dispositivi richiesti. Esempio: deviceType = "PHONE".
  • errorIssueType: corrisponde solo ai problemi di errore dei tipi richiesti. Candidati validi: CRASH, ANR, NON_FATAL. Esempio: errorIssueType = CRASH OR errorIssueType = ANR.
  • appProcessState: corrisponde ai problemi di errore nello 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 problemi di errore 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'uso delle parentesi non è necessario quando si crea CNF.

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

** 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)
orderBy

string

Facoltativo. Specifica un campo che verrà utilizzato per ordinare i risultati.

** Dimensioni supportate:**

  • errorReportCount: ordina i problemi in base al numero di report sugli errori.
  • distinctUsers: ordina i problemi in base al numero di utenti interessati unici.

** Operazioni supportate:**

  • asc per l'ordine crescente.
  • desc per l'ordine decrescente.

Formato: un campo e un'operazione, ad es. errorReportCount desc

Nota: al momento è supportato un solo campo alla volta.
sampleErrorReportLimit

integer

Facoltativo. Numero di report sugli errori di esempio da restituire per ErrorIssue. Se non specificato, verrà utilizzato 0. Nota: al momento sono supportati solo 0 e 1.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta con un elenco paginato di problemi che corrispondevano alla richiesta.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "errorIssues": [
    {
      object (ErrorIssue)
    }
  ],
  "nextPageToken": string
}
Campi
errorIssues[]

object (ErrorIssue)

ErrorIssues trovati.
nextPageToken

string

Token di continuazione per recuperare la pagina di dati successiva.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/playdeveloperreporting

Per saperne di più, consulta la OAuth 2.0 Overview.