Method: vitals.errors.reports.search

Przeszukuje wszystkie otrzymane raporty o błędach dotyczące 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

To pole jest wymagane. Zasób nadrzędny raportów, który wskazuje aplikację, dla której zostały otrzymane.

Format: aplikacje/{aplikacja}

Parametry zapytania

Parametry
interval

object (DateTimeInterval)

Przedział dat i godzin przeszukiwania raportów o błędach. Początek i koniec muszą być ustawione na godzinę, a strefa czasowa to UTC (lub pole powinno być puste, ponieważ wtedy używana jest też strefa UTC).

Jeśli zasada jest skonfigurowana, zwracane są tylko raporty o błędach, które wystąpiły w danym przedziale czasu. Jeśli nie określono inaczej, zostanie użyty domyślny przedział z ostatnich 24 godzin.
pageSize

integer

Maksymalna liczba raportów do zwrócenia. Usługa może zwrócić mniejszą wartość od tej wartości.

Jeśli wartość nie zostanie określona, zwróconych zostanie 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 tę wartość, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie pozostałe parametry przekazywane w metodzie reports.search muszą odpowiadać wywołaniu, które przekazało token strony.
filter

string

Predykat wyboru do pobierania tylko podzbioru raportów.

Podstawowe informacje o filtrowaniu znajdziesz na stronie AIP-160.

** Obsługiwane nazwy pól:**

  • apiLevel: dopasowuje raporty o błędach, które wystąpiły w żądanych wersjach Androida (określonych jako numeryczny poziom interfejsu API). Przykład: apiLevel = 28 OR apiLevel = 29.
  • versionCode: dopasowuje raporty o błędach, które wystąpiły tylko w przypadku żądanych kodów wersji aplikacji. Przykład: versionCode = 123 OR versionCode = 456.
  • deviceModel: dopasowuje problemy o błędach, które wystąpiły na żądanych urządzeniach. Przykład: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: dopasowuje problemy o błędach, które wystąpiły w przypadku żądanych marek urządzeń. Przykład: `deviceBrand = "Google".
  • deviceType: dopasowuje raporty o błędach, które wystąpiły w żądanych typach urządzeń. Przykład: deviceType = "PHONE".
  • errorIssueType: dopasowuje raporty o błędach tylko żądanych typów. Prawidłowe kandydaci: JAVA_CRASH, NATIVE_CRASH, ANR. Przykład: errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH.
  • errorIssueId: dopasowuje raporty o błędach należące tylko do żądanych identyfikatorów problemów o błędach. Przykład: errorIssueId = 1234 OR errorIssueId = 4567.
  • appProcessState: dopasowuje raporty o błędach na podstawie stanu procesu aplikacji, wskazując, czy aplikacja działa na pierwszym planie (widoczne dla użytkowników) czy w tle. Prawidłowe kandydaci: FOREGROUND, BACKGROUND. Przykład: appProcessState = FOREGROUND.
  • isUserPerceived: zawiera raporty o błędach postrzegane przez użytkowników. Nie zawiera on żadnych operatorów. Przykład: isUserPerceived.

** Obsługiwane operatory:**

  • Operatory porównania: jedynym obsługiwanym operatorem porównania jest równość. Odfiltrowane pole musi się pojawić po lewej stronie porównania.
  • Operatory logiczne: operatory logiczne AND i OR mogą służyć do budowania złożonych filtrów na podstawie spójnej postaci normalnej (CNF), tzn. spójniki. Operator OR ma pierwszeństwo przed operatorem AND, więc podczas tworzenia CNF nie trzeba używać nawiasów.

Operator OR jest obsługiwany tylko do tworzenia zestawień, które mają zastosowanie do tego samego pola, np. versionCode = 123 OR versionCode = ANR. Wyrażenie filtra versionCode = 123 OR errorIssueType = ANR jest nieprawidłowe.

** Przykłady **

Kilka 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 podzieloną na strony listą raportów o błędach pasujących do wyszukiwanego hasła.

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

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

object (ErrorReport)

Raporty o błędach, które zostały znalezione.
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 artykule Omówienie protokołu OAuth 2.0.