公告：所有在 2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须验证是否符合非商业性质的资格条件，才能继续使用 Earth Engine。如果您在 2025 年 9 月 26 日之前未完成验证，您的访问权限可能会被暂停。

此页面由 Cloud Translation API 翻译。

Method: projects.table.import

导入表。

HTTP 请求

POST https://earthengine.googleapis.com/v1/{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

介绍 EarthEngine 服务应如何根据一组文件组合表。

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 }