Method: media.upload

Importa una versión nueva de los datos para el conjunto de datos.

Solicitud HTTP

  • URI de carga para solicitudes de carga de contenido multimedia:
    POST https://mapsplatformdatasets.googleapis.com/upload/v1/{name=projects/*/datasets/*}:import
  • URI de metadatos, para solicitudes solo de metadatos:
    POST https://mapsplatformdatasets.googleapis.com/v1/{name=projects/*/datasets/*}:import

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. Nombre del recurso. Formato: projects/{project}/datasets/{datasetId}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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.
}
Campos
versionDescription

string

Una descripción de los datos nuevos que se importan.

Campo de unión data_source. Detalles sobre la fuente de los datos para el conjunto de datos. Las direcciones (data_source) solo pueden ser una de las siguientes opciones:
localFileSource

object (LocalFileSource)

Una fuente de archivo local para el conjunto de datos para una importación única.

gcsSource

object (GcsSource)

Una fuente de archivo de Google Cloud Storage para el conjunto de datos para una importación única.

Cuerpo de la respuesta

Objeto de respuesta de media.upload.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "name": string
}
Campos
name

string

Obligatorio. Nombre del recurso de la versión del conjunto de datos recién creado. Formato: projects/{project}/datasets/{datasetId}@{versionId}

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • mapsplatformdatasets.datasets.import

Para obtener más información, consulta la documentación de IAM.