Method: vitals.errors.issues.search

Przeszukuje wszystkie problemy z błędami, w których zgrupowano raporty.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Zasób nadrzędny problemów z błędami, który wskazuje aplikację, w której wystąpiły.

Format: apps/{app}

Parametry zapytania

Parametry
interval

object (DateTimeInterval)

Opcjonalnie. Interwał daty i godziny, w którym mają być wyszukiwane problemy z błędami. Zarówno czas rozpoczęcia, jak i zakończenia musi być zgodny z pełną godziną i korzystać ze strefy czasowej UTC (lub być pusty, w którym to przypadku również będzie używana strefa czasowa UTC).

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

integer

Opcjonalnie. Maksymalna liczba problemów z błędami do zwrócenia. Usługa może zwrócić mniej niż ta wartość.

Jeśli nie zostanie określona, zwracanych będzie co najwyżej 50 problemów z błędami. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
pageToken

string

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

Podczas stronicowania wszystkie inne parametry podane w żądaniu muszą być zgodne z wywołaniem, które dostarczyło token strony.
filter

string

Opcjonalnie. Predykat wyboru, który umożliwia pobranie tylko podzbioru problemów. Liczby w zwróconych problemach z błędami będą odzwierciedlać tylko wystąpienia, które pasują do filtra.

Podstawowe informacje o filtrowaniu znajdziesz w AIP-160.

** Obsługiwane nazwy pól:

  • apiLevel: pasuje tylko do błędów, które wystąpiły w wersjach Androida podanych w żądaniu (określonych jako numeryczny poziom interfejsu API). Przykład: apiLevel = 28 OR apiLevel = 29
  • versionCode: pasuje do problemów z błędami, które wystąpiły tylko w przypadku kodów wersji aplikacji w żądaniu. Przykład: versionCode = 123 OR versionCode = 456
  • deviceModel: pasuje do problemów z błędami, 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 problemów z błędami, które wystąpiły na żądanych typach urządzeń. Przykład: deviceType = "PHONE"
  • errorIssueType: Pasuje tylko do błędów żądanych typów. Prawidłowe wartości: CRASH, ANR, NON_FATAL. Przykład: errorIssueType = CRASH OR errorIssueType = ANR.
  • appProcessState: odpowiada problemom z błędami w stanie procesu aplikacji, wskazując, czy aplikacja działa na pierwszym planie (widocznym dla użytkownika) czy w tle. Prawidłowe wartości: FOREGROUND, BACKGROUND. Przykład: appProcessState = FOREGROUND.
  • isUserPerceived: pasuje do problemów z błędami, które są widoczne dla użytkowników. 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 wykorzystać 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 alternatyw, które odnoszą się do tego samego pola, np. versionCode = 123 OR errorIssueType = ANR nie jest prawidłowym filtrem.

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

string

Opcjonalnie. Określa pole, które będzie używane do sortowania wyników.

** Obsługiwane wymiary:

  • errorReportCount: porządkuje problemy według liczby raportów o błędach.
  • distinctUsers: problemy z zamówieniami według liczby unikalnych użytkowników, których dotyczą.

** Obsługiwane operacje:

  • asc w przypadku kolejności rosnącej.
  • desc w przypadku kolejności malejącej.

Format: pole i operacja, np. errorReportCount desc

Uwaga: obecnie obsługiwane jest tylko 1 pole naraz.
sampleErrorReportLimit

integer

Opcjonalnie. Liczba przykładowych raportów o błędach do zwrócenia dla każdego elementu ErrorIssue. Jeśli nie zostanie podana, użyta zostanie wartość 0. Uwaga: obecnie obsługiwane są tylko wartości 0 i 1.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź z podzieloną na strony listą problemów, które pasują do żądania.

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

Zapis JSON 
{
  "errorIssues": [
    {
      object (ErrorIssue)
    }
  ],
  "nextPageToken": string
}
Pola
errorIssues[]

object (ErrorIssue)

ErrorProblemy, które zostały znalezione.
nextPageToken

string

Token kontynuacji do pobrania następnej strony danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.