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

مطلوبة. اسم المورد، المشاريع/{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

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

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

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

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

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

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

  • mapsplatformdatasets.datasets.import

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