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 dell'utente e sulle funzionalità del sistema.

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

Questa guida spiega come recuperare le informazioni utente in Drive.

Visualizzare i dettagli di un utente

Per restituire informazioni su un utente 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 Drive, questa azione è necessaria solo per restituire campi non predefiniti, ma è obbligatoria per la risorsa about. Se ometti il parametro, il metodo restituisce un errore. Per saperne di più, 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 all'interno delle risorse Permission.
  • EMAIL_ADDRESS: l'indirizzo email dell'utente

Elenco app utente

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

Per restituire un elenco di tutte le app installate dell'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 di sistema. Se non specifichi il parametro fields, il server restituisce un insieme predefinito di campi. Per saperne di più, consulta Restituire campi specifici.

Il seguente esempio di codice mostra come restituire un elenco di tutte le app installate dall'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 separato da virgole di estensioni dei file. Le app nell'ambito della query dell'app che possono aprire le estensioni di file elencate sono incluse nella risposta. Se vengono forniti anche appFilterMimeTypes, viene restituita un'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 dei file, vedi Esportare i tipi MIME per i documenti Google Workspace.

    Il seguente esempio di codice mostra come fornire più estensioni di 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 separato da virgole di tipi MIME. Nella risposta sono incluse le app nell'ambito della query dell'app che possono aprire i tipi MIME elencati. 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 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 di lingua o paese, come definito da BCP 47, con alcune estensioni del formato LDML di Unicode. Esempi di codici 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.

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: