REST Resource: files

리소스: File

API에 업로드된 파일입니다.

JSON 표현
{
  "name": string,
  "displayName": string,
  "mimeType": string,
  "sizeBytes": string,
  "createTime": string,
  "updateTime": string,
  "expirationTime": string,
  "sha256Hash": string,
  "uri": string,
  "state": enum (State),
  "error": {
    object (Status)
  },

  // Union field metadata can be only one of the following:
  "videoMetadata": {
    object (VideoMetadata)
  }
  // End of list of possible types for union field metadata.
}
입력란
name

string

변경할 수 없습니다. 식별자. File 리소스 이름입니다. ID('files/' 접두사를 제외한 이름)에는 최대 40자(영문 기준)의 소문자 영숫자 또는 대시(-)를 포함할 수 있습니다. ID는 대시로 시작하거나 끝날 수 없습니다. 생성 시 이름이 비어 있으면 고유한 이름이 생성됩니다. 예: files/123-456

displayName

string

선택사항입니다. 사람이 읽을 수 있는 File의 표시 이름입니다. 표시 이름은 공백을 포함하여 512자(영문 기준) 이하여야 합니다. 예: '환영 이미지'

mimeType

string

출력 전용입니다. 파일의 MIME 유형입니다.

sizeBytes

string (int64 format)

출력 전용입니다. 바이트 단위의 파일 크기입니다.

createTime

string (Timestamp format)

출력 전용입니다. File가 생성된 시점의 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. File가 마지막으로 업데이트된 시점의 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

expirationTime

string (Timestamp format)

출력 전용입니다. File가 삭제될 시점의 타임스탬프입니다. File가 만료될 예정인 경우에만 설정됩니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

sha256Hash

string (bytes format)

출력 전용입니다. 업로드된 바이트의 SHA-256 해시입니다.

base64 인코딩 문자열입니다.

uri

string

출력 전용입니다. File의 URI입니다.

state

enum (State)

출력 전용입니다. 파일의 처리 상태입니다.

error

object (Status)

출력 전용입니다. 파일 처리에 실패한 경우 오류 상태

통합 필드 metadata. 파일의 메타데이터입니다. metadata은 다음 중 하나여야 합니다.
videoMetadata

object (VideoMetadata)

출력 전용입니다. 동영상의 메타데이터입니다.

VideoMetadata

동영상(File)의 메타데이터입니다.

JSON 표현
{
  "videoDuration": string
}
입력란
videoDuration

string (Duration format)

동영상의 길이입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

상태

파일의 수명 주기 상태입니다.

열거형
STATE_UNSPECIFIED 기본값입니다. 상태가 생략된 경우 이 값이 사용됩니다.
PROCESSING 파일을 처리하는 중이며 아직 추론에 사용할 수 없습니다.
ACTIVE 파일이 처리되어 추론에 사용할 수 있습니다.
FAILED 파일을 처리하지 못했습니다.

메서드

delete

File를 삭제합니다.

get

지정된 File의 메타데이터를 가져옵니다.

list

요청하는 프로젝트가 소유한 File의 메타데이터를 나열합니다.