Method: media.upload

Importe une nouvelle version des données pour l'ensemble de données.

Requête HTTP

  • URI d'importation pour les demandes d'importation de médias:
    POST https://mapsplatformdatasets.googleapis.com/upload/v1/{name=projects/*/datasets/*}:import
  • URI de métadonnées, pour les requêtes ne contenant que des métadonnées:
    POST https://mapsplatformdatasets.googleapis.com/v1/{name=projects/*/datasets/*}:import

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de la ressource. Format: projects/{project}/datasets/{datasetId}

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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.
}
Champs
versionDescription

string

Description des nouvelles données importées.
Champ d'union data_source. Détails sur la source des données de l'ensemble de données. data_source ne peut être qu'un des éléments suivants :
localFileSource

object (LocalFileSource)

Source de fichiers locale de l'ensemble de données pour une importation unique.
gcsSource

object (GcsSource)

Une source de fichiers Google Cloud Storage pour l'ensemble de données pour une importation unique.

Corps de la réponse

Objet de réponse de media.upload.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "name": string
}
Champs
name

string

Obligatoire. Nom de ressource de la version de l'ensemble de données nouvellement créé. Format: projects/{project}/datasets/{datasetId}@{versionId}

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • mapsplatformdatasets.datasets.import

Pour en savoir plus, consultez la documentation IAM.