Method: projects.histories.list

특정 프로젝트의 기록을 나열합니다.

내역은 수정 시간을 기준으로 내림차순으로 정렬됩니다. HistoryId 키는 수정 시간이 동일한 기록을 정렬하는 데 사용됩니다.

다음 표준 오류 코드 중 하나를 반환할 수 있습니다.

  • PERMISSION_DENIED - 사용자에게 프로젝트를 읽을 수 있는 권한이 없는 경우
  • INVALID_ARGUMENT - 요청의 형식이 잘못된 경우
  • NOT_FOUND - 기록이 존재하지 않는 경우

HTTP 요청

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories

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

경로 매개변수

매개변수
projectId

string

프로젝트 ID.

필수의.

쿼리 매개변수

매개변수
pageToken

string

다음 항목에서 쿼리를 재개하기 위한 연속 토큰입니다.

선택 과목.

pageSize

integer

가져올 기록의 최대 수입니다.

기본값: 20. 필드가 설정되지 않았거나 값이 0인 경우 서버는 이 기본값을 사용합니다. 100보다 큰 값은 100으로 처리됩니다.

선택 과목.

filterByName

string

설정된 경우, 주어진 이름의 기록만 반환합니다.

선택 과목.

요청 본문

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

응답 본문

HistoryService.List에 대한 응답 메시지

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

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

object ( History )

역사.

nextPageToken

string

다음 항목에서 쿼리를 재개하기 위한 연속 토큰입니다.

가져올 기록이 더 있는 경우에만 설정됩니다.

토큰은 첫 번째 목록 요청 시점부터 최대 1시간 동안 유효합니다. 예를 들어 오후 1시에 목록 요청을 하고 10분 후에 첫 번째 요청의 토큰을 사용하는 경우 두 번째 응답의 토큰은 50분 동안만 유효합니다.

승인 범위

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

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.