Method: vitals.errors.reports.search

앱에 대해 수신된 모든 오류 보고서를 검색합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 보고서를 수신한 애플리케이션을 나타내는 보고서의 상위 리소스입니다.

형식: apps/{app}

쿼리 매개변수

매개변수
interval

object (DateTimeInterval)

오류 보고서를 검색할 날짜 시간 간격입니다. 시작과 끝은 모두 시간별로 정렬되어야 하며 UTC을 시간대로 사용해야 합니다 (또는 비어 있는 경우 UTC도 사용됨).

설정하면 해당 간격 내에 발생한 오류 보고서만 반환됩니다. 지정하지 않으면 지난 24시간의 기본 간격이 사용됩니다.

pageSize

integer

반환할 최대 보고서 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다.

지정하지 않으면 최대 50개의 보고서가 반환됩니다. 최댓값은 100이며, 100 이상의 값은 100으로 강제 변환됩니다.

pageToken

string

이전 reports.search 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 reports.search에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

filter

string

보고서의 하위 집합만 검색하는 선택 조건자입니다.

필터링 기본사항은 AIP-160을 확인하세요.

** 지원되는 필드 이름:**

  • apiLevel: 요청된 Android 버전 (숫자 API 수준으로 지정됨)에서만 발생한 오류 보고서와 일치합니다. 예: apiLevel = 28 OR apiLevel = 29
  • versionCode: 요청된 앱 버전 코드에서 발생한 오류 보고서만 일치시킵니다. 예: versionCode = 123 OR versionCode = 456
  • deviceModel: 요청된 기기에서 발생한 오류 문제와 일치합니다. 예: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: 요청된 기기 브랜드에서 발생한 오류 문제와 일치합니다. 예: `deviceBrand = "Google".
  • deviceType: 요청된 기기 유형에서 발생한 오류 보고서와 일치합니다. 예: deviceType = "PHONE"
  • errorIssueType: 요청된 유형의 오류 보고서만 일치시킵니다. 유효한 후보는 JAVA_CRASH, NATIVE_CRASH, ANR입니다. 예: errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH.
  • errorIssueId: 요청된 오류 문제 ID에만 속하는 오류 보고서와 일치합니다. 예: errorIssueId = 1234 OR errorIssueId = 4567
  • appProcessState: 앱이 포그라운드 (사용자에게 표시)에서 실행되는지 아니면 백그라운드에서 실행되는지를 나타내는 앱의 프로세스 상태에 관한 오류 보고서와 일치합니다. 유효한 후보는 FOREGROUND, BACKGROUND입니다. 예를 들면 appProcessState = FOREGROUND입니다.
  • isUserPerceived: 사용자가 인식하는 오류 보고서와 일치합니다. 연산자가 함께 제공되지 않습니다. 예: isUserPerceived

** 지원되는 연산자:**

  • 비교 연산자: 유일하게 지원되는 비교 연산자는 등호입니다. 필터링된 필드는 비교 왼쪽에 표시되어야 합니다.
  • 논리 연산자: 논리 연산자 ANDOR는 결합의 결합입니다. OR 연산자는 AND보다 우선하므로 CNF를 빌드할 때 괄호를 사용할 필요가 없습니다.

OR 연산자는 동일한 필드에 적용되는 분리를 빌드하는 데만 지원됩니다(예: versionCode = 123 OR versionCode = ANR. 필터 표현식 versionCode = 123 OR errorIssueType = ANR이(가) 잘못되었습니다.

** 예 **

유효한 필터링 표현식은 다음과 같습니다. * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

검색어와 일치하는 페이지 매김된 오류 보고서 목록이 포함된 응답입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "errorReports": [
    {
      object (ErrorReport)
    }
  ],
  "nextPageToken": string
}
필드
errorReports[]

object (ErrorReport)

발견된 오류 보고서입니다.

nextPageToken

string

보고서의 다음 페이지를 가져오는 페이지 토큰입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.