Belgeleri listeler.
HTTP isteği
GET https://firestore.googleapis.com/v1beta1/{parent=projects/*/databases/*/documents/*/**}/{collectionId}
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
parent |
Zorunlu. Üst kaynak adı. Şu biçimde: Örneğin: |
collectionId |
İsteğe bağlı. Listelenecek Örneğin: Bu isteğe bağlıdır ve sağlanmadığında Firestore, sağlanan |
Sorgu parametreleri
Parametreler | |
---|---|
pageSize |
İsteğe bağlı. Tek bir yanıtta döndürülecek maksimum doküman sayısı. Firestore bu değerden daha az sonuç döndürebilir. |
pageToken |
İsteğe bağlı. Önceki Sonraki sayfayı almak için bunu sağlayın. Sayfalara ayırma işlemi sırasında diğer tüm parametreler ( |
orderBy |
İsteğe bağlı. İade edilecek belgelerin isteğe bağlı sıralaması. Örnek: Bu, Firestore sorgularında kullanılan ancak dize biçiminde olan |
mask |
İsteğe bağlı. Döndürülecek alanlar. Ayarlanmazsa tüm alanları döndürür. Bir dokümanda, bu maskede bulunmayan bir alan varsa bu alan yanıtta döndürülmez. |
showMissing |
Listede eksik dokümanların gösterilip gösterilmediği Bir doküman yoksa ancak altında iç içe yerleştirilmiş alt dokümanlar varsa eksiktir. Doğru değerine ayarlandığında bu tür eksik belgeler bir anahtarla döndürülür ancak
|
Birleştirme parametresi consistency_selector . Bu işlem için tutarlılık modu. Ayarlanmazsa varsayılan olarak güçlü tutarlılık kullanılır. consistency_selector şunlardan yalnızca biri olabilir: |
|
transaction |
Okuma işlemini, zaten etkin olan bir işlemin parçası olarak gerçekleştirin. base64 kodlu bir dize. |
readTime |
Okumayı belirtilen zamanda gerçekleştir. Bu, son bir saat içindeki mikrosaniyelik bir hassasiyet zaman damgası olmalıdır. Belirli bir noktadan önceyi kurtarma özelliği etkinse son 7 gün içindeki bir tam dakikalık zaman damgası da olabilir. RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: |
İstek içeriği
İsteğin gövdesi boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt gövdesi, ListDocumentsResponse
öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
Daha fazla bilgi için Kimlik Doğrulamaya Genel Bakış başlıklı makaleye bakın.