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

ชื่อทรัพยากร, โปรเจ็กต์/{project}/datasets/{dataset_id}
displayName

string

ชื่อที่มนุษย์อ่านได้ แสดงใน UI ของคอนโซล
description

string

คำอธิบายของชุดข้อมูลนี้
versionId

string

รหัสเวอร์ชันของชุดข้อมูล
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)

แหล่งที่มาของไฟล์ 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

 อัปเดตข้อมูลเมตาสำหรับชุดข้อมูล