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 por humanos, que se muestra en la IU de la consola .
description

string

Una descripción de este conjunto de datos.
versionId

string

Es el ID de la 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. Es la hora en la que se creó el conjunto de datos por primera vez.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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 en la que se actualizaron por última vez los metadatos del conjunto de datos.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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 una 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 importas datos al conjunto de datos.
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)

Es una fuente de archivos local para el conjunto de datos de una sola carga.
gcsSource

object (GcsSource)

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

Uso

El uso especifica dónde se usarán los datos para informar cómo procesarlos.

Enumeraciones
USAGE_UNSPECIFIED No se configuró 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

Los detalles de la fuente de datos cuando se trata de 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

Es el formato del archivo que se sube.

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

GcsSource

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

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

string

Es el URI de los datos de origen. Por ejemplo, gs://my_bucket/my_object.
fileFormat

enum (FileFormat)

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

Estado

Estado de la versión 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. Está vacío si los conjuntos de datos no están en un estado de error.

Estado

Una lista de estados para la versión del conjunto de datos. Si los valores se modifican aquí, considera actualizar los métodos de utilidad de estado.

Enumeraciones
STATE_UNSPECIFIED No se estableció el estado de este conjunto de datos.
STATE_IMPORTING Se está importando la versión del conjunto de datos.
STATE_IMPORT_SUCCEEDED Se importó correctamente la versión del conjunto de datos.
STATE_IMPORT_FAILED No se pudo importar la versión del conjunto de datos.
STATE_DELETING El conjunto de datos está en proceso de eliminación.
STATE_DELETION_FAILED El estado de eliminación falló. Este estado indica que no se pudo borrar el conjunto de datos. Se puede reintentar la eliminación.
STATE_PROCESSING Es el estado de procesamiento. Este estado representa la coincidencia y el procesamiento iniciales de los conjuntos de datos con los conjuntos de datos derivados.
STATE_PROCESSING_FAILED El estado de procesamiento falló. Este estado indica que el procesamiento falló y puede informar errores.
STATE_NEEDS_REVIEW El estado de revisión de necesidades. Este estado representa que los datos están disponibles para publicarse y entregarse al uso específico.
STATE_PUBLISHING El estado de publicación. Este estado indica que la publicación está en curso.
STATE_PUBLISHING_FAILED Estados de la publicación fallida Este estado indica que la publicación falló. Se puede reintentar la publicación.
STATE_COMPLETED 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 para el conjunto de datos.