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}/مجموعات البيانات/{dataset_id}
displayName

string

اسم يمكن لشخص عادي قراءته، يظهر في واجهة مستخدم وحدة التحكم .
description

string

وصف مجموعة البيانات هذه .
versionId

string

تمثّل هذه السمة معرّف إصدار مجموعة البيانات.
usage[]

enum (Usage)

حالات الاستخدام المحددة لمجموعة البيانات هذه.
status

object (Status)

النتائج فقط. تمثّل هذه السمة حالة إصدار مجموعة البيانات هذا.
createTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه إنشاء مجموعة البيانات لأول مرة.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه آخر تعديل للبيانات الوصفية لمجموعة البيانات.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
versionCreateTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه إنشاء هذه النسخة من مجموعة البيانات. (حدث ذلك عند استيراد البيانات إلى مجموعة البيانات)

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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_UNSPECIFIED لم يتم ضبط استخدام مجموعة البيانات هذه.
USAGE_DATA_DRIVEN_STYLING وسيتم استخدام مجموعة البيانات هذه للنمط المستند إلى البيانات.

LocalFileSource

التفاصيل المتعلّقة بمصدر البيانات عندما يكون ملفًا محليًا.

تمثيل JSON 
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
الحقول
filename

string

اسم الملف الذي تم تحميله وامتداده
fileFormat

enum (FileFormat)

تمثّل هذه السمة تنسيق الملف الذي يتم تحميله.

FileFormat

تمثّل هذه السمة تنسيق الملف الذي يتم تحميله.

عمليات التعداد
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)

تعداد الحالة للحالة
errorMessage

string

رسالة خطأ توضح سبب عدم التنفيذ. وتكون فارغة إذا لم تكن مجموعات البيانات في حالة فشل.

الحالة

قائمة بالحالات لمجموعة البيانات.

عمليات التعداد
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

 تحديث البيانات الوصفية لمجموعة البيانات.