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 משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
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

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

היקפי הרשאות

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

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

הרשאות IAM

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

  • mapsplatformdatasets.datasets.import

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