公告：凡是在 2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須驗證非商業用途資格，才能繼續存取 Earth Engine。

本頁面由 Cloud Translation API 翻譯而成。

Method: projects.table.import

匯入資料表。

HTTP 要求

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/table:import

這個網址使用 gRPC 轉碼語法。

路徑參數

參數

參數
`project`	`string` 應視為此要求服務用戶的 Google Cloud Platform 專案專案 ID 或專案編號。格式為 `projects/{project-id}`。授權需要指定資源 `project` 的下列 IAM 權限： `earthengine.assets.create`

project

string

應視為此要求服務用戶的 Google Cloud Platform 專案專案 ID 或專案編號。格式為 projects/{project-id}。

授權需要指定資源 project 的下列 IAM 權限：

earthengine.assets.create

要求主體

要求主體的資料會採用以下結構：

JSON 表示法
{ "tableManifest": { object (`TableManifest`) }, "description": string, "overwrite": boolean, "requestId": string }

欄位
`tableManifest`	`object (TableManifest)` 表格資訊清單。
`description`	`string` 任務的使用者可讀名稱。
`overwrite`	`boolean` 是否允許覆寫現有資產。
`requestId`	`string` 用於偵測重複要求的不重複字串。如果同一位使用者使用相同的非空白 `requestId` 提出多個要求，只有其中一個要求才能成功啟動長時間執行作業。`requestId` 可包含 a..z、A..Z、0-9 或「-」字元。`requestId` 的長度上限為 60 個半形字元。

回應主體

如果成功，回應主體會包含 Operation 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform

詳情請參閱 OAuth 2.0 Overview。

TableManifest

說明 Earth Engine 服務應如何從一組檔案組合成資料表。

JSON 表示法

JSON 表示法
{ "name": string, "properties": { object }, "uriPrefix": string, "sources": [ { object (`TableSource`) } ], "startTime": string, "endTime": string, "csvColumnDataTypeOverrides": { string: enum (`CsvColumnDataType`), ... }, "columnDataTypeOverrides": { string: enum (`ColumnDataType`), ... }, "memo": string }

{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "sources": [
    {
      object (TableSource)
    }
  ],
  "startTime": string,
  "endTime": string,
  "csvColumnDataTypeOverrides": {
    string: enum (CsvColumnDataType),
    ...
  },
  "columnDataTypeOverrides": {
    string: enum (ColumnDataType),
    ...
  },
  "memo": string
}

欄位
`name`	`string` 要建立的素材資源名稱。`name` 的格式為「projects//assets/*」(例如「projects/earthengine-legacy/assets/users//」)。所有使用者擁有的素材資源都屬於「earthengine-legacy」專案 (例如「projects/earthengine-legacy/assets/users/foo/bar」)。所有其他素材資源都屬於「earthengine-public」專案 (例如「projects/earthengine-public/assets/LANDSAT」)。
`properties`	`object (Struct format)` 資產的其他屬性。「system:time_start」和「system:time_end」屬性名稱已淘汰。請改用 `startTime` 和 `endTime` 欄。
`uriPrefix`	`string` 在這個資訊清單中定義的所有 `uri` 前方加上的選用前置字串。
`sources[]`	`object (TableSource)` 這個表格所包含的來源。
`startTime`	`string (Timestamp format)` 與素材資源相關聯的時間戳記 (如有)，例如衛星圖像拍攝時間。如果素材資源對應的時間間隔為一個月或一年的平均值，這個時間戳記就會對應到該時間間隔的開始時間。使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如：`"2014-10-02T15:01:23Z"`、`"2014-10-02T15:01:23.045123456Z"` 或 `"2014-10-02T15:01:23+05:30"`。
`endTime`	`string (Timestamp format)` 如果資產對應的時間間隔為一週或一年，則這個時間戳記對應的時間點為該時間間隔的結束時間 (不含)。使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如：`"2014-10-02T15:01:23Z"`、`"2014-10-02T15:01:23.045123456Z"` 或 `"2014-10-02T15:01:23+05:30"`。
`csvColumnDataTypeOverrides (deprecated)`	`map (key: string, value: enum (CsvColumnDataType))` 這個項目已遭淘汰！請改用 columnDataTypeOverrides。這個物件中包含 `"key": value` 組合的清單，範例：`{ "name": "wrench", "mass": "1.3kg", "count": "3" }`。
`columnDataTypeOverrides`	`map (key: string, value: enum (ColumnDataType))` 將資料欄名稱與該欄要使用的類型對應起來的對應項目。系統會推斷未在此處指定的欄型別，例如數字欄會變成數字，WKT 欄會變成幾何圖形等等。這個物件中包含 `"key": value` 組合的清單，範例：`{ "name": "wrench", "mass": "1.3kg", "count": "3" }`。
`memo`	`string` 自由格式欄位，用於儲存使用者附註。不會用於擷取。

TableSource

資料表檔案。

JSON 表示法
{ "uris": [ string ], "charset": string, "maxErrorMeters": number, "maxVertices": integer, "crs": string, "geodesic": boolean, "primaryGeometryColumn": string, "xColumn": string, "yColumn": string, "dateFormat": string, "csvDelimiter": string, "csvQualifier": string }