Informationen zu wiederkehrenden Nutzern

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

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

  • Mit der Ressource apps können Sie eine Liste der auf dem Gerät des Nutzers installierten Apps abrufen. Diese enthält Informationen zu den unterstützten MIME-Typen, Dateiendungen und anderen Details jeder App.

In diesem Leitfaden wird beschrieben, wie Sie Nutzerinformationen in Drive abrufen können.

Details zu einem Nutzer abrufen

Wenn Sie Informationen zu einem Drive-Nutzer als Instanz von about zurückgeben möchten, verwenden Sie die Methode get. Die zurückgegebenen Werte werden in Byte gemessen.

Sie müssen den fields-Systemparameter 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.

Im folgenden Codebeispiel wird gezeigt, wie Sie mehrere fields als Abfrageparameter in der Anfrage angeben. Die Antwort enthält die Feldwerte für die Anfrage.

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 im Nur-Text-Format.
  • PHOTO_LINK: Die URL des Profilbilds 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 dienen dazu, Drive komfortabler zu machen, 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 auf dem Gerät des Nutzers installierten Apps als Instanz von apps zurückgeben möchten, verwenden Sie die Methode list ohne Parameter.

Wenn Sie die Felder angeben möchten, die in der Antwort zurückgegeben werden sollen, können Sie den fields Systemparameter 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.

Im folgenden Codebeispiel sehen Sie, wie Sie in der Anfrage eine Liste aller installierten Apps des Nutzers zurückgeben. Die Antwort enthält die Feldwerte für die Anfrage.

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

Wenn Sie nach einer bestimmten App suchen möchten, verwenden Sie einen oder mehrere der optionalen Abfrageparameter:

  • appFilterExtensions: Filtern Sie die Suchergebnisse mit einer durch Kommas getrennten Liste von Dateiendungen. Apps, die im Bereich der App-Anfrage liegen und die aufgeführten Dateiendungen ö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 Dateiendungen finden Sie unter MIME-Typen für den Export von Google Workspace-Dokumenten.

    Das folgende Codebeispiel zeigt, wie Sie mehrere Dateiendungen 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 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 mit einem Sprach- oder Gebietsschemacode, wie in BCP 47 definiert, 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 Anfrageparameter angeben: 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 get mit der App-ID.

Das folgende Codebeispiel zeigt, wie Sie einen appId als Abfrageparameter in der Anfrage angeben. Die Antwort enthält die Feldwerte für die Anfrage.

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.

Als Nächstes können Sie unter anderem Folgendes tun: