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 sue impostazioni di Drive e sulle funzionalità del 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 sono misurati in byte.

Devi impostare il parametro di sistema fields sul metodo get per specificare i campi da restituire nella risposta. Nella maggior parte dei metodi di Drive, questa azione è obbligatoria solo per restituire i campi non predefiniti, ma è obbligatoria per la risorsa about. Se ometti il parametro, il metodo restituisce un errore. Per ulteriori informazioni, consulta Restituire campi specifici.

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.

Se vuoi specificare i campi da restituire nella risposta, puoi impostare il fields parametro system. Se non specifichi il parametro fields, il server restituisce un insieme predefinito di campi. Per ulteriori informazioni, consulta Restituire campi specifici.

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 lingua include 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.

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: