Name |
Typ |
Erforderlich |
Beschreibung |
path |
Zeichenfolge |
Ja |
Der Pfad zu dem Ordner. |
file_limit |
Integer |
Nein |
Standardwert: 10.000 (Maximalwert: 25.000). Beim Auflisten eines Ordners meldet der Service
keine Listen zurück, die mehr als die angegebene Anzahl Dateien umfassen. Stattdessen gibt er eine Antwort
mit dem Status 406 (Nicht zulässig) zurück. |
hash |
Zeichenfolge |
Nein |
Jeder Aufruf von '/metadata' für einen Ordner gibt ein Hashfeld zurück, das durch
Hashing aller Metadaten generiert wird, die in dieser Antwort enthalten sind. Bei späteren Aufrufen von
'/metadata' müssen Sie diesen Wert mit diesem Parameter angeben, sodass, wenn keine Änderung stattgefunden
hat, die Antwort den Statuscode 304 (Nicht geändert) anstelle der vollständigen und potenziell sehr
umfangreichen Ordnerliste zurückgibt. Dieser Parameter wird ignoriert, wenn der angegebene Pfad einer Datei zugeordnet ist
oder wenn 'list=false'. |
list |
Boolesch |
Nein |
Gültige Werte sind die Zeichenfolgen 'true' und 'false'. Standardwert ist 'true'. Bei
Angabe von 'true' enthalten die Metadaten des Ordners ein Inhaltsfeld ('contents') mit einer Liste von
Metadateneinträgen für den Inhalt des Ordners. Bei Angabe von 'false' wird das Inhaltsfeld weggelassen. |
include_deleted |
Boolesch |
Nein |
Nur gültig, wenn 'list' angegeben wird. Wenn dieser Parameter auf 'true' gesetzt wird, werden
in den Inhalt die Metadaten gelöschter untergeordneter Elemente eingeschlossen. Beachten Sie, dass unabhängig
von diesem Flag das Ziel des Metadatenaufrufs immer zurückgegeben wird, auch wenn es gelöscht wurde (mit 'is_deleted = true'). |
rev |
Zeichenfolge |
Nein |
Wenn Sie eine bestimmte Überarbeitungsnummer (Revision) angeben, werden nur Metadaten
für diese Überarbeitung zurückgegeben. |
locale |
Zeichenfolge |
Nein |
Das Größenfeld (size) der zurückgegebenen Metadaten wird entsprechend der angegebenen Ländereinstellung übersetzt. |
include_media_info |
Boolesch |
Nein |
Bei Angabe von 'true' enthält jede Datei ein Wörterverzeichnis 'photo_info' für Fotos und
ein Wörterverzeichnis 'video_info' für Videos mit zusätzlichen Medieninformationen. Wenn die Daten noch nicht verfügbar
sind, wird die Zeichenfolge 'pending' (anstehend) anstelle eines Wörterverzeichnisses zurückgegeben. |
include_membership |
Boolesch |
Nein |
Bei Angabe von 'true' enthalten die Metadaten für einen freigegebenen Ordner eine Liste der
Mitglieder (Members) und eine Liste von Gruppen. |