REST Resource: projects.datasets

Tài nguyên: Tập dữ liệu

Biểu thị tập dữ liệu của nền tảng Maps.

Biểu diễn dưới dạng 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.
}
Trường
name

string

Tên tài nguyên, dự án/{project}/datasets/{dataset_id}
displayName

string

Tên dễ đọc, hiển thị trong giao diện người dùng của bảng điều khiển.
description

string

Mô tả của tập dữ liệu này .
versionId

string

Mã phiên bản của tập dữ liệu.
usage[]

enum (Usage)

(Các) trường hợp sử dụng đã chỉ định cho tập dữ liệu này.
status

object (Status)

Chỉ có đầu ra. Trạng thái của phiên bản tập dữ liệu này.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tập dữ liệu được tạo lần đầu tiên.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian cập nhật siêu dữ liệu của tập dữ liệu gần đây nhất.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
versionCreateTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tạo phiên bản tập dữ liệu này. (Đã xảy ra khi nhập dữ liệu vào tập dữ liệu)

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
versionDescription

string

Chỉ có đầu ra. Nội dung mô tả cho phiên bản tập dữ liệu này. Giá trị này được cung cấp khi nhập dữ liệu vào tập dữ liệu.
Trường hợp hợp nhất data_source. Thông tin chi tiết về nguồn dữ liệu của tập dữ liệu. data_source chỉ có thể là một trong những trạng thái sau đây:
localFileSource

object (LocalFileSource)

Một nguồn tệp cục bộ cho tập dữ liệu cho một lượt tải lên.
gcsSource

object (GcsSource)

Nguồn tệp Google Cloud Storage cho tập dữ liệu của một lần tải lên.

Cách sử dụng

Cách sử dụng chỉ định nơi dữ liệu sẽ được dùng để thông báo cách xử lý dữ liệu.

Enum
USAGE_UNSPECIFIED Cách sử dụng tập dữ liệu này chưa được thiết lập.
USAGE_DATA_DRIVEN_STYLING Tập dữ liệu này sẽ được dùng để định kiểu dựa trên dữ liệu.

LocalFileSource

Thông tin chi tiết về nguồn dữ liệu khi đó là một tệp cục bộ.

Biểu diễn dưới dạng JSON 
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Trường
filename

string

Tên tệp và đuôi của tệp đã tải lên.
fileFormat

enum (FileFormat)

Định dạng của tệp đang được tải lên.

FileFormat

Định dạng của tệp đang được tải lên.

Enum
FILE_FORMAT_UNSPECIFIED Định dạng tệp không được chỉ định.
FILE_FORMAT_GEOJSON Tệp GeoJson.
FILE_FORMAT_KML tệp KML.
FILE_FORMAT_CSV CSV.

GcsSource

Thông tin chi tiết về nguồn dữ liệu khi nguồn dữ liệu đó nằm trong Google Cloud Storage.

Biểu diễn dưới dạng JSON 
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Trường
inputUri

string

URI dữ liệu nguồn. Ví dụ: gs://my_bucket/my_object.
fileFormat

enum (FileFormat)

Định dạng tệp của đối tượng Google Cloud Storage. Thông tin này chủ yếu được dùng để xác thực.

Trạng thái

Trạng thái của phiên bản tập dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "state": enum (State),
  "errorMessage": string
}
Trường
state

enum (State)

Enum trạng thái của trạng thái.
errorMessage

string

Thông báo lỗi cho biết lý do không thành công. Giá trị này sẽ trống nếu tập dữ liệu không ở trạng thái không thành công.

Tiểu bang

Danh sách các trạng thái của phiên bản tập dữ liệu. Nếu các giá trị được sửa đổi tại đây, hãy cân nhắc cập nhật các phương thức tiện ích Trạng thái.

Enum
STATE_UNSPECIFIED Trạng thái của tập dữ liệu này chưa được đặt.
STATE_IMPORTING Phiên bản tập dữ liệu đang được nhập.
STATE_IMPORT_SUCCEEDED Phiên bản tập dữ liệu đã được nhập thành công.
STATE_IMPORT_FAILED Không nhập được phiên bản tập dữ liệu.
STATE_DELETING Tập dữ liệu đang trong quá trình xoá.
STATE_DELETION_FAILED Trạng thái xoá không thành công. Trạng thái này cho biết không xoá được tập dữ liệu. Có thể thử xoá lại.
STATE_PROCESSING Trạng thái xử lý. Trạng thái này thể hiện quá trình so khớp và xử lý ban đầu của các tập dữ liệu với các tập dữ liệu phái sinh.
STATE_PROCESSING_FAILED Trạng thái xử lý không thành công. Trạng thái này thể hiện rằng quá trình xử lý không thành công và có thể báo cáo lỗi.
STATE_NEEDS_REVIEW Trạng thái xem xét nhu cầu. Trạng thái này thể hiện rằng dữ liệu có sẵn để xuất bản và phân phát cho mục đích sử dụng cụ thể.
STATE_PUBLISHING Trạng thái xuất bản. Trạng thái này thể hiện rằng quá trình xuất bản đang diễn ra.
STATE_PUBLISHING_FAILED Trạng thái không xuất bản được. Trạng thái này thể hiện rằng không xuất bản được. Bạn có thể thử xuất bản lại.
STATE_COMPLETED Trạng thái hoàn tất. Trạng thái này cho biết tập dữ liệu có sẵn để sử dụng cho mục đích cụ thể.

Phương thức

create

 Tạo một tập dữ liệu mới cho dự án đã chỉ định.

delete

 Xoá tập dữ liệu đã chỉ định.

get

 Nhận tập dữ liệu.

list

 Liệt kê tất cả các tập dữ liệu cho dự án đã chỉ định.

patch

 Cập nhật siêu dữ liệu cho tập dữ liệu.