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

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