Method: projects.histories.executions.steps.thumbnails.list

단계에 첨부된 이미지의 축소판을 나열합니다.

다음 정식 오류 코드 중 하나를 반환할 수 있습니다. - PERMISSION_DENIED - 사용자에게 프로젝트 또는 이미지에서 읽을 권한이 없는 경우 - INVALID_ARGUMENT - 요청 형식이 잘못된 경우 - NOT_FOUND - 단계가 존재하지 않는 경우 또는 이미지 중 하나라도 존재하지 않는 경우

HTTP 요청

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories/{historyId}/executions/{executionId}/steps/{stepId}/thumbnails

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

경로 매개변수

매개변수
projectId

string

프로젝트 ID.

필수의.

historyId

string

기록 ID입니다.

필수의.

executionId

string

실행 ID입니다.

필수의.

stepId

string

단계 ID.

필수의.

쿼리 매개변수

매개변수
pageToken

string

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

선택 과목.

pageSize

integer

가져올 최대 썸네일 수입니다.

기본값: 50. 필드가 설정되지 않았거나 값이 0인 경우 서버는 이 기본값을 사용합니다.

선택 과목.

요청 본문

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

응답 본문

단계의 썸네일을 포함하는 응답입니다.

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

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

object ( Image )

이미지 데이터 목록입니다.

이미지는 결정적인 순서로 반환됩니다. 중요한 순서에 따라 이러한 요소에 따라 정렬됩니다. * 첫째, 관련 테스트 사례에 따라 정렬됩니다. 테스트 케이스가 없는 이미지는 테스트 케이스가 있는 이미지보다 더 큰 것으로 간주됩니다. * 둘째, 생성 시점에 따른다. 생성 시간이 없는 이미지는 생성 시간이 있는 이미지보다 더 큽니다. * 셋째, 단계에 추가된 순서(steps.create 또는 steps.patch 호출)입니다.

nextPageToken

string

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

설정된 경우 pageToken 필드에서 이 값으로 목록을 다시 호출하여 읽을 축소판이 더 있음을 나타냅니다.

승인 범위

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

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

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

영상

기본 이미지와 썸네일에 대한 링크가 포함된 이미지입니다.

JSON 표현
{
  "stepId": string,
  "sourceImage": {
    object (ToolOutputReference)
  },

  // Union field thumbnail_or_error can be only one of the following:
  "thumbnail": {
    object (Thumbnail)
  },
  "error": {
    object (Status)
  }
  // End of list of possible types for union field thumbnail_or_error.
}
필드
stepId

string

이미지가 첨부되는 단계입니다.

항상 설정됩니다.

sourceImage

object ( ToolOutputReference )

전체 크기의 원본 이미지에 대한 참조입니다.

이는 해당 단계 아래의 이미지에 대한 toolOutputs 항목과 동일합니다.

항상 설정됩니다.

유니온 필드 thumbnail_or_error . 이미지의 축소판이거나 축소판을 렌더링할 수 없는 이유를 설명하는 오류입니다. thumbnail_or_error 다음 중 하나일 수 있습니다.
thumbnail

object ( Thumbnail )

미리보기 이미지입니다.

error

object ( Status )

미리보기 이미지를 렌더링할 수 없는 이유를 설명하는 오류입니다.

썸네일

크기와 형식이 포함된 단일 축소판입니다.

JSON 표현
{
  "contentType": string,
  "heightPx": integer,
  "widthPx": integer,
  "data": string
}
필드
contentType

string

미리보기 이미지의 콘텐츠 유형(예: 'image/png')입니다.

항상 설정됩니다.

heightPx

integer

썸네일의 높이(픽셀)입니다.

항상 설정됩니다.

widthPx

integer

썸네일의 너비(픽셀)입니다.

항상 설정됩니다.

data

string ( bytes format)

썸네일 파일 자체.

즉, 여기에 있는 바이트는 정확하게 썸네일 파일을 구성하는 바이트입니다. 적절한 콘텐츠 유형을 사용하여 있는 그대로 이미지로 제공될 수 있습니다.

항상 설정됩니다.

base64로 인코딩된 문자열입니다.

상태

Status 유형은 REST API 및 RPC API를 포함한 다양한 프로그래밍 환경에 적합한 논리적 오류 모델을 정의합니다. gRPC 에서 사용됩니다. 각 Status 메시지에는 오류 코드, 오류 메시지, 오류 세부정보라는 세 가지 데이터가 포함되어 있습니다.

API 디자인 가이드 에서 이 오류 모델과 이를 사용하는 방법에 대해 자세히 알아볼 수 있습니다.

JSON 표현
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
필드
code

integer

google.rpc.Code 의 열거형 값이어야 하는 상태 코드입니다.

message

string

개발자에게 표시되는 오류 메시지는 영어로 작성되어야 합니다. 사용자에게 표시되는 모든 오류 메시지는 현지화되어 google.rpc.Status.details 필드로 전송되거나 클라이언트에서 현지화되어야 합니다.

details[]

object

오류 세부정보를 전달하는 메시지 목록입니다. API에서 사용할 수 있는 공통 메시지 유형 세트가 있습니다.

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type" 에는 유형을 식별하는 URI가 포함되어 있습니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" } .