Informationen zu wiederkehrenden Nutzern

In Google Drive gibt es zwei Möglichkeiten, Informationen zu Drive-Nutzern zu erfassen:

  • Über die Ressource about können Sie Informationen zum Nutzer, zu seinen Drive-Einstellungen und zu den Systemfunktionen abrufen.

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

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

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.

Für die Methode get() ist der Parameter fields erforderlich, um die Felder aufzulisten, die in der Antwort zurückgegeben werden sollen. Wenn Sie den Parameter weglassen, gibt die Methode einen Fehler zurück. Weitere Informationen dazu, wie Sie genau die benötigten Felder zurückgeben, finden Sie unter Bestimmte Felder zurückgeben.

Beispiel ansehen

Im folgenden Codebeispiel wird gezeigt, wie mehrere fields als Suchparameter in der Anfrage angegeben werden. 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 im Klartext.
  • 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 sind im Google Workspace Marketplace aufgeführt und dienen dazu, Drive zu vereinfachen. Dazu gehören beispielsweise die Google Docs App oder ein Add-on, mit dem Dokumente in Docs unterzeichnet werden können. 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 list() ohne Parameter.

Sie können den Parameter fields festlegen, um die Felder aufzulisten, die in der Antwort zurückgegeben werden sollen. Weitere Informationen dazu, wie Sie genau die benötigten Felder zurückgeben, finden Sie unter Bestimmte Felder zurückgeben.

Beispiel ansehen

Im folgenden Codebeispiel wird gezeigt, wie in der Anfrage eine Liste aller installierten Apps des Nutzers zurückgegeben wird. 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 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: Die Suchergebnisse mit einer durch Kommas getrennten Liste von Dateiendungen filtern. Apps im Geltungsbereich der App-Abfrage, die die aufgeführten Dateierweiterungen öffnen können, sind in der Antwort enthalten. Wenn auch appFilterMimeTypes angegeben ist, 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 Google Workspace-Dokumente exportieren.

    Das folgende Codebeispiel zeigt, wie mehrere Dateiendungen als Suchparameter angegeben werden: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx.

  • appFilterMimeTypes: Die Suchergebnisse mit einer durch Kommas getrennten Liste von MIME-Typen filtern. Apps im Geltungsbereich der App-Abfrage, die die aufgeführten MIME-Typen öffnen können, sind in der Antwort enthalten. Wenn auch appFilterExtensions angegeben ist, 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.

    Im folgenden Codebeispiel wird gezeigt, wie mehrere MIME-Typen als Suchparameter angegeben werden: GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site.

  • languageCode: Die Suchergebnisse nach einem Sprach- oder Gebietscode filtern, 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).

    Im folgenden Codebeispiel wird gezeigt, wie mehrere Sprachcodes als Suchparameter angegeben werden: 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.

Beispiel ansehen

Im folgenden Codebeispiel wird gezeigt, wie appId als Abfrageparameter in der Anfrage angegeben wird. 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 ID des Produkteintrags für diese App.

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