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 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

僅供輸出。上次更新資料集中繼資料的時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
versionCreateTime

string (Timestamp format)

僅供輸出。這個資料集版本的建立時間。(將資料匯入資料集時發生)

RFC3339 世界標準時間「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)

狀態列舉。
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

 更新資料集的中繼資料。