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 dellePermission
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 ancheappFilterMimeTypes
, viene restituita un'unione dei due elenchi di app risultanti. Esempi di estensioni includonodocx
per Microsoft Word epptx
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 ancheappFilterExtensions
, viene restituita un'unione dei due elenchi di app risultanti. Esempi di tipi MIME includonoapplication/vnd.google-apps.form
per Moduli Google eapplication/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) efr-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.
Argomenti correlati
Ecco alcuni passaggi che potresti provare a eseguire:
Per creare un file su Drive, consulta Creazione di file.
Per caricare i dati del file quando crei o aggiorni un file, vedi Caricare i dati del file.
Per scaricare ed esportare file, vedi Scaricare ed esportare file.