Method: vitals.errors.issues.search

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

HTTP 요청

GET https://playdeveloperreporting.googleapis.com/v1beta1/{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입니다. 예를 들면 errorIssueType = CRASH OR errorIssueType = ANR입니다.
  • appProcessState: 앱이 포그라운드 (사용자에게 표시)에서 실행되는지 아니면 백그라운드에서 실행되는지를 나타내는 앱의 프로세스 상태에서 발생하는 오류 문제를 일치시킵니다. 유효한 후보는 FOREGROUND, BACKGROUND입니다. 예를 들면 appProcessState = FOREGROUND입니다.
  • isUserPerceived: 사용자가 인식하는 오류 문제를 일치시킵니다. 연산자가 함께 제공되지 않습니다. 예: isUserPerceived

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

  • 비교 연산자: 유일하게 지원되는 비교 연산자는 등호입니다. 필터링된 필드는 비교 왼쪽에 표시되어야 합니다.
  • 논리 연산자: 논리 연산자 ANDOR는 결합의 결합입니다. 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)

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

요청 본문

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

응답 본문

요청과 일치하여 페이지로 나눈 문제 목록을 사용하여 응답합니다.

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

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

object (ErrorIssue)

발견된 ErrorIssues입니다.

nextPageToken

string

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

승인 범위

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

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

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