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: 요청된 유형의 오류 보고서만 일치시킵니다. 유효한 후보: 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를 참고하세요.