Method: vitals.errors.reports.search

Wyszukuje wszystkie raporty o błędach otrzymane w przypadku aplikacji.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagany. Zasób nadrzędny raportów, który wskazuje aplikację, dla której zostały one otrzymane.

Format: apps/{app}

Parametry zapytania

Parametry
interval

object (DateTimeInterval)

Przedział czasu, w którym mają być wyszukiwane raporty o błędach. Zarówno czas rozpoczęcia, jak i zakończenia musi być zgodny z godziną i musi używać strefy czasowej UTC (lub być pusty, w którym to przypadku również będzie używana strefa czasowa UTC).

Jeśli ta opcja jest ustawiona, zwracane są tylko raporty o błędach, które wystąpiły w danym przedziale czasu. Jeśli nie określisz inaczej, zostanie użyty domyślny przedział czasu, czyli ostatnie 24 godziny.
pageSize

integer

Maksymalna liczba raportów do zwrócenia. Usługa może zwrócić mniej niż ta wartość.

Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 50 raportów. Maksymalna wartość to 100. Wartości powyżej 100 zostaną zmienione na 100.
pageToken

string

Token strony otrzymany z poprzedniego wywołania reports.search. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji reports.search muszą być zgodne z wywołaniem, które dostarczyło token strony.
filter

string

Predykat wyboru, który umożliwia pobranie tylko podzbioru raportów.

Podstawowe informacje o filtrowaniu znajdziesz w AIP-160.

** Obsługiwane nazwy pól:

  • apiLevel: pasuje tylko do raportów o błędach, które wystąpiły w określonych wersjach Androida (podanych jako numeryczny poziom interfejsu API). Przykład: apiLevel = 28 OR apiLevel = 29.
  • versionCode: pasuje tylko do raportów o błędach, które wystąpiły w przypadku kodów wersji aplikacji podanych w żądaniu. Przykład: versionCode = 123 OR versionCode = 456.
  • deviceModel: pasuje do błędów, które wystąpiły na żądanych urządzeniach. Przykład: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: pasuje do błędów, które wystąpiły w przypadku marek urządzeń podanych w żądaniu. Przykład: `deviceBrand = "Google".
  • deviceType: pasuje do raportów o błędach, które wystąpiły na urządzeniach określonych typów. Przykład: deviceType = "PHONE".
  • errorIssueType: Pasuje tylko do raportów o błędach żądanych typów. Prawidłowe wartości: CRASH, ANR, NON_FATAL. Przykład: errorIssueType = CRASH OR errorIssueType = ANR.
  • errorIssueId: pasuje tylko do raportów o błędach należących do żądanych identyfikatorów problemów z błędami. Przykład: errorIssueId = 1234 OR errorIssueId = 4567.
  • errorReportId: dopasowuje raporty o błędach do identyfikatora żądanego raportu o błędach. Przykład: errorReportId = 1234 OR errorReportId = 4567.
  • appProcessState: dopasowuje raporty o błędach dotyczące stanu procesu aplikacji, wskazując, czy aplikacja działa na pierwszym planie (widoczna dla użytkownika), czy w tle. Prawidłowe wartości: FOREGROUND, BACKGROUND. Przykład: appProcessState = FOREGROUND.
  • isUserPerceived: dopasowuje raporty o błędach, które są widoczne dla użytkownika. Nie towarzyszą mu żadni operatorzy. Przykład: isUserPerceived.

** Obsługiwani operatorzy:

  • Operatory porównania: jedynym obsługiwanym operatorem porównania jest równość. Filtrowane pole musi pojawić się po lewej stronie porównania.
  • Operatory logiczne: operatory logiczne AND i OR można stosować do tworzenia złożonych filtrów w postaci koniunkcyjnej postaci normalnej (CNF), czyli: koniunkcje alternatyw. Operator OR ma wyższy priorytet niż operator AND, więc podczas tworzenia CNF nie trzeba używać nawiasów.

Operator OR jest obsługiwany tylko w przypadku tworzenia rozłączeń, które odnoszą się do tego samego pola, np. versionCode = 123 OR versionCode = ANR. Wyrażenie filtra versionCode = 123 OR errorIssueType = ANR jest nieprawidłowe.

** Przykłady **

Przykłady prawidłowych wyrażeń filtrujących: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź z listą raportów o błędach podzieloną na strony, która pasuje do zapytania.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "errorReports": [
    {
      object (ErrorReport)
    }
  ],
  "nextPageToken": string
}
Pola
errorReports[]

object (ErrorReport)

Znalezione raporty o błędach.
nextPageToken

string

Token strony do pobrania następnej strony raportów.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.