Method: media.upload

لاستيراد نسخة جديدة من البيانات لمجموعة البيانات.

طلب HTTP

  • تحميل عنوان URI، لطلبات تحميل الوسائط:
    POST https://mapsplatformdatasets.googleapis.com/upload/v1alpha/{name=projects/*/datasets/*}:import
  • معرّف الموارد المنتظم (URI) للبيانات الوصفية لطلبات البيانات الوصفية فقط:
    POST https://mapsplatformdatasets.googleapis.com/v1alpha/{name=projects/*/datasets/*}:import

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
name

string

مطلوب. اسم المورد، المشاريع/{project}/مجموعات البيانات/{dataset_id}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "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.
}
الحقول
versionDescription

string

وصف للبيانات الجديدة التي يتم استيرادها
حقل الربط data_source تفاصيل عن مصدر البيانات الخاصة بمجموعة البيانات يمكن أن يكون data_source واحدًا فقط مما يلي:
localFileSource

object (LocalFileSource)

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

object (GcsSource)

مصدر ملف في Google Cloud Storage لمجموعة البيانات لاستيرادها مرة واحدة

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

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

تمثيل JSON 
{
  "name": string
}
الحقول
name

string

مطلوب. اسم المورد لإصدار مجموعة البيانات الذي تم إنشاؤه حديثًا، projects/{project}/datasets/{dataset_id}@{versionId}

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform

أذونات "إدارة الهوية وإمكانية الوصول"

يتطلب هذا الإجراء الحصول على إذن إدارة الهوية وإمكانية الوصول التالي في مورد name:

  • mapsplatformdatasets.datasets.import

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات إدارة الهوية وإمكانية الوصول.