Method: vitals.errors.reports.search

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

HTTP 요청

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{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: 요청된 유형의 오류 보고서만 일치합니다. 유효한 후보: CRASH, ANR, NON_FATAL 예: errorIssueType = CRASH OR errorIssueType = ANR.
  • errorIssueId: 요청된 오류 문제 ID에 속하는 오류 보고서만 일치시킵니다. 예: errorIssueId = 1234 OR errorIssueId = 4567
  • errorReportId: 요청된 오류 보고서 ID와 오류 보고서를 일치시킵니다. 예: errorReportId = 1234 OR errorReportId = 4567
  • appProcessState: 앱의 프로세스 상태에 관한 오류 보고서와 일치합니다. 앱이 포그라운드 (사용자에게 표시됨) 또는 백그라운드에서 실행되는지 나타냅니다. 유효한 후보: FOREGROUND, BACKGROUND 예를 들면 appProcessState = FOREGROUND입니다.
  • isUserPerceived: 사용자가 인지하는 오류 보고서와 일치합니다. 연산자가 함께 제공되지 않습니다. 예: isUserPerceived

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

  • 비교 연산자: 지원되는 유일한 비교 연산자는 등호입니다. 필터링된 필드는 비교의 왼쪽에 표시되어야 합니다.
  • 논리 연산자: 논리 연산자 AND 및 OR를 사용하여 논리곱 정규형 (CNF)에 따라 복잡한 필터를 빌드할 수 있습니다. 즉, 논리합의 논리곱입니다. 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 Overview를 참조하세요.