Package google.firestore.admin.v1beta2

Índice

FirestoreAdmin

As operações são criadas pelo serviço FirestoreAdmin, mas são acessadas pelo serviço google.longrunning.Operations.

CreateIndex

rpc CreateIndex(CreateIndexRequest) returns (Operation)

Cria um índice composto. Isso retorna um google.longrunning.Operation que pode ser usado para acompanhar o status da criação. Os metadados da operação serão do tipo IndexOperationMetadata.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

DeleteIndex

rpc DeleteIndex(DeleteIndexRequest) returns (Empty)

Exclui um índice composto.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

ExportDocuments

rpc ExportDocuments(ExportDocumentsRequest) returns (Operation)

Exporta uma cópia de todos ou um subconjunto de documentos do Google Cloud Firestore para outro sistema de armazenamento, como o Google Cloud Storage. As atualizações recentes nos documentos podem não aparecer na exportação. A exportação ocorre em segundo plano, e o progresso dela pode ser monitorado e gerenciado pelo recurso "Operação" criado. Só é possível usar a saída de uma exportação depois que a operação associada é concluída. Se uma operação de exportação for cancelada antes da conclusão, é possível que dados parciais sejam deixados para trás no Google Cloud Storage.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

GetField

rpc GetField(GetFieldRequest) returns (Field)

Recebe os metadados e a configuração de um campo.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

GetIndex

rpc GetIndex(GetIndexRequest) returns (Index)

Recebe um índice composto.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

ImportDocuments

rpc ImportDocuments(ImportDocumentsRequest) returns (Operation)

Importa documentos para o Google Cloud Firestore. Os documentos existentes com o mesmo nome serão substituídos. A importação ocorre em segundo plano, e o progresso dela pode ser monitorado e gerenciado pelo recurso Operação criado. Se uma operação ImportDocuments for cancelada, talvez um subconjunto dos dados já tenha sido importado para o Cloud Firestore.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

ListFields

rpc ListFields(ListFieldsRequest) returns (ListFieldsResponse)

Lista a configuração de campo e os metadados para este banco de dados.

No momento, o FirestoreAdmin.ListFields só é compatível com os campos de fichas que foram modificados explicitamente. Para emitir essa consulta, chame FirestoreAdmin.ListFields com o filtro definido como indexConfig.usesAncestorConfig:false.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

ListIndexes

rpc ListIndexes(ListIndexesRequest) returns (ListIndexesResponse)

Lista índices compostos.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

UpdateField

rpc UpdateField(UpdateFieldRequest) returns (Operation)

Atualiza uma configuração de campo. No momento, as atualizações de campo se aplicam apenas à configuração de índice de campo único. No entanto, as chamadas para FirestoreAdmin.UpdateField precisam fornecer uma máscara de campo para evitar a mudança de qualquer configuração desconhecida pelo autor da chamada. A máscara de campo precisa ser especificada como: { paths: "index_config" }.

Essa chamada retorna um google.longrunning.Operation que pode ser usado para acompanhar o status da atualização do campo. Os metadados da operação serão do tipo FieldOperationMetadata.

Para definir as configurações de campo padrão do banco de dados, use o Field especial com o nome do recurso: projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/*.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

CreateIndexRequest

A solicitação para FirestoreAdmin.CreateIndex.

Campos
parent

string

Um nome pai no formato projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}

index

Index

O índice composto a ser criado.

DeleteIndexRequest

A solicitação para FirestoreAdmin.DeleteIndex.

Campos
name

string

Um nome no formato projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}

ExportDocumentsMetadata

Metadados de google.longrunning.Operation resultados de FirestoreAdmin.ExportDocuments.

Campos
start_time

Timestamp

Hora em que a operação começou.

end_time

Timestamp

Hora em que a operação foi concluída. Não será definido se a operação ainda estiver em andamento.

operation_state

OperationState

O estado da operação de exportação.

progress_documents

Progress

O progresso, em documentos, desta operação.

progress_bytes

Progress

O progresso, em bytes, dessa operação.

collection_ids[]

string

Os IDs de coleções que estão sendo exportados.

output_uri_prefix

string

Para onde as entidades são exportadas.

ExportDocumentsRequest

A solicitação para FirestoreAdmin.ExportDocuments.

Campos
name

string

Banco de dados a ser exportado. Precisa estar no formato: projects/{project_id}/databases/{database_id}.

collection_ids[]

string

Quais códigos de coleção exportar. Não especificado significa todas as coleções.

output_uri_prefix

string

O URI de saída. Atualmente, só aceita URIs do Google Cloud Storage no formato: gs://BUCKET_NAME[/NAMESPACE_PATH], em que BUCKET_NAME é o nome do bucket do Google Cloud Storage e NAMESPACE_PATH é um caminho de namespace opcional do Google Cloud Storage. Ao escolher um nome, considere as diretrizes de nomenclatura do Google Cloud Storage: https://cloud.google.com/storage/docs/naming. Se o URI for um bucket sem um caminho de namespace, um prefixo será gerado com base no horário de início.

ExportDocumentsResponse

Retornado no campo de resposta google.longrunning.Operation.

Campos
output_uri_prefix

string

Localização dos arquivos de saída. Isso poderá ser usado para iniciar uma importação no Cloud Firestore (este ou outro projeto) após a conclusão da operação.

Campo

Representa um único campo no banco de dados.

Os campos são agrupados pelo "Grupo de coleções", que representa todos os conjuntos no banco de dados com o mesmo ID.

Campos
name

string

Um nome de campo no formato projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_path}

Ele pode ser um nome de campo simples, como address , ou um caminho para campos em map_value (por exemplo, address.city) ou um caminho de campo especial. O único campo especial válido é *, que representa qualquer campo.

Os caminhos do campo podem ser citados usando (backtick). The only character that needs to be escaped within a quoted field path is the backtick character itself, escaped using a backslash. Special characters in field paths that must be quoted include:*,., ``` (backtick),[,]`, bem como caracteres ASCII.

Exemplos: (Observação: os comentários aqui estão escritos em sintaxe markdown, portanto há uma camada adicional de crases para representar um bloco de código) \address.city`represents a field namedaddress.city, not the map key cityin the fieldaddress. `*`represents a field named*`, não qualquer campo.

Uma Field especial contém as configurações de indexação padrão para todos os campos. O nome do recurso deste campo é: projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/* Os índices definidos neste Field serão aplicados a todos os campos que não têm a própria configuração de índice Field.

index_config

IndexConfig

A configuração de índice para este campo. Se não for definida, a indexação de campo vai reverter para a configuração definida pelo ancestor_field. Para remover explicitamente todos os índices deste campo, especifique uma configuração de índice com uma lista vazia de índices.

IndexConfig

A configuração de índice para este campo.

Campos
indexes[]

Index

Os índices compatíveis com este campo.

uses_ancestor_config

bool

Apenas saída. Quando verdadeiro, a configuração de índice de Field é definida a partir da configuração especificada por ancestor_field. Quando falso, a configuração de índice de Field é definida explicitamente.

ancestor_field

string

Apenas saída. Especifica o nome do recurso da Field que define a configuração de índice desse campo (quando uses_ancestor_config for verdadeiro) ou em que ele seria definido se o campo não tivesse configuração de índice (quando uses_ancestor_config fosse falso).

reverting

bool

Saída apenas quando verdadeiro, a configuração de índice de Field está em processo de reversão. Depois de concluída, a configuração do índice vai fazer a transição para o mesmo estado do campo especificado por ancestor_field. Nesse momento, uses_ancestor_config será true e reverting será false.

FieldOperationMetadata

Metadados de google.longrunning.Operation resultados de FirestoreAdmin.UpdateField.

Campos
start_time

Timestamp

Hora em que a operação começou.

end_time

Timestamp

Hora em que a operação foi concluída. Não será definido se a operação ainda estiver em andamento.

field

string

O recurso de campo em que a operação está agindo. Exemplo: projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_path}

index_config_deltas[]

IndexConfigDelta

Uma lista de IndexConfigDelta, que descreve a intenção da operação.

state

OperationState

Estado da operação.

document_progress

Progress

O progresso, em documentos, desta operação.

bytes_progress

Progress

O progresso, em bytes, dessa operação.

IndexConfigDelta

Informações sobre uma alteração na configuração de índice.

Campos
change_type

ChangeType

Especifica como o índice está sendo alterado.

index

Index

O índice que está sendo alterado.

ChangeType

Especifica como o índice está sendo alterado.

Enums
CHANGE_TYPE_UNSPECIFIED O tipo de alteração não foi especificado ou não é conhecido.
ADD O índice de campo único está sendo adicionado.
REMOVE O índice de campo único está sendo removido.

GetFieldRequest

A solicitação para FirestoreAdmin.GetField.

Campos
name

string

Um nome no formato projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_id}

GetIndexRequest

A solicitação para FirestoreAdmin.GetIndex.

Campos
name

string

Um nome no formato projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}

ImportDocumentsMetadata

Metadados de google.longrunning.Operation resultados de FirestoreAdmin.ImportDocuments.

Campos
start_time

Timestamp

Hora em que a operação começou.

end_time

Timestamp

Hora em que a operação foi concluída. Não será definido se a operação ainda estiver em andamento.

operation_state

OperationState

O estado da operação de importação.

progress_documents

Progress

O progresso, em documentos, desta operação.

progress_bytes

Progress

O progresso, em bytes, dessa operação.

collection_ids[]

string

Os códigos de coleção que estão sendo importados.

input_uri_prefix

string

O local dos documentos que estão sendo importados.

ImportDocumentsRequest

A solicitação para FirestoreAdmin.ImportDocuments.

Campos
name

string

Banco de dados no qual importar. Precisa estar no formato: projects/{project_id}/databases/{database_id}.

collection_ids[]

string

IDs de coleções a serem importados. "Não especificado" significa que todas as coleções incluídas na importação.

input_uri_prefix

string

Local dos arquivos exportados. Precisa corresponder ao output_uri_prefix de um ExportDocumentsResponse de uma exportação concluída. Consulte: google.firestore.admin.v1beta2.ExportDocumentsResponse.output_uri_prefix.

Índice

Os índices do Cloud Firestore permitem consultas simples e complexas em documentos em um banco de dados.

Campos
name

string

Apenas saída. Um nome definido pelo servidor para esse índice. O formato desse nome para índices compostos será: projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{composite_index_id}. No caso de índices de campo único, esse campo estará vazio.

query_scope

QueryScope

Os índices com um escopo de consulta de coleção especificado permitem consultas em uma coleção que é filha de um documento específico, especificada no momento da consulta e que tem o mesmo ID de coleção.

Os índices com um escopo de consulta de grupo de coleções especificado permitem consultas em todos os conjuntos descendentes de um documento específico, especificado no momento da consulta e que têm o mesmo ID de coleção que este índice.

fields[]

IndexField

Os campos aceitos por esse índice.

Para índices compostos, sempre há dois ou mais campos. A última entrada de campo é sempre para o caminho do campo __name__. Se, na criação, __name__ não tiver sido especificado como o último campo, ele será adicionado automaticamente com a mesma direção do último campo definido. Se o campo final em um índice composto não for direcional, o __name__ será ordenado ASCENDING (a menos que especificado explicitamente).

Para índices de campo único, será sempre exatamente uma entrada com um caminho de campo igual ao caminho do campo associado.

state

State

Apenas saída. O estado de exibição do índice.

IndexField

Um campo em um índice. O campo field_path descreve qual campo está indexado, o value_mode descreve como o valor do campo é indexado.

Campos
field_path

string

Pode ser name. Para índices de campo único, ele precisa corresponder ao nome do campo ou pode ser omitido.

Campo de união value_mode. Como o valor do campo é indexado. value_mode pode ser apenas de um dos tipos a seguir:
order

Order

Indica que este campo oferece suporte para ordenação pela ordem especificada ou comparação usando =, <, <=, >, >=.

array_config

ArrayConfig

Indica que este campo é compatível com operações em array_values.

ArrayConfig

As configurações de valor de matriz compatíveis.

Enums
ARRAY_CONFIG_UNSPECIFIED O índice não oferece suporte a outras consultas de matriz.
CONTAINS O índice é compatível com consultas de contenção de matrizes.

Pedido

As ordens com suporte.

Enums
ORDER_UNSPECIFIED A ordem não foi especificada. Não é uma opção válida.
ASCENDING O campo é ordenado pelo valor do campo crescente.
DESCENDING O campo é ordenado por valor de campo decrescente.

QueryScope

"Escopo da consulta" define o escopo em que uma consulta é executada. Isso é especificado em um campo from de StructuredQuery.

Enums
QUERY_SCOPE_UNSPECIFIED O escopo da consulta não foi especificado. Não é uma opção válida.
COLLECTION Os índices com um escopo de consulta de coleção especificado permitem consultas em uma coleção que é filha de um documento específico, especificada no momento da consulta e que tem o ID de coleção especificado pelo índice.
COLLECTION_GROUP Os índices com um escopo de consulta de grupo de coleções especificado permitem consultas em todos os conjuntos que têm o ID da coleção especificado pelo índice.

Estado

O estado de um índice. Durante a criação, um índice estará no estado CREATING. Se o índice for criado, ele vai fazer a transição para o estado READY. Se houver um problema na criação do índice, ele fará a transição para o estado NEEDS_REPAIR.

Enums
STATE_UNSPECIFIED O estado não foi especificado.
CREATING O índice está sendo criado. Há uma operação ativa de longa duração para o índice. O índice é atualizado durante a gravação de um documento. Pode haver alguns dados de índice.
READY O índice está pronto para ser usado. O índice é atualizado durante a gravação de um documento. O índice é totalmente preenchido com todos os documentos armazenados aos quais ele se aplica.
NEEDS_REPAIR O índice estava sendo criado, mas algo deu errado. Não há uma operação de longa duração ativa para o índice, e a operação de longa duração concluída mais recentemente falhou. O índice não é atualizado durante a gravação de um documento. Pode haver alguns dados de índice. Use a API google.longrunning.Operations para determinar o motivo da falha da última tentativa de criar esse índice e, em seguida, recrie o índice.

IndexOperationMetadata

Metadados de google.longrunning.Operation resultados de FirestoreAdmin.CreateIndex.

Campos
start_time

Timestamp

Hora em que a operação começou.

end_time

Timestamp

Hora em que a operação foi concluída. Não será definido se a operação ainda estiver em andamento.

index

string

O recurso de índice em que esta operação está atuando. Exemplo: projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}

state

OperationState

Estado da operação.

progress_documents

Progress

O progresso, em documentos, desta operação.

progress_bytes

Progress

O progresso, em bytes, dessa operação.

ListFieldsRequest

A solicitação para FirestoreAdmin.ListFields.

Campos
parent

string

Um nome pai no formato projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}

filter

string

O filtro que será aplicado aos resultados da lista. No momento, o FirestoreAdmin.ListFields só é compatível com os campos de fichas que foram modificados explicitamente. Para emitir essa consulta, chame FirestoreAdmin.ListFields com o filtro definido como indexConfig.usesAncestorConfig:false.

page_size

int32

O número de resultados a serem retornados.

page_token

string

Um token de página, retornado de uma chamada anterior para FirestoreAdmin.ListFields, que pode ser usado para acessar a próxima página de resultados.

ListFieldsResponse

A resposta para FirestoreAdmin.ListFields.

Campos
fields[]

Field

Os campos solicitados.

next_page_token

string

Um token de página que pode ser usado para solicitar outra página de resultados. Se o campo ficar em branco, essa será a última página.

ListIndexesRequest

A solicitação para FirestoreAdmin.ListIndexes.

Campos
parent

string

Um nome pai no formato projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}

filter

string

O filtro que será aplicado aos resultados da lista.

page_size

int32

O número de resultados a serem retornados.

page_token

string

Um token de página, retornado de uma chamada anterior para FirestoreAdmin.ListIndexes, que pode ser usado para acessar a próxima página de resultados.

ListIndexesResponse

A resposta para FirestoreAdmin.ListIndexes.

Campos
indexes[]

Index

Os índices solicitados.

next_page_token

string

Um token de página que pode ser usado para solicitar outra página de resultados. Se o campo ficar em branco, essa será a última página.

OperationState

Descreve o estado da operação.

Enums
OPERATION_STATE_UNSPECIFIED Não especificado.
INITIALIZING A solicitação está sendo preparada para processamento.
PROCESSING A solicitação está sendo processada ativamente.
CANCELLING A solicitação está em processo de cancelamento após o usuário chamar google.longrunning.Operations.CancelOperation na operação.
FINALIZING A solicitação foi processada e está na etapa de finalização.
SUCCESSFUL A solicitação foi concluída.
FAILED A solicitação foi processada, mas encontrou um erro.
CANCELLED O cancelamento da solicitação foi concluído após o usuário chamar google.longrunning.Operations.CancelOperation.

Progresso

Descreve o progresso da operação. A unidade de trabalho é genérica e precisa ser interpretada com base no local onde o Progress é usado.

Campos
estimated_work

int64

A quantidade de trabalho estimada.

completed_work

int64

A quantidade de trabalho concluído.

UpdateFieldRequest

A solicitação para FirestoreAdmin.UpdateField.

Campos
field

Field

O campo a ser atualizado.

update_mask

FieldMask

Uma máscara relativa ao campo. Se especificado, somente a configuração especificada por essa field_mask será atualizada no campo.