REST Resource: projects.datasets

리소스: Dataset

지도 플랫폼 데이터 세트를 나타냅니다.

JSON 표현 
{
  "name": string,
  "displayName": string,
  "description": string,
  "versionId": string,
  "usage": [
    enum (Usage)
  ],
  "status": {
    object (Status)
  },
  "createTime": string,
  "updateTime": string,
  "versionCreateTime": string,
  "versionDescription": string,

  // Union field data_source can be only one of the following:
  "localFileSource": {
    object (LocalFileSource)
  },
  "gcsSource": {
    object (GcsSource)
  }
  // End of list of possible types for union field data_source.
}
필드
name

string

리소스 이름, projects/{project}/datasets/{dataset_id}
displayName

string

콘솔 UI에 표시되는 인간이 읽을 수 있는 이름입니다.
description

string

이 데이터 세트에 대한 설명입니다.
versionId

string

데이터 세트의 버전 ID입니다.
usage[]

enum (Usage)

이 데이터 세트의 지정된 사용 사례입니다.
status

object (Status)

출력 전용입니다. 이 데이터 세트 버전의 상태입니다.
createTime

string (Timestamp format)

출력 전용입니다. 데이터 세트가 처음 생성된 시간입니다.

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

string (Timestamp format)

출력 전용입니다. 데이터 세트 메타데이터가 마지막으로 업데이트된 시간입니다.

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

string (Timestamp format)

출력 전용입니다. 이 버전의 데이터 세트가 생성된 시간입니다. (데이터 세트로 데이터를 가져올 때 발생함)

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

string

출력 전용입니다. 이 버전의 데이터 세트에 대한 설명입니다. 데이터 세트로 데이터를 가져올 때 제공됩니다.
통합 필드 data_source. 데이터 세트의 데이터 소스에 관한 세부정보입니다. data_source은 다음 중 하나여야 합니다.
localFileSource

object (LocalFileSource)

단일 업로드의 데이터 세트용 로컬 파일 소스입니다.
gcsSource

object (GcsSource)

단일 업로드의 데이터 세트용 Google Cloud Storage 파일 소스입니다.

사용

사용은 데이터를 처리하는 방법을 알리는 데 데이터가 사용될 위치를 지정합니다.

열거형
USAGE_UNSPECIFIED 이 데이터 세트의 사용량이 설정되지 않았습니다.
USAGE_DATA_DRIVEN_STYLING 이 데이터 세트는 데이터 기반 스타일 지정에 사용됩니다.

LocalFileSource

데이터 소스가 로컬 파일인 경우 데이터 소스에 관한 세부정보입니다.

JSON 표현 
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
필드
filename

string

업로드된 파일의 파일 이름 및 확장자입니다.
fileFormat

enum (FileFormat)

업로드되는 파일의 형식입니다.

FileFormat

업로드되는 파일의 형식입니다.

열거형
FILE_FORMAT_UNSPECIFIED 지정되지 않은 파일 형식입니다.
FILE_FORMAT_GEOJSON GeoJson 파일
FILE_FORMAT_KML KML 파일.
FILE_FORMAT_CSV CSV 파일로 다운로드할 수 있습니다.

GcsSource

Google Cloud Storage에 있는 데이터 소스에 관한 세부정보입니다.

JSON 표현 
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
필드
inputUri

string

소스 데이터 URI 예를 들면 gs://my_bucket/my_object입니다.
fileFormat

enum (FileFormat)

Google Cloud Storage 객체의 파일 형식입니다. 주로 유효성 검사에 사용됩니다.

상태

데이터 세트 버전의 상태입니다.

JSON 표현 
{
  "state": enum (State),
  "errorMessage": string
}
필드
state

enum (State)

상태에 대한 상태 enum입니다.
errorMessage

string

실패 이유를 나타내는 오류 메시지 데이터 세트가 실패 상태가 아닌 경우 비어 있습니다.

주

데이터 세트 버전의 상태 목록입니다. 여기서 값을 수정하면 상태 유틸리티 메서드를 업데이트하는 것이 좋습니다.

열거형
STATE_UNSPECIFIED 이 데이터 세트의 상태가 설정되지 않았습니다.
STATE_IMPORTING 데이터 세트 버전을 가져오는 중입니다.
STATE_IMPORT_SUCCEEDED 데이터 세트 버전을 성공적으로 가져왔습니다.
STATE_IMPORT_FAILED 데이터 세트 버전을 가져올 수 없습니다.
STATE_DELETING 데이터 세트를 삭제하는 중입니다.
STATE_DELETION_FAILED 삭제 실패 상태입니다. 이 상태는 데이터 세트 삭제가 실패했음을 나타냅니다. 삭제가 다시 시도될 수 있습니다.
STATE_PROCESSING 처리 상태입니다. 이 상태는 파생 데이터 세트와 데이터 세트의 초기 일치 및 처리를 나타냅니다.
STATE_PROCESSING_FAILED 처리 실패 상태입니다. 이 상태는 처리에 실패했으며 오류가 보고될 수 있음을 나타냅니다.
STATE_NEEDS_REVIEW 검토 필요 상태입니다. 이 상태는 데이터를 게시하고 특정 용도에 제공할 수 있음을 나타냅니다.
STATE_PUBLISHING 게시 상태입니다. 이 상태는 게시가 진행 중임을 나타냅니다.
STATE_PUBLISHING_FAILED 게시 실패 상태입니다. 이 상태는 게시에 실패했음을 나타냅니다. 게시를 다시 시도할 수 있습니다.
STATE_COMPLETED 완료된 상태입니다. 이 상태는 특정 용도로 사용할 수 있는 데이터 세트를 나타냅니다.

메서드

create

 지정된 프로젝트의 새 데이터 세트를 만듭니다.

delete

 지정된 데이터 세트를 삭제합니다.

get

 데이터 세트를 가져옵니다.

list

 지정된 프로젝트의 모든 데이터 세트를 나열합니다.

patch

 데이터 세트의 메타데이터를 업데이트합니다.