REST Resource: projects.datasets

المورد: مجموعة بيانات

تمثيل لمجموعة بيانات من "منصّة خرائط Google"

تمثيل 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

عنوان URL للبيانات المصدر مثلاً: 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

 عدِّل البيانات الوصفية لمجموعة البيانات.