Google Drive bietet zwei Möglichkeiten, Informationen über Drive-Nutzer zu erfassen:
Mit der Ressource
about
lassen sich Informationen über den Nutzer, seine Drive-Einstellungen und seine Systemfunktionen abrufen.Mit der Ressource
apps
können Sie eine Liste der installierten Apps des Nutzers abrufen, einschließlich Informationen zu den unterstützten MIME-Typen der einzelnen Apps, Dateierweiterungen und anderen Details.
In diesem Leitfaden wird erläutert, wie Sie Nutzerinformationen in 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 in Ihrem Methodenaufruf der Abfrageparameter fields
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 mehrere fields
als Abfrageparameter in der Anfrage 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
: Name des Nutzers im Nur-Text-Format.PHOTO_LINK
: die URL des Profilbilds des Nutzers.PERMISSION_ID
: die ID des Nutzers in denPermission
-Ressourcen.EMAIL_ADDRESS
: E-Mail-Adresse des Nutzers
Informationen zu den Apps eines Nutzers abrufen
Google Drive-Anwendungen sind im Google Workspace Marketplace aufgelistet und dienen dazu, Drive einfacher zu machen. 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-Apps verwenden.
Wenn Sie eine Liste aller installierten Apps 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 vom Nutzer installierten Apps 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
ist die App-ID.PRODUCT_ID
: die Produkteintrags-ID für diese App.
Nutzer-Apps mit Abfrageparametern auflisten
Verwenden Sie mindestens einen der optionalen Abfrageparameter, um nach einer bestimmten App zu suchen:
appFilterExtensions
: Filtert die Suchergebnisse mithilfe einer durch Kommas getrennten Liste von Dateierweiterungen. Anwendungen im Anwendungsabfragebereich, die die aufgeführten Dateiendungen öffnen können, sind in der Antwort enthalten. Sind auchappFilterMimeTypes
angegeben, wird eine Union der beiden resultierenden Anwendungslisten zurückgegeben. Beispiele für Erweiterungen sinddocx
für Microsoft Word undpptx
für Microsoft PowerPoint. Weitere Beispiele für Dateierweiterungen finden Sie unter MIME-Typen für Google Workspace-Dokumente exportieren.Das folgende Codebeispiel zeigt, wie Sie mehrere Dateiendungen als Abfrageparameter angeben:
GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx
.appFilterMimeTypes
: Filtert die 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. SindappFilterExtensions
ebenfalls angegeben, wird eine Kombination der beiden resultierenden Anwendungslisten zurückgegeben. 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
: Filtert die Suchergebnisse nach einem Sprach- oder Gebietsschemacode gemäß BCP 47 mit einigen Erweiterungen aus dem LDML-Format von Unicode. Beispiele für Sprachcodes sinden-us
für Englisch (USA) undfr-ca
für Französisch (Kanada).Das folgende Codebeispiel zeigt, wie Sie mehrere Sprachcodes als Abfrageparameter bereitstellen:
GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca
.
Nutzer-App nach ID abrufen
Wenn Sie die detaillierten App-Informationen als Instanz von apps
herunterladen möchten, verwenden Sie die Methode apps.get
mit der App-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
ist die App-ID.PRODUCT_ID
: die Produkteintrags-ID für diese App.
Weitere Informationen
Hier sind ein paar 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.