Listet die geteilten Ablagen des Nutzers auf.
Diese Methode akzeptiert den Parameter q
, der eine Suchanfrage mit einem oder mehreren Suchbegriffen enthält. Weitere Informationen finden Sie im Hilfeartikel Nach geteilten Ablagen suchen.
HTTP-Anfrage
GET https://www.googleapis.com/drive/v3/drives
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter | |
---|---|
pageSize |
Maximale Anzahl der geteilten Ablagen, die pro Seite zurückgegeben werden sollen. |
pageToken |
Seitentoken für geteilte Ablagen. |
q |
Suchanfrage zum Suchen in geteilten Ablagen. |
useDomainAdminAccess |
Die Anfrage als Domainadministrator stellen. Wenn „true“ festgelegt ist, werden alle geteilten Ablagen der Domain zurückgegeben, in der der Anfragesteller Administrator ist. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Liste der geteilten Ablagen.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"drives": [
{
object ( |
Felder | |
---|---|
drives[] |
Die Liste der geteilten Ablagen. Wenn „nextPageToken“ ausgefüllt ist, ist diese Liste möglicherweise unvollständig und es sollte eine zusätzliche Seite mit Ergebnissen abgerufen werden. |
nextPageToken |
Das Seitentoken für die nächste Seite mit geteilten Ablagen. Dieser Parameter ist nicht vorhanden, wenn das Ende der Liste erreicht wurde. Wenn das Token aus irgendeinem Grund abgelehnt wird, sollte es verworfen und die Paginierung mit der ersten Ergebnisseite neu gestartet werden. Das Seitentoken ist in der Regel mehrere Stunden lang gültig. Wenn jedoch neue Artikel hinzugefügt oder entfernt werden, können sich die erwarteten Ergebnisse ändern. |
kind |
Kennzeichnet, welche Art von Ressource dies ist. Wert: der feste String |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.readonly
Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung für Ihre App, damit sie verwendet werden können. Weitere Informationen finden Sie im Autorisierungsleitfaden.