Lista documentos.
Solicitação HTTP
GET https://firestore.googleapis.com/v1beta1/{parent=projects/*/databases/*/documents}/{collectionId}
A URL usa sintaxe de transcodificação gRPC .
Parâmetros de caminho
Parâmetros | |
---|---|
parent | Obrigatório. O nome do recurso pai. No formato: Por exemplo: |
collectionId | Opcional. O ID da coleção, relativo a Por exemplo: Isso é opcional e, quando não fornecido, o Firestore listará os documentos de todas as coleções no |
Parâmetros de consulta
Parâmetros | |
---|---|
pageSize | Opcional. O número máximo de documentos a serem retornados em uma única resposta. O Firestore pode retornar menos que esse valor. |
pageToken | Opcional. Um token de página, recebido de uma resposta anterior Forneça isso para recuperar a página subsequente. Ao paginar, todos os outros parâmetros (com exceção de |
orderBy | Opcional. A ordenação facultativa dos documentos a devolver. Por exemplo: Isso reflete o |
mask | Opcional. Os campos a serem retornados. Se não for definido, retorna todos os campos. Caso um documento possua um campo que não esteja presente nesta máscara, esse campo não será retornado na resposta. |
showMissing | Se a lista mostrar documentos faltantes. Um documento está faltando se não existir, mas há subdocumentos aninhados abaixo dele. Quando verdadeiro, esses documentos ausentes serão retornados com uma chave, mas não terão campos Solicitações com |
Parâmetro de união consistency_selector . O modo de consistência para esta transação. Se não for definido, o padrão é consistência forte. consistency_selector pode ser apenas um dos seguintes: | |
transaction | Execute a leitura como parte de uma transação já ativa. Uma string codificada em base64. |
readTime | Execute a leitura no horário fornecido. Deve ser um carimbo de data/hora com precisão de microssegundos da última hora ou, se a recuperação pontual estiver ativada, também pode ser um carimbo de hora de um minuto inteiro dos últimos 7 dias. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
Solicitar corpo
O corpo da solicitação deve estar vazio.
Corpo de resposta
Se for bem-sucedido, o corpo da resposta conterá uma instância de ListDocumentsResponse
.
Escopos de autorização
Requer um dos seguintes escopos OAuth:
-
https://www.googleapis.com/auth/datastore
-
https://www.googleapis.com/auth/cloud-platform
Para obter mais informações, consulte Visão geral da autenticação .