REST Resource: projects.datasets

ทรัพยากร: ชุดข้อมูล

การนำเสนอชุดข้อมูลแพลตฟอร์มแผนที่

การแสดง 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

รหัสเวอร์ชันของชุดข้อมูล
usage[]

enum (Usage)

Use Case ที่ระบุสำหรับชุดข้อมูลนี้
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)

แหล่งที่มาของไฟล์ Google Cloud Storage สำหรับชุดข้อมูลสำหรับการอัปโหลดครั้งเดียว

การใช้งาน

การใช้งานจะระบุตำแหน่งที่จะใช้ข้อมูลเพื่อบอกถึงวิธีประมวลผลข้อมูล

Enum
USAGE_UNSPECIFIED ไม่ได้ตั้งค่าการใช้งานชุดข้อมูลนี้
USAGE_DATA_DRIVEN_STYLING ชุดข้อมูลนี้จะใช้สำหรับการจัดรูปแบบโดยอิงตามข้อมูล

LocalFileSource

รายละเอียดเกี่ยวกับแหล่งข้อมูลเมื่อเป็นไฟล์ในเครื่อง

การแสดง JSON 
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
ช่อง
filename

string

ชื่อและนามสกุลของไฟล์ที่อัปโหลด
fileFormat

enum (FileFormat)

รูปแบบของไฟล์ที่อัปโหลด

FileFormat

รูปแบบของไฟล์ที่อัปโหลด

Enum
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)

enum ของรัฐสำหรับสถานะ
errorMessage

string

ข้อความแสดงข้อผิดพลาดที่ระบุสาเหตุของความล้มเหลว ช่องนี้จะว่างเปล่าหากชุดข้อมูลไม่ได้อยู่ในสถานะ "ไม่สําเร็จ"

รัฐ

รายการสถานะสำหรับเวอร์ชันชุดข้อมูล หากมีการแก้ไขค่าที่นี่ ให้พิจารณาอัปเดตเมธอดยูทิลิตีสถานะ

Enum
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

 อัปเดตข้อมูลเมตาของชุดข้อมูล