REST Resource: projects.datasets

Recurso: conjunto de dados

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

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, mostrado na interface do usuário do console .

description

string

Uma descrição deste 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 UTC "Zulu" RFC3339, 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 UTC "Zulu" RFC3339, 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 esta versão do conjunto de dados foi criada. (Aconteceu ao importar dados para o conjunto de dados)

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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 para o conjunto de dados. data_source pode ser apenas de um dos tipos a seguir:
localFileSource

object (LocalFileSource)

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

gcsSource

object (GcsSource)

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

Uso

O uso especifica onde os dados devem ser utilizados para informar como processá-los.

Enums
USAGE_UNSPECIFIED O uso deste conjunto de dados não está definido.
USAGE_DATA_DRIVEN_STYLING Ele será usado para a estilização baseada 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 GeoJson.
FILE_FORMAT_KML KML.
FILE_FORMAT_CSV arquivo CSV.

GcsSource

Os 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 de dados de origem. Por exemplo, gs://my_bucket/my_object.

fileFormat

enum (FileFormat)

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

Status

Status do conjunto de dados.

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

enum (State)

Enumeração do estado do status.

errorMessage

string

Mensagem de erro indicando o motivo da falha. Ficará vazio se os conjuntos de dados não estiverem em estado de falha.

Estado

Uma lista de estados para o conjunto de dados.

Enums
STATE_UNSPECIFIED O estado deste conjunto de dados não foi definido.
STATE_IMPORTING Os dados estão sendo importados para um conjunto de dados.
STATE_IMPORT_SUCCEEDED Dados importados para um conjunto de dados.
STATE_IMPORT_FAILED Falha ao importar dados para um conjunto de dados.
STATE_DELETING O conjunto de dados está em processo de exclusão.
STATE_DELETION_FAILED Estado de falha na exclusão. Esse estado representa que não foi possível excluir o conjunto de dados. Você pode tentar excluir novamente.
STATE_PROCESSING Os dados estão sendo processados.
STATE_PROCESSING_FAILED O estado de falha no processamento. Esse estado representa que o processamento falhou e pode relatar erros.
STATE_NEEDS_REVIEW Este estado não é usado no momento.
STATE_PUBLISHING O estado de publicação. Esse estado representa que a publicação está em andamento.
STATE_PUBLISHING_FAILED Os estados de falha de publicação. Esse estado representa que a publicação falhou. É possível tentar publicar novamente.
STATE_COMPLETED O estado concluído. Esse estado representa o conjunto de dados que está disponível para uso específico.

Métodos

create

Crie um novo conjunto de dados para o projeto especificado.

delete

Exclui o conjunto de dados especificado .

get

Recebe o conjunto de dados.

list

Liste todos os conjuntos de dados do projeto especificado.

patch

Atualizar os metadados do conjunto de dados.