Method: vitals.errors.reports.search

Cerca in tutti i report sugli errori ricevuti per un'app.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

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

Formato: app/{app}

Parametri di ricerca

Parametri
interval

object (DateTimeInterval)

L'intervallo di date per la ricerca nei 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.

pageSize

integer

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

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

pageToken

string

Un token di pagina, ricevuto da una precedente chiamata a reports.search. Specifica questo valore per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a reports.search devono corrispondere alla chiamata che ha fornito il token della pagina.

filter

string

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

Per le nozioni di base sui filtri, consulta AIP-160.

** Nomi dei campi supportati:**

  • apiLevel: corrisponde ai report sugli errori verificatisi solo nelle versioni di Android richieste (specificate come livello API numerico). Esempio: apiLevel = 28 OR apiLevel = 29.
  • versionCode: corrisponde ai report sugli errori generati solo nei codici di versione dell'app richiesti. Esempio: versionCode = 123 OR versionCode = 456.
  • deviceModel: corrisponde ai problemi di errore che si sono verificati sui 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: restituisce i report sugli errori relativi ai tipi di dispositivi richiesti. Esempio: deviceType = "PHONE".
  • errorIssueType: corrisponde ai report sugli errori solo per i tipi richiesti. Candidati validi: JAVA_CRASH, NATIVE_CRASH, ANR. Esempio: errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH.
  • errorIssueId: corrisponde solo ai report sugli errori appartenenti agli ID problema di errore richiesti. Esempio: errorIssueId = 1234 OR errorIssueId = 4567.
  • appProcessState: crea corrispondenze con i report sugli errori relativi allo stato di processo di un'app, che indicano se l'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 sul lato sinistro del confronto.
  • Operatori logici: gli operatori logici AND e OR possono essere utilizzati per creare filtri complessi che seguono una forma normale congiuntiva (CNF), ad esempio congiunzioni di disgiunzioni. L'operatore OR ha la precedenza su AND, pertanto l'utilizzo delle parentesi non è necessario quando si crea CNF.

L'operatore OR è supportato solo per creare disgiunzioni che si applicano allo stesso campo, ad esempio, 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)

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta con un elenco impaginato di report sugli errori corrispondenti alla query di ricerca.

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

Rappresentazione JSON
{
  "errorReports": [
    {
      object (ErrorReport)
    }
  ],
  "nextPageToken": string
}
Campi
errorReports[]

object (ErrorReport)

Sono stati trovati report sugli errori.

nextPageToken

string

Token della pagina per recuperare la pagina successiva dei report.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.