Method: vitals.errors.issues.search

Przeszukuje wszystkie problemy z błędami, według których zostały zgrupowane raporty.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

To pole jest wymagane. Zasób nadrzędny problemów z błędami, wskazujący aplikację, dla której zostały przesłane.

Format: aplikacje/{aplikacja}

Parametry zapytania

Parametry
interval

object (DateTimeInterval)

Przedział dat i godzin wyszukiwania błędów. 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 problemy z powiązanymi raportami 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 problemów z błędami. Usługa może zwrócić mniejszą wartość od tej wartości.

Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 50 błędów. Maksymalna wartość to 1000, a wartości powyżej 1000 zostaną zmienione na 1000.

pageToken

string

Token strony otrzymany z poprzedniego wywołania. Podaj tę wartość, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie pozostałe parametry podane w żądaniu muszą odpowiadać wywołaniu, które dostarczyło token strony.

filter

string

Predykat wyboru do pobierania tylko podzbioru problemów. Liczby zwracanych problemów z błędami odzwierciedlają tylko wystąpienia pasujące do filtra.

Podstawowe informacje o filtrowaniu znajdziesz na stronie AIP-160.

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

  • apiLevel: dopasowuje problemy z błędami, 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 problemy 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 problemy o błędach, które wystąpiły w żądanych typach urządzeń. Przykład: deviceType = "PHONE".
  • errorIssueType: dopasowuje problemy związane z błędami tylko żądanych typów. Prawidłowe kandydaci: CRASH, ANR. Przykład: errorIssueType = CRASH OR errorIssueType = ANR.
  • appProcessState: dopasowuje problemy z błędami w stanie 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 problemy związane z błędami 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 errorIssueType = ANR nie jest prawidłowym filtrem.

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

orderBy

string

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: sortowanie problemów według liczby unikalnych użytkowników, których dotyczy problem.

** Obsługiwane operacje:**

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

Format: pole i operacja, np. errorReportCount desc

Uwaga: obecnie obsługiwane jest tylko jedno pole naraz.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź z podzieloną na strony listą problemów pasujących 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)

Znaleziono błędy.

nextPageToken

string

Token kontynuacji umożliwiający pobranie następnej strony danych.

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.