REST Resource: projects.datasets

リソース: Dataset

Maps Platform データセットの表現。

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)

1 回のアップロードで使用する、データセットの 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 追加することもできます。

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

 データセットのメタデータを更新します。