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 Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
name

string

مورد نیاز. نام منبع، پروژه‌ها/{project}/datasets/{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}/datasets/{dataset_id}@{versionId}

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

مجوزهای IAM

به مجوز IAM زیر در منبع name نیاز دارد:

  • mapsplatformdatasets.datasets.import

برای اطلاعات بیشتر، به مستندات IAM مراجعه کنید.