REST Resource: projects.datasets

Risorsa: set di dati

Una rappresentazione di un set di dati della piattaforma Maps.

Rappresentazione JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "versionId": string,
  "usage": [
    enum (Usage)
  ],
  "status": {
    object (Status)
  },
  "createTime": string,
  "updateTime": string,
  "versionCreateTime": string,
  "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.
}
Campi
name

string

Nome della risorsa, projects/{project}/datasets/{dataset_id}
displayName

string

Nome leggibile, visualizzato nell'interfaccia utente della console .
description

string

Una descrizione di questo set di dati.
versionId

string

L'ID versione del set di dati.
usage[]

enum (Usage)

Casi d'uso specificati per questo set di dati.
status

object (Status)

Solo output. Lo stato della versione di questo set di dati.
createTime

string (Timestamp format)

Solo output. Data e ora di creazione del set di dati.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo output. Ora dell'ultimo aggiornamento dei metadati del set di dati.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
versionCreateTime

string (Timestamp format)

Solo output. Ora in cui è stata creata questa versione del set di dati. (È successo durante l'importazione dei dati nel set di dati)

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
versionDescription

string

Solo output. La descrizione di questa versione del set di dati. Viene fornito durante l'importazione dei dati nel set di dati.
Campo unione data_source. Dettagli sull'origine dei dati del set di dati. data_source può essere solo uno dei seguenti:
localFileSource

object (LocalFileSource)

Un'origine file locale per il set di dati per un singolo caricamento.
gcsSource

object (GcsSource)

Un'origine file Google Cloud Storage per il set di dati per un singolo caricamento.

Utilizzo

La sezione Utilizzo specifica dove è previsto l'utilizzo dei dati per indicare come elaborarli.

Enum
USAGE_UNSPECIFIED L'utilizzo di questo set di dati non è impostato.
USAGE_DATA_DRIVEN_STYLING Questo set di dati verrà utilizzato per gli stili basati sui dati.

LocalFileSource

Dettagli sull'origine dati, se si tratta di un file locale.

Rappresentazione JSON 
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Campi
filename

string

Il nome e l'estensione del file caricato.
fileFormat

enum (FileFormat)

Il formato del file in fase di caricamento.

FileFormat

Il formato del file in fase di caricamento.

Enum
FILE_FORMAT_UNSPECIFIED Formato file non specificato.
FILE_FORMAT_GEOJSON GeoJson.
FILE_FORMAT_KML file KML.
FILE_FORMAT_CSV .CSV.

GcsSource

I dettagli dell'origine dati quando si trova in Google Cloud Storage.

Rappresentazione JSON 
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Campi
inputUri

string

URI dei dati di origine. Ad esempio, gs://my_bucket/my_object.
fileFormat

enum (FileFormat)

Il formato del file dell'oggetto Google Cloud Storage. Viene utilizzato principalmente per la convalida.

Stato

Stato della versione del set di dati.

Rappresentazione JSON 
{
  "state": enum (State),
  "errorMessage": string
}
Campi
state

enum (State)

Enum dello stato.
errorMessage

string

Messaggio di errore che indica il motivo dell'errore. È vuoto se i set di dati non sono in stato di errore.

Stato

Un elenco di stati per la versione del set di dati. Se i valori vengono modificati qui, valuta la possibilità di aggiornare i metodi di utilità Status.

Enum
STATE_UNSPECIFIED Lo stato di questo set di dati non è impostato.
STATE_IMPORTING È in corso l'importazione della versione del set di dati.
STATE_IMPORT_SUCCEEDED La versione del set di dati è stata importata correttamente.
STATE_IMPORT_FAILED Impossibile importare la versione del set di dati.
STATE_DELETING Il set di dati è in fase di eliminazione.
STATE_DELETION_FAILED Lo stato di eliminazione non riuscita. Questo stato indica che l'eliminazione del set di dati non è riuscita. L'eliminazione potrebbe essere riprovata.
STATE_PROCESSING Lo stato di elaborazione. Questo stato rappresenta la corrispondenza e l'elaborazione iniziali dei set di dati in set di dati derivati.
STATE_PROCESSING_FAILED Lo stato di elaborazione non riuscita. Questo stato indica che l'elaborazione non è riuscita e potrebbe segnalare errori.
STATE_NEEDS_REVIEW Lo stato che richiede una revisione. Questo stato indica che i dati sono disponibili per la pubblicazione e la pubblicazione in base all'utilizzo specifico.
STATE_PUBLISHING Lo stato di pubblicazione. Questo stato indica che la pubblicazione è in corso.
STATE_PUBLISHING_FAILED Stati di pubblicazione non riuscita. Questo stato indica che la pubblicazione non è riuscita. La pubblicazione potrebbe essere riprovata.
STATE_COMPLETED Lo stato completato. Questo stato indica che il set di dati è disponibile per il relativo utilizzo specifico.

Metodi

create

 Crea un nuovo set di dati per il progetto specificato.

delete

 Elimina il set di dati specificato .

get

 Recupera il set di dati.

list

 Elenca tutti i set di dati per il progetto specificato.

patch

 Aggiorna i metadati del set di dati.