Informazioni sull'utente di ritorno

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

  • Utilizzando la risorsa about, puoi recuperare informazioni sull'utente, sulle impostazioni di Drive e sulle 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 su altri dettagli di ogni app.

Questa guida spiega come recuperare le informazioni utente in Drive.

Visualizzare i dettagli di un utente

Per restituire informazioni su un utente di Drive come istanza di about, utilizza il metodo get(). I valori restituiti vengono misurati in byte.

Il metodo get() richiede il parametro fields per elencare i campi da restituire nella risposta. Se ometti il parametro, il metodo restituisce un errore. Per restituire i campi esatti di cui hai bisogno, consulta Restituire campi specifici.

Mostra un esempio

Il seguente esempio di codice mostra come fornire più fields come parametro di query nella richiesta. La risposta restituisce i valori dei campi 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: il nome dell'utente in testo normale.
  • PHOTO_LINK: l'URL della foto del profilo dell'utente.
  • PERMISSION_ID: l'ID dell'utente nelle risorse Permission.
  • EMAIL_ADDRESS: l'indirizzo email dell'utente

Elenca le app utente

Le app di Google Drive sono elencate nel Google Workspace Marketplace e vengono utilizzate per semplificare l'utilizzo di Drive, ad esempio l'app Documenti Google o un componente aggiuntivo utilizzato in Documenti per firmare i documenti. Per saperne di più, vedi Utilizzare le app di Google Drive.

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

Puoi impostare il parametro fields per elencare i campi da restituire nella risposta. Per restituire i campi esatti di cui hai bisogno, consulta la sezione Restituire campi specifici.

Mostra un esempio

Il seguente esempio di codice mostra come restituire un elenco di tutte le app installate dell'utente nella richiesta. La risposta restituisce i valori dei campi 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 app.
  • PRODUCT_ID: l'ID scheda di prodotto per questa app.

Elenca le app utente con i parametri di query

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

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

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

  • appFilterMimeTypes: filtra i risultati di ricerca utilizzando un elenco di tipi MIME separati da virgola. Le app nell'ambito della query dell'app che possono aprire i tipi MIME elencati sono incluse nella risposta. Se vengono forniti anche i valori appFilterExtensions, viene restituita l'unione dei due elenchi di app risultanti. Alcuni esempi di tipi MIME sono 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 da Google Workspace e Google Drive.

    Il seguente esempio di codice mostra come fornire più tipi MIME come parametro di query: 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 una impostazioni internazionali, come definito dal BCP 47, con alcune estensioni del formato LDML di Unicode. Esempi di codici di lingua includono en-us per l'inglese (Stati Uniti) e fr-ca per il francese (Canada).

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

Recuperare l'app utente per ID

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

Mostra un esempio

Il seguente esempio di codice mostra come fornire un appId come parametro di query nella richiesta. La risposta restituisce i valori dei campi 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 app.
  • PRODUCT_ID: l'ID scheda di prodotto per questa app.

Ecco alcuni passaggi successivi che puoi provare: