REST Resource: projects.datasets

Recurso: conjunto de dados

Uma representação de um conjunto de dados da plataforma Maps.

Representação 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

Nome do recurso, projects/{project}/datasets/{dataset_id}

displayName

string

Nome legível por humanos, mostrado na interface do console.

description

string

Uma descrição do conjunto de dados.

versionId

string

O ID da versão do conjunto de dados.

usage[]

enum (Usage)

Casos de uso especificados para este conjunto de dados.

status

object (Status)

Apenas saída. O status dessa versão do conjunto de dados.

createTime

string (Timestamp format)

Apenas saída. Hora em que o conjunto de dados foi criado pela primeira vez.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Apenas saída. Hora em que os metadados do conjunto de dados foram atualizados pela última vez.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

versionCreateTime

string (Timestamp format)

Apenas saída. Hora em que a versão do conjunto de dados foi criada. Isso aconteceu ao importar dados para o conjunto de dados.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

versionDescription

string

Apenas saída. A descrição desta versão do conjunto de dados. Ele é fornecido durante a importação de dados para o conjunto de dados.

Campo de união data_source. Detalhes sobre a origem dos dados do conjunto. data_source pode ser apenas de um dos tipos a seguir:
localFileSource

object (LocalFileSource)

Uma origem de arquivo local para o conjunto de dados de um único upload.

gcsSource

object (GcsSource)

Uma origem de arquivo do Google Cloud Storage para o conjunto de dados para um único upload.

Uso

Uso especifica onde os dados devem ser usados para informar como processá-los.

Enums
USAGE_UNSPECIFIED O uso deste conjunto de dados não está definido.
USAGE_DATA_DRIVEN_STYLING Este conjunto de dados será usado para o estilo baseado em dados.

LocalFileSource

Os detalhes sobre a fonte de dados quando ela é um arquivo local.

Representação JSON
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Campos
filename

string

O nome e a extensão do arquivo enviado.

fileFormat

enum (FileFormat)

O formato do arquivo que está sendo enviado.

FileFormat

O formato do arquivo que está sendo enviado.

Enums
FILE_FORMAT_UNSPECIFIED Formato de arquivo não especificado.
FILE_FORMAT_GEOJSON Arquivo GeoJSON.
FILE_FORMAT_KML Arquivo KML.
FILE_FORMAT_CSV arquivo CSV.

GcsSource

Detalhes sobre a fonte de dados quando ela está no Google Cloud Storage.

Representação JSON
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Campos
inputUri

string

URI dos dados de origem. Por exemplo, gs://my_bucket/my_object.

fileFormat

enum (FileFormat)

O formato do arquivo do objeto do Google Cloud Storage. Isso é usado principalmente para validação.

Status

Status da versão do conjunto de dados.

Representação JSON
{
  "state": enum (State),
  "errorMessage": string
}
Campos
state

enum (State)

Enumeração de estado para o status.

errorMessage

string

Mensagem de erro indicando o motivo da falha. Ele fica vazio se os conjuntos de dados não estiverem em um estado com falha.

Estado

Uma lista de estados para a versão do conjunto de dados. Se os valores forem modificados aqui, considere atualizar os métodos do utilitário Status.

Enums
STATE_UNSPECIFIED O estado deste conjunto de dados não está definido.
STATE_IMPORTING A versão do conjunto de dados está sendo importada.
STATE_IMPORT_SUCCEEDED A versão do conjunto de dados foi importada.
STATE_IMPORT_FAILED Falha ao importar a versão do conjunto de dados.
STATE_DELETING O conjunto de dados está em processo de exclusão.
STATE_DELETION_FAILED Estado de falha da exclusão. Esse estado representa que a exclusão do conjunto de dados falhou. A exclusão pode ser repetida.
STATE_PROCESSING O estado de processamento. Esse estado representa a correspondência inicial e o processamento de conjuntos de dados para conjuntos de dados derivados.
STATE_PROCESSING_FAILED O estado de falha no processamento. Esse estado representa que o processamento falhou e pode informar erros.
STATE_NEEDS_REVIEW O estado da revisão de necessidades. Esse estado representa que os dados estão disponíveis para publicação e exibição no uso específico.
STATE_PUBLISHING O estado da publicação. Esse estado representa que a publicação está em andamento.
STATE_PUBLISHING_FAILED Os estados de falha na publicação. Esse estado representa que a publicação falhou. Uma nova tentativa de publicação pode ser feita.
STATE_COMPLETED O estado concluído. Esse estado representa o conjunto de dados disponível para uso específico.

Métodos

create

Crie um novo conjunto de dados para o projeto especificado.

delete

Exclua o conjunto de dados especificado.

get

Receba o conjunto de dados.

list

Lista todos os conjuntos de dados do projeto especificado.

patch

Atualize os metadados do conjunto de dados.