ה-Data Datasets API נמצא כרגע בתצוגה מקדימה (pre-GA). יכול להיות שהתמיכה בתכונות ובמוצרים טרום-GA תהיה מוגבלת. לכן, ייתכן ששינויים בתכונות ובמוצרים לפני טרום-GA לא יתאימו לגרסאות אחרות של טרום-GA. מוצרים במצב טרום-GA כפופים לתנאים הספציפיים לשירות הפלטפורמה של מפות Google. מידע נוסף זמין בקטע תיאורים של שלבי ההשקה.

דף זה תורגם על ידי Cloud Translation API.

REST Resource: projects.datasets

משאב: מערך נתונים
- ייצוג JSON
שימוש
LocalFileSource
- ייצוג JSON
FileFormat
GcsSource
- ייצוג JSON
סטטוס
- ייצוג JSON
מדינה
שיטות

משאב: מערך נתונים

ייצוג של מערך נתונים מפלטפורמת מפות.

ייצוג JSON

ייצוג 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,
  "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` שם קריא לבני אדם, מוצג בממשק המשתמש של המסוף .
`description`	`string` תיאור של מערך הנתונים הזה .
`versionId`	`string` מזהה הגרסה של מערך הנתונים.
`usage[]`	`enum (Usage)` תרחישים לדוגמה למערך הנתונים הזה.
`status`	`object (Status)` פלט בלבד. הסטטוס של גרסת מערך הנתונים הזו.
`createTime`	`string (Timestamp format)` פלט בלבד. השעה שבה מערך הנתונים נוצר לראשונה. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: `"2014-10-02T15:01:23Z"` ו-`"2014-10-02T15:01:23.045123456Z"`.
`updateTime`	`string (Timestamp format)` פלט בלבד. השעה שבה עודכנו לאחרונה המטא-נתונים של מערך הנתונים. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: `"2014-10-02T15:01:23Z"` ו-`"2014-10-02T15:01:23.045123456Z"`.
`versionCreateTime`	`string (Timestamp format)` פלט בלבד. השעה שבה נוצרה הגרסה הזו של מערך הנתונים. (זה קרה כשמייבאים נתונים למערך הנתונים) חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: `"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 של מערך הנתונים להעלאה יחידה.

Usage

ההגדרה 'שימוש' קובעת איפה הנתונים ישמשו לצורך עיבוד הנתונים.

טיפוסים בני מנייה (enums)
`USAGE_UNSPECIFIED`	השימוש במערך הנתונים הזה לא הוגדר.
`USAGE_DATA_DRIVEN_STYLING`	מערך הנתונים הזה ישמש לעיצוב מבוסס-נתונים.

LocalFileSource

הפרטים על מקור הנתונים כאשר הוא קובץ מקומי.

ייצוג JSON
{ "filename": string, "fileFormat": enum (`FileFormat`) }

שדות

שדות
`filename`	`string` שם הקובץ והסיומת של הקובץ שהועלה.
`fileFormat`	`enum (FileFormat)` הפורמט של הקובץ שמועלה כרגע.

filename

string

שם הקובץ והסיומת של הקובץ שהועלה.

fileFormat

enum (FileFormat)

הפורמט של הקובץ שמועלה כרגע.

FileFormat

הפורמט של הקובץ שמועלה כרגע.

טיפוסים בני מנייה (enums)
`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. משמש בעיקר לאימות.

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` הודעת שגיאה שמציינת את סיבת הכשל. השדה ריק אם מערכי הנתונים לא במצב נכשל.

state

enum (State)

סטטוס: 'טיפוסים בני מנייה (enum)'.

errorMessage

string

הודעת שגיאה שמציינת את סיבת הכשל. השדה ריק אם מערכי הנתונים לא במצב נכשל.

ארץ

רשימת מצבים למערך הנתונים.

טיפוסים בני מנייה (enums)
`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`	מעדכנים את המטא-נתונים של מערך הנתונים.

REST Resource: projects.datasets

משאב: מערך נתונים

Usage

LocalFileSource

FileFormat

GcsSource

סטטוס

ארץ

שיטות

`create`

`delete`

`get`

`list`

`patch`