REST Resource: projects.datasets

Recurso: Dataset

Representación de un conjunto de datos de Maps Platform.

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

string

Nombre del recurso, projects/{project}/datasets/{dataset_id}

displayName

string

Nombre legible que se muestra en la IU de la consola .

description

string

Es una descripción de este conjunto de datos .

versionId

string

El ID de versión del conjunto de datos.

usage[]

enum (Usage)

Casos de uso especificados para este conjunto de datos.

status

object (Status)

Solo salida. Es el estado de esta versión del conjunto de datos.

createTime

string (Timestamp format)

Solo salida. Hora en la que se creó el conjunto de datos por primera vez.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo salida. Hora a la que se actualizaron por última vez los metadatos del conjunto de datos.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

versionCreateTime

string (Timestamp format)

Solo salida. Hora en la que se creó esta versión del conjunto de datos. (Ocurrió cuando se importaban datos al conjunto de datos)

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

versionDescription

string

Solo salida. La descripción de esta versión del conjunto de datos. Se proporciona cuando se importan datos al conjunto de datos.

Campo de unión data_source. Detalles sobre la fuente de los datos del 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 en una sola carga.

gcsSource

object (GcsSource)

Una fuente de archivo de Google Cloud Storage para el conjunto de datos en una sola carga.

Uso

El uso especifica dónde se deben usar los datos para informar cómo se deben procesar.

Enumeradores
USAGE_UNSPECIFIED No se estableció el uso de este conjunto de datos.
USAGE_DATA_DRIVEN_STYLING Este conjunto de datos se usará para el diseño basado en datos.

LocalFileSource

Son los detalles sobre la fuente de datos cuando es un archivo local.

Representación JSON
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Campos
filename

string

Es el nombre y la extensión del archivo subido.

fileFormat

enum (FileFormat)

El formato del archivo que se sube.

FileFormat

El formato del archivo que se sube.

Enumeradores
FILE_FORMAT_UNSPECIFIED Formato de archivo no especificado.
FILE_FORMAT_GEOJSON GeoJson.
FILE_FORMAT_KML Archivo KML.
FILE_FORMAT_CSV .CSV.

GcsSource

Los detalles sobre la fuente de datos cuando se encuentra en Google Cloud Storage.

Representación JSON
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Campos
inputUri

string

URI de datos de origen. Por ejemplo, gs://my_bucket/my_object.

fileFormat

enum (FileFormat)

El formato de archivo del objeto de Google Cloud Storage. Se usa principalmente para la validación.

Estado

Estado del conjunto de datos.

Representación JSON
{
  "state": enum (State),
  "errorMessage": string
}
Campos
state

enum (State)

Es una enumeración de estado para el estado.

errorMessage

string

Mensaje de error que indica el motivo del error. Estará vacío si los conjuntos de datos no tienen un estado de error.

Estado

Es una lista de estados para el conjunto de datos.

Enumeradores
STATE_UNSPECIFIED No se estableció el estado de este conjunto de datos.
STATE_IMPORTING Se están importando los datos a un conjunto de datos.
STATE_IMPORT_SUCCEEDED Los datos se importaron a un conjunto de datos correctamente.
STATE_IMPORT_FAILED No se pudieron importar los datos a un conjunto de datos.
STATE_DELETING Se está borrando el conjunto de datos.
STATE_DELETION_FAILED Estado de error de eliminación. Este estado representa que no se pudo borrar el conjunto de datos. Puedes volver a intentar la eliminación.
STATE_PROCESSING Se están procesando los datos.
STATE_PROCESSING_FAILED Estado de error de procesamiento. Este estado indica que el procesamiento falló y puede informar errores.
STATE_NEEDS_REVIEW Este estado no se utiliza actualmente.
STATE_PUBLISHING Es el estado de publicación. Este estado indica que la publicación está en curso.
STATE_PUBLISHING_FAILED Los estados de publicación con errores Este estado indica que la publicación falló. Es posible que se vuelva a intentar la publicación.
STATE_COMPLETED Es el estado completo. Este estado representa el conjunto de datos disponible para su uso específico.

Métodos

create

Crea un conjunto de datos nuevo para el proyecto especificado.

delete

Borra el conjunto de datos especificado .

get

Obtén el conjunto de datos.

list

Enumera todos los conjuntos de datos del proyecto especificado.

patch

Actualiza los metadatos del conjunto de datos.