Répertorie les documents.
Requête HTTP
GET https://firestore.googleapis.com/v1beta1/{parent=projects/*/databases/*/documents/*/**}/{collectionId}
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
parent |
Obligatoire. Nom de la ressource parente. Format à respecter: (par exemple, |
collectionId |
Facultatif. ID de collection de la liste (par rapport à Par exemple, Cette option est facultative. Lorsqu'elle n'est pas fournie, Firestore affiche les documents de toutes les collections dans le |
Paramètres de requête
Paramètres | |
---|---|
pageSize |
Facultatif. Nombre maximal de documents à renvoyer par réponse. Firestore peut renvoyer une valeur inférieure à cette valeur. |
pageToken |
Facultatif. Jeton de page, provenant d'une réponse Fournissez-le pour récupérer la page suivante. Lors de la pagination, tous les autres paramètres (à l'exception de |
orderBy |
Facultatif. Ordre facultatif des documents à renvoyer. Exemple : Cette valeur reflète la valeur |
mask |
Facultatif. Champs à renvoyer. Si ce champ n'est pas spécifié, tous les champs sont renvoyés. Si un document comporte un champ qui n'est pas présent dans ce masque, ce champ n'est pas renvoyé dans la réponse. |
showMissing |
Si la liste doit afficher des documents manquants Un document est manquant s'il n'existe pas, mais des sous-documents sont imbriqués sous celui-ci. Lorsque la valeur est "true", ces documents manquants sont renvoyés avec une clé, mais sans champs, Les requêtes avec |
Paramètre d'union consistency_selector . Mode de cohérence pour cette transaction. Si ce champ n'est pas spécifié, la valeur par défaut est la cohérence forte. consistency_selector ne peut être qu'un des éléments suivants : |
|
transaction |
Effectuez la lecture dans le cadre d'une transaction déjà active. Chaîne encodée en base64. |
readTime |
Effectuez la lecture au moment indiqué. Il doit s'agir d'un horodatage de précision de l'ordre de la microseconde au cours de la dernière heure. Si la récupération à un moment précis est activée, il peut également s'agir d'un horodatage d'une minute entière datant des sept derniers jours. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de ListDocumentsResponse
.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
Pour en savoir plus, consultez la page Présentation de l'authentification.