Informationen zu wiederkehrenden Nutzern

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 den Permission-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 auch appFilterMimeTypes angegeben, wird eine Union der beiden resultierenden Anwendungslisten 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 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. Sind appFilterExtensions ebenfalls angegeben, wird eine Kombination der beiden resultierenden Anwendungslisten 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 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 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 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.

Hier sind ein paar weitere Schritte, die Sie ausprobieren können: