Method: media.upload

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

Requête HTTP

  • URI d'importation, pour les requêtes 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, projects/{project}/datasets/{dataset_id}

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)

Un fichier source local pour l'ensemble de données, pour une importation unique.
gcsSource

object (GcsSource)

Un fichier source Google Cloud Storage pour l'ensemble de données, pour une importation unique.

Corps de la réponse

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

Réponse de l'importation d'une nouvelle version de l'ensemble de données.

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

string

Obligatoire. Nom de ressource de la nouvelle version de l'ensemble de données : projects/{project}/datasets/{dataset_id}@{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.