Method: vitals.errors.issues.search

보고서가 그룹화된 모든 오류 문제를 검색합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
parent

string

필수입니다. 오류 문제의 상위 리소스로, 오류 문제가 수신된 애플리케이션을 나타냅니다.

형식: apps/{app}

쿼리 매개변수

매개변수
interval

object (DateTimeInterval)

오류 문제를 검색할 날짜 시간 간격입니다. 시작과 종료는 모두 시간으로 정렬되어야 하고 시간대로 UTC를 사용해야 합니다 (비어 있는 경우에도 UTC가 사용됨).

설정된 경우 해당 간격에서 발생한 연결된 오류 보고서가 있는 오류 문제만 반환됩니다. 지정하지 않으면 지난 24시간의 기본 간격이 사용됩니다.
pageSize

integer

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

지정하지 않으면 최대 50개의 오류 문제가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.
pageToken

string

이전 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지로 나누는 경우 요청에 제공된 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다.
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.
  • appProcessState: 앱의 프로세스 상태에 관한 오류 문제와 일치하며, 앱이 포그라운드 (사용자에게 표시됨) 또는 백그라운드에서 실행되는지 여부를 나타냅니다. 유효한 후보: FOREGROUND, BACKGROUND 예를 들면 appProcessState = FOREGROUND입니다.
  • isUserPerceived: 사용자가 인식하는 오류 문제를 일치시킵니다. 연산자가 함께 제공되지 않습니다. 예: isUserPerceived

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

  • 비교 연산자: 지원되는 유일한 비교 연산자는 등호입니다. 필터링된 필드는 비교의 왼쪽에 표시되어야 합니다.
  • 논리 연산자: 논리 연산자 AND 및 OR를 사용하여 논리곱 정규형 (CNF)에 따라 복잡한 필터를 빌드할 수 있습니다. 즉, 논리합의 논리곱입니다. OR 연산자가 AND보다 우선하므로 CNF를 빌드할 때 괄호를 사용할 필요가 없습니다.

OR 연산자는 동일한 필드에 적용되는 선언을 빌드하는 데만 지원됩니다.예를 들면 다음과 같습니다. versionCode = 123 OR errorIssueType = ANR은(는) 유효한 필터가 아닙니다.

** 예 **

유효한 필터링 표현식의 예: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)
orderBy

string

결과를 정렬하는 데 사용될 필드를 지정합니다.

** 지원되는 측정기준:**

  • errorReportCount: 오류 보고 수별로 문제를 정렬합니다.
  • distinctUsers: 영향을 받은 고유 사용자 수별 주문 문제입니다.

** 지원되는 작업:**

  • 오름차순의 경우 asc
  • 내림차순의 경우 desc

형식: 필드와 작업(예: errorReportCount desc)

참고: 현재는 한 번에 하나의 필드만 지원됩니다.
sampleErrorReportLimit

integer

선택사항입니다. ErrorIssue당 반환할 샘플 오류 보고서 수입니다. 지정하지 않으면 0이 사용됩니다. 참고: 현재는 0과 1만 지원됩니다.

요청 본문

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

응답 본문

요청과 일치하는 문제가 페이지로 구분된 목록으로 포함된 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

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

object (ErrorIssue)

Error발견된 문제.
nextPageToken

string

데이터의 다음 페이지를 가져오는 연속 토큰입니다.

승인 범위

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

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

자세한 내용은 OAuth 2.0 Overview를 참조하세요.