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

直观易懂的名称，显示在控制台界面中。
description

string

此数据集的说明。
versionId

string

数据集的版本 ID。
usage[]

enum (Usage)

此数据集的指定用例。
status

object (Status)

仅限输出。此数据集版本的状态。
createTime

string (Timestamp format)

仅限输出。首次创建数据集的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

仅限输出。数据集元数据的上次更新时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
versionCreateTime

string (Timestamp format)

仅限输出。创建此版本数据集的时间。（将数据导入到数据集时发生）

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："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)

状态的状态枚举。
errorMessage

string

指明失败原因的错误消息。如果数据集未处于失败状态，则此字段为空。

州

数据集版本的状态列表。如果在此处修改了值，请考虑更新 Status 实用程序方法。

枚举
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

 更新数据集的元数据。