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 למערך הנתונים לצורך ייבוא חד-פעמי.

גוף התשובה

אובייקט התגובה של media.upload.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "name": string
}
שדות
name

string

חובה. שם המשאב של הגרסה החדשה של מערך הנתונים שנוצרה. פורמט: projects/{project}/datasets/{datasetId}@{versionId}

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

הרשאות IAM

נדרשת הרשאת ה-IAM הבאה במשאב name:

  • mapsplatformdatasets.datasets.import

מידע נוסף זמין במאמרי העזרה של IAM.