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)

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

이미지가 확정된 순서로 반환됩니다. 중요도 순으로 이러한 요소를 정렬합니다. * 첫째, 관련 테스트 사례를 기준으로 정렬됩니다. 테스트 사례가 없는 이미지는 테스트 사례가 있는 이미지보다 큰 것으로 간주됩니다. * 둘째, 생성 시간을 기준으로 합니다. 생성 시간이 없는 이미지는 생성 시간이 있는 이미지보다 큽니다. * 셋째, 단계에 추가된 순서 (step.create 또는 steps.patch 호출)입니다.
nextPageToken

string

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

설정된 경우 pageToken 필드에 이 값을 사용하여 list를 다시 호출하여 읽어야 할 썸네일이 더 있음을 나타냅니다.

승인 범위

다음 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 메시지에는 오류 코드, 오류 메시지, 오류 세부정보라는 3가지 데이터가 포함됩니다.

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" }