Informationen zu wiederkehrenden Nutzern

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-Datei
  • PHOTO_LINK: Die URL des Profilbilds des Nutzers.
  • PERMISSION_ID: die ID des Nutzers innerhalb der Permission-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 auch appFilterMimeTypes angegeben wird, werden die beiden resultierenden Anwendungslisten zusammengeführt. Beispiele für Erweiterungen sind docx für Microsoft Word und pptx 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 auch appFilterExtensions angegeben wird, werden die beiden resultierenden Anwendungslisten zusammengeführt. 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: 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 sind en-us für Englisch (USA) und fr-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.

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