Google Drive bietet zwei Optionen, um Informationen über Drive-Nutzer zu erfassen:
Mit der Ressource
about
können Sie Informationen zum Nutzer, seinen Drive-Einstellungen und seinen Systemfunktionen abrufen.Mit der Ressource
apps
können Sie eine Liste der installierten Anwendungen des Nutzers mit Informationen zu den von jeder Anwendung unterstützten MIME-Typen, Dateierweiterungen und anderen Details abrufen.
In diesem Leitfaden erfahren Sie, wie Sie Nutzerinformationen aus Google Drive abrufen.
Informationen zu einem Nutzer abrufen
Wenn Sie Informationen zu einem Drive-Nutzer als Instanz von about
zurückgeben möchten, verwenden Sie die Methode about.get
. Für die Methode about.get
ist der Abfrageparameter fields
in Ihrem Methodenaufruf erforderlich. Die zurückgegebenen Werte werden in Byte gemessen. Weitere Informationen finden Sie unter Bestimmte Felder für eine Datei zurückgeben.
Beispiel ansehen
Das folgende Codebeispiel zeigt, wie Sie in der Anfrage mehrere fields
als Abfrageparameter angeben. In der Antwort werden die Feldwerte für die Anfrage zurückgegeben.
Anfrage
GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota
Antwort
{ "kind": "drive#about", "user": { "kind": "drive#user", "displayName": "DISPLAY_NAME", "photoLink": "PHOTO_LINK", "me": true, "permissionId": "PERMISSION_ID", "emailAddress": "EMAIL_ADDRESS" }, "storageQuota": { "usage": "10845031958", "usageInDrive": "2222008387", "usageInDriveTrash": "91566" } }
Die Antwort enthält die folgenden Werte:
DISPLAY_NAME
: der Name des Nutzers als Nur-Text-DateiPHOTO_LINK
: Die URL des Profilbilds des Nutzers.PERMISSION_ID
: die ID des Nutzers innerhalb derPermission
-Ressourcen.EMAIL_ADDRESS
: E-Mail-Adresse des Nutzers
Informationen zu den Apps eines Nutzers abrufen
Google Drive-Anwendungen sind im Google Workspace Marketplace aufgeführt und werden verwendet, um Drive noch praktischer zu gestalten. Dazu gehören z. B. die Google Docs-App oder ein Add-on, das in Docs zum Signieren von Dokumenten verwendet wird. Weitere Informationen finden Sie unter Google Drive-Anwendungen verwenden.
Wenn Sie eine Liste aller installierten Anwendungen des Nutzers als Instanz von apps
zurückgeben möchten, verwenden Sie die Methode apps.list
ohne Parameter.
Beispiel ansehen
Das folgende Codebeispiel zeigt, wie eine Liste aller installierten Apps des Nutzers in der Anfrage zurückgegeben wird. In der Antwort werden die Feldwerte für die Anfrage zurückgegeben.
Anfrage
GET https://www.googleapis.com/drive/v3/apps
Antwort
{ "kind": "drive#appList", "selfLink": "https://www.googleapis.com/drive/v3/apps", "items": [ { "kind": "drive#app", "id": "ID", "name": "Google Sheets", "supportsCreate": true, "supportsImport": true, "supportsMultiOpen": false, "supportsOfflineCreate": true, "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap", "productId": "PRODUCT_ID" } ], "defaultAppIds": [ "ID" ] }
Die Antwort enthält die folgenden Werte:
ID
: die App-ID.PRODUCT_ID
: Die ID des Produkteintrags für diese App.
Nutzer-Apps mit Abfrageparametern auflisten
Verwenden Sie einen oder mehrere optionale Suchparameter, um eine bestimmte App zu finden:
appFilterExtensions
: Filtern Sie die Suchergebnisse mithilfe einer durch Kommas getrennten Liste von Dateiendungen. Anwendungen im Anwendungsabfragebereich, die die aufgeführten Dateiendungen öffnen können, sind in der Antwort enthalten. Wenn auchappFilterMimeTypes
angegeben wird, werden die beiden resultierenden Anwendungslisten zusammengeführt. Beispiele für Erweiterungen sinddocx
für Microsoft Word undpptx
für Microsoft PowerPoint. Weitere Beispiele für Dateiendungen finden Sie unter MIME-Typen für Google Workspace-Dokumente exportieren.Das folgende Codebeispiel zeigt, wie mehrere Dateiendungen als Abfrageparameter angegeben werden:
GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx
.appFilterMimeTypes
: Filtern der Suchergebnisse mithilfe einer durch Kommas getrennten Liste von MIME-Typen. Anwendungen im Anwendungsabfragebereich, die die aufgeführten MIME-Typen öffnen können, sind in der Antwort enthalten. Wenn auchappFilterExtensions
angegeben wird, werden die beiden resultierenden Anwendungslisten zusammengeführt. Beispiele für MIME-Typen sindapplication/vnd.google-apps.form
für Google Formulare undapplication/vnd.google-apps.site
für Google Sites. Weitere Beispiele für MIME-Typen finden Sie unter Von Google Workspace und Google Drive unterstützte MIME-Typen.Das folgende Codebeispiel zeigt, wie Sie mehrere MIME-Typen als Abfrageparameter angeben:
GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site
.languageCode
: Filtern Sie die Suchergebnisse anhand eines in BCP 47 definierten Sprach- oder Gebietscodes, wobei einige Erweiterungen aus dem Unicode-LDML-Format verwendet werden. Beispiele für Sprachcodes sinden-us
für Englisch (USA) undfr-ca
für Französisch (Kanada).Das folgende Codebeispiel zeigt, wie mehrere Sprachcodes als Abfrageparameter angegeben werden:
GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca
.
Nutzer-App nach ID abrufen
Wenn Sie die detaillierten Anwendungsinformationen als Instanz von apps
herunterladen möchten, verwenden Sie die Methode apps.get
mit der Anwendungs-ID.
Beispiel ansehen
Das folgende Codebeispiel zeigt, wie ein appId
als Abfrageparameter in der Anfrage angegeben wird. In der Antwort werden die Feldwerte für die Anfrage zurückgegeben.
Anfrage
GET https://www.googleapis.com/drive/v3/apps/APP_ID
Antwort
{ "kind": "drive#app", "id": "ID", "name": "Google Sheets", "supportsCreate": true, "supportsImport": true, "supportsMultiOpen": false, "supportsOfflineCreate": true, "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap", "productId": "PRODUCT_ID" }
Die Antwort enthält die folgenden Werte:
ID
: die App-ID.PRODUCT_ID
: Die ID des Produkteintrags für diese App.
Weitere Informationen
Hier sind einige weitere Schritte, die Sie ausprobieren können:
Informationen zum Erstellen einer Datei in Google Drive finden Sie unter Dateien erstellen.
Informationen zum Hochladen von Dateidaten beim Erstellen oder Aktualisieren einer Datei finden Sie unter Dateidaten hochladen.
Informationen zum Herunterladen und Exportieren von Dateien finden Sie unter Dateien herunterladen und exportieren.