Method: media.upload

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

طلب HTTP

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

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

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

المعلمات
name

string

مطلوبة. اسم المورد. التنسيق: projects/{project}/datasets/{datasetId}

نص الطلب

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

تمثيل 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/{datasetId}@{versionId}

نطاقات الأذونات

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

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

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

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

  • mapsplatformdatasets.datasets.import

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