Nutzerinformationen zurückgeben

Google Drive bietet zwei Möglichkeiten, Informationen zu Drive-Nutzern zu erheben:

  • Mit der Ressource about können Sie Informationen zum Nutzer, zu den Drive-Einstellungen des Nutzers und zu den Systemfunktionen abrufen.

  • Mit der apps Ressource können Sie eine Liste der installierten Apps des Nutzers mit Informationen zu den unterstützten MIME-Typen, Dateierweiterungen und anderen Details der einzelnen Apps abrufen.

In diesem Leitfaden wird erläutert, wie Sie Nutzerinformationen in Drive abrufen können.

Details zu einem Nutzer abrufen

Verwenden Sie die get Methode, um Informationen zu einem Drive-Nutzer als Instanz von about zurückzugeben. Die zurückgegebenen Werte werden in Byte gemessen.

Sie müssen den fields System parameter für die get Methode festlegen, um die Felder anzugeben, die in der Antwort zurückgegeben werden sollen. Bei den meisten Drive-Methoden ist diese Aktion nur erforderlich, um nicht standardmäßige Felder zurückzugeben. Für die Ressource about ist sie jedoch obligatorisch. Wenn Sie den Parameter weglassen, gibt die Methode einen Fehler zurück. Weitere Informationen finden Sie unter Bestimmte Felder zurückgeben.

Das folgende Codebeispiel zeigt, wie Sie mehrere fields als Abfrageparameter in der Anfrage angeben. Die Antwort gibt die Feldwerte für die Anfrage zurück.

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 in unformatiertem Text.
  • PHOTO_LINK: Die URL des Profilfotos des Nutzers.
  • PERMISSION_ID: Die ID des Nutzers in den Permission-Ressourcen.
  • EMAIL_ADDRESS: Die E-Mail-Adresse des Nutzers

Nutzer-Apps auflisten

Google Drive-Apps werden im Google Workspace Marketplace aufgeführt und sollen die Verwendung von Drive erleichtern, 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.

Verwenden Sie die list-Methode ohne Parameter, um eine Liste aller installierten Apps des Nutzers als Instanz von apps zurückzugeben.

Wenn Sie die Felder angeben möchten, die in der Antwort zurückgegeben werden sollen, können Sie den fields System parameter festlegen. Wenn Sie den Parameter fields nicht angeben, gibt der Server eine Standardgruppe von Feldern zurück. Weitere Informationen finden Sie unter Bestimmte Felder zurückgeben.

Das folgende Codebeispiel zeigt, wie Sie in der Anfrage eine Liste aller installierten Apps des Nutzers zurückgeben. Die Antwort gibt die Feldwerte für die Anfrage zurück.

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 Produktlistungs-ID für diese App.

Nutzer-Apps mit Abfrageparametern auflisten

Verwenden Sie einen oder mehrere der optionalen Abfrageparameter, um eine bestimmte App zu finden:

  • appFilterExtensions: Filtern Sie die Suchergebnisse mit einer durch Kommas getrennten Liste von Dateierweiterungen. Apps im Bereich der App-Abfrage, die die aufgeführten Dateierweiterungen öffnen können, sind in der Antwort enthalten. Wenn auch appFilterMimeTypes angegeben werden, wird eine Vereinigung der beiden resultierenden App-Listen zurückgegeben. Beispiele für Erweiterungen sind docx für Microsoft Word und pptx 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 Dateierweiterungen als Abfrageparameter angeben: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx.

  • appFilterMimeTypes: Filtern Sie die Suchergebnisse mit einer durch Kommas getrennten Liste von MIME-Typen. Apps im Bereich der App-Abfrage, die die aufgeführten MIME-Typen öffnen können, sind in der Antwort enthalten. Wenn auch appFilterExtensions angegeben werden, wird eine Vereinigung der beiden resultierenden App-Listen zurückgegeben. Beispiele für MIME-Typen sind application/vnd.google-apps.form für Google Formulare und application/vnd.google-apps.site für Google Sites. Weitere Beispiele für MIME-Typen finden Sie unter Unterstützte MIME-Typen in Google Workspace und Google Drive 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 mit einem Sprach- oder Gebietsschemacode, gemäß BCP 47 mit einigen Erweiterungen aus dem LDML-Format von Unicode. Beispiele für Sprachcodes sind en-us für Englisch (USA) und fr-ca für Französisch (Kanada).

    Das folgende Codebeispiel zeigt, wie Sie mehrere Sprachcodes als Abfrageparameter angeben: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca.

Nutzer-App nach ID abrufen

Verwenden Sie die get Methode mit der App-ID, um die detaillierten App-Informationen als Instanz von apps herunterzuladen.

Das folgende Codebeispiel zeigt, wie Sie eine appId als Abfrageparameter in der Anfrage angeben. Die Antwort gibt die Feldwerte für die Anfrage zurück.

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 Produktlistungs-ID für diese App.

Hier sind einige nächste Schritte, die Sie ausprobieren können: