Informazioni sull'utente di ritorno

Google Drive offre due opzioni per raccogliere le informazioni sugli utenti di Drive:

  • Utilizzando la risorsa about, puoi recuperare informazioni sull'utente, sulle impostazioni di Drive dell'utente e sulle sue funzionalità di sistema.

  • Utilizzando la risorsa apps, puoi recuperare un elenco delle app installate dall'utente, con informazioni sui tipi MIME supportati, sulle estensioni dei file e altri dettagli.

Questa guida spiega come recuperare le informazioni utente in Drive.

Recuperare informazioni su un utente

Per restituire informazioni su un utente di Drive come istanza di about, utilizza il metodo about.get. Il metodo about.get richiede il parametro di query fields nella chiamata al metodo. I valori restituiti vengono misurati in byte. Per ulteriori informazioni, consulta Restituire campi specifici per un file.

Mostra un esempio

Il seguente esempio di codice mostra come fornire più fields come parametro di ricerca nella richiesta. La risposta restituisce i valori del campo per la richiesta.

Richiedi

GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota

Risposta

{
  "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"
  }
}

La risposta include i seguenti valori:

  • DISPLAY_NAME: nome dell'utente in testo normale.
  • PHOTO_LINK: l'URL della foto del profilo dell'utente.
  • PERMISSION_ID: l'ID dell'utente all'interno delle Permission risorse.
  • EMAIL_ADDRESS: l'indirizzo email dell'utente

Recuperare informazioni sulle app di un utente

Le app Google Drive sono elencate in Google Workspace Marketplace e sono utilizzate per rendere Drive più pratico, come l'app Documenti Google o un componente aggiuntivo utilizzato all'interno di Documenti per firmare documenti. Per ulteriori informazioni, consulta Utilizzare le app Google Drive.

Per restituire un elenco di tutte le app installate dall'utente come istanza di apps, utilizza il metodo apps.list senza parametri.

Mostra un esempio

Il seguente esempio di codice mostra come restituire un elenco di tutte le app installate dall'utente nella richiesta. La risposta restituisce i valori del campo per la richiesta.

Richiedi

GET https://www.googleapis.com/drive/v3/apps

Risposta

{
  "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"
  ]
}

La risposta include i seguenti valori:

  • ID: l'ID dell'app.
  • PRODUCT_ID: l'ID scheda di prodotto di questa app.

Elenca le app utente con i parametri di query

Per trovare un'app specifica, utilizza uno o più parametri di query facoltativi:

  • appFilterExtensions: filtra i risultati di ricerca utilizzando un elenco separato da virgole di estensioni dei file. Le app nell'ambito di query dell'app che possono aprire le estensioni dei file elencate sono incluse nella risposta. Se viene fornito anche appFilterMimeTypes, viene restituita un'unione dei due elenchi di app risultanti. Esempi di estensioni includono docx per Microsoft Word e pptx per Microsoft PowerPoint. Per altri esempi di estensioni dei file, vedi Esportare i tipi MIME per i documenti di Google Workspace.

    Il seguente esempio di codice mostra come fornire più estensioni dei file come parametro di ricerca: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx.

  • appFilterMimeTypes: filtra i risultati di ricerca utilizzando un elenco separato da virgole di tipi MIME. Le app nell'ambito di query dell'app che possono aprire i tipi MIME elencati sono incluse nella risposta. Se vengono forniti anche appFilterExtensions, viene restituita un'unione dei due elenchi di app risultanti. Esempi di tipi MIME includono application/vnd.google-apps.form per Moduli Google e application/vnd.google-apps.site per Google Sites. Per altri esempi di tipi MIME, vedi Tipi MIME supportati per Google Workspace e Google Drive.

    Il seguente esempio di codice mostra come fornire più tipi MIME come parametro di ricerca: GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site.

  • languageCode: filtra i risultati di ricerca utilizzando un codice lingua o impostazioni internazionali, come definito da BCP 47, con alcune estensioni del formato LDML di Unicode. Tra gli esempi di codici lingua c'è en-us per l'inglese (Stati Uniti) e fr-ca per il francese (Canada).

    Il seguente esempio di codice mostra come fornire codici di più lingue come parametro di ricerca: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca.

Ottieni app utente in base all'ID

Per scaricare le informazioni dettagliate sull'app come istanza di apps, utilizza il metodo apps.get con l'ID app.

Mostra un esempio

Il seguente esempio di codice mostra come fornire un valore appId come parametro di ricerca nella richiesta. La risposta restituisce i valori del campo per la richiesta.

Richiedi

GET https://www.googleapis.com/drive/v3/apps/APP_ID

Risposta

{
  "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"
}

La risposta include i seguenti valori:

  • ID: l'ID dell'app.
  • PRODUCT_ID: l'ID scheda di prodotto di questa app.

Ecco alcuni passaggi che potresti provare a eseguire: