Questa guida contiene attività relative alla gestione dei Drive condivisi, come la creazione di Drive condivisi e la gestione di membri e autorizzazioni, utilizzando l'API Google Drive.
Se vuoi specificare i campi da restituire nella risposta, puoi impostare il
fields parametro
di sistema
con qualsiasi metodo della drives risorsa. Se non specifichi il parametro fields, il server restituisce un insieme predefinito di campi specifici per il metodo. Ad esempio, il metodo
list restituisce solo i campi kind, id,
e name per ogni Drive condiviso. Per saperne di più, vedi Restituire
campi specifici.
Per saperne di più sui limiti delle cartelle dei Drive condivisi, vedi Limiti delle cartelle dei Drive condivisi.
Creare un Drive condiviso
Per creare un Drive condiviso, utilizza il create
metodo sulla risorsa drives con il
requestId parametro.
Il parametro requestId identifica il tentativo logico per la creazione idempotente di un Drive condiviso. Se la richiesta va in timeout o restituisce un errore di backend indeterminato, la stessa richiesta può essere ripetuta e non verranno creati duplicati. Il requestId e il corpo della richiesta devono rimanere invariati.
Il seguente esempio di codice mostra come creare un Drive condiviso:
Java
Python
Node.js
PHP
.NET
Le chiamate al metodo create sono
idempotenti.
Se il Drive condiviso è stato creato correttamente in una richiesta precedente o a causa di un nuovo tentativo, il metodo restituisce un'istanza della risorsa drives. A volte, ad esempio dopo un periodo di tempo prolungato o se il corpo della richiesta è cambiato, potrebbe essere restituito un errore 409 che indica che il requestId deve essere eliminato.
Ottenere un Drive condiviso
Per ottenere i metadati di un Drive condiviso, utilizza il
get metodo sulla drives risorsa con il driveId parametro di percorso. Se non conosci l'ID del Drive, puoi elencare tutti i Drive condivisi utilizzando il metodo list.
Il metodo get restituisce un Drive condiviso come istanza di una risorsa drives.
Per inviare la richiesta come amministratore di dominio, imposta il parametro di query useDomainAdminAccess su true. Per saperne di più, vedi Gestire i Drive condivisi come
amministratori di dominio.
Elencare i Drive condivisi
Per elencare i Drive condivisi di un utente, utilizza il list
metodo sulla drives risorsa. Il metodo restituisce un elenco di Drive condivisi.
Passa i seguenti parametri di query per personalizzare la paginazione o filtrare i Drive condivisi:
pageSize: il numero massimo di Drive condivisi da restituire per pagina.pageToken: un token di pagina ricevuto da una precedente chiamata dell'elenco. Fornisci questo token per recuperare la pagina successiva.q: stringa di query per la ricerca di Drive condivisi. Per saperne di più, vedi Cercare Drive condivisi.useDomainAdminAccess: imposta sutrueper inviare la richiesta come amministratore di dominio per restituire tutti i Drive condivisi del dominio in cui il richiedente è un amministratore. Per saperne di più, vedi Gestire i Drive condivisi come amministratori di dominio.
Aggiornare un Drive condiviso
Per aggiornare i metadati di un Drive condiviso, utilizza il update metodo sulla
drives risorsa con il driveId parametro
di percorso.
Il metodo restituisce un Drive condiviso come istanza di una risorsa drives.
Per inviare la richiesta come amministratore di dominio, imposta il parametro di query useDomainAdminAccess su true. Per saperne di più, vedi Gestire i Drive condivisi come
amministratori di dominio.
Nascondere e mostrare un Drive condiviso
Per nascondere un Drive condiviso dalla visualizzazione predefinita, utilizza il hide metodo sulla
drives risorsa con il driveId parametro.
Quando un Drive condiviso è nascosto, Drive contrassegna la risorsa del Drive condiviso come hidden=true. I Drive condivisi nascosti non vengono visualizzati nell'interfaccia utente di Drive o nell'elenco dei file restituiti.
Per ripristinare un Drive condiviso nella visualizzazione predefinita, utilizza il unhide metodo sulla
drives risorsa con il driveId parametro.
Entrambi i metodi restituiscono un Drive condiviso come istanza di una risorsa drives.
Eliminare un Drive condiviso
Per eliminare definitivamente un Drive condiviso, utilizza il
delete metodo sulla risorsa drives con il parametro driveId.
Prima di eliminare un Drive condiviso, tutti i contenuti al suo interno devono essere spostati nel cestino o eliminati. L'utente deve anche avere role=organizer nella cartella del Drive condiviso. Per saperne di più, vedi Spostare file e cartelle nel cestino o eliminarli.
Passa i seguenti parametri di query per filtrare i Drive condivisi:
useDomainAdminAccess: imposta sutrueper inviare la richiesta come amministratore di dominio per restituire tutti i Drive condivisi del dominio in cui il richiedente è un amministratore. Per saperne di più, vedi Gestire i Drive condivisi come amministratori di dominio.allowItemDeletion: imposta sutrueper eliminare gli elementi all'interno del Drive condiviso. Supportato solo se ancheuseDomainAdminAccessè impostato sutrue.
Aggiungere o rimuovere membri del Drive condiviso
Aggiungi o rimuovi membri del Drive condiviso utilizzando la
permissions risorsa.
Per aggiungere un membro, crea l'autorizzazione sul Drive condiviso. I metodi di autorizzazione possono essere utilizzati anche per i singoli file all'interno di un Drive condiviso per concedere ai membri privilegi aggiuntivi o consentire ai non membri di collaborare a elementi specifici.
Per saperne di più e per visualizzare esempi di codice campione, vedi Condividere file, cartelle e Drive.
Gestire i Drive condivisi come amministratori di dominio
Applica il parametro useDomainAdminAccess con le risorse drives e permissions
per gestire i Drive condivisi in un'organizzazione.
Gli utenti che chiamano questi metodi con useDomainAdminAccess=true devono disporre del
Drive and Docs privilegio
di amministratore.
Gli amministratori possono cercare Drive
condivisi o aggiornare le autorizzazioni per i Drive
condivisi di proprietà della loro organizzazione, indipendentemente dall'appartenenza dell'amministratore
a un determinato Drive condiviso.
Quando utilizzi i service account, potresti dover simulare l'identità di un amministratore autenticato utilizzando la simulazione dell'identità dei service account. Tieni presente che i service account non appartengono al tuo dominio Google Workspace, a differenza degli account utente. Se condividi asset di Google Workspace, come documenti o eventi, con l'intero dominio Google Workspace, questi non vengono condivisi con i service account. Per saperne di più, vedi Service accounts overview.
Recuperare un Drive condiviso che non ha un organizzatore
Il seguente esempio di codice mostra come recuperare i Drive condivisi che non hanno più un organizzatore.
Java
Python
Node.js
PHP
.NET
Impedire agli utenti di scaricare, stampare o copiare un file
Puoi limitare il modo in cui gli utenti possono scaricare, stampare e copiare i file all'interno dei Drive condivisi.
Per determinare se l'utente può modificare le limitazioni di download applicate dall'organizzatore di un Drive condiviso, controlla il campo booleano capabilities.canChangeDownloadRestriction. Se capabilities.canChangeDownloadRestriction è impostato su true, è possibile applicare limitazioni di download al Drive condiviso. Per saperne di più, vedi
Informazioni sulle funzionalità dei file.
La risorsa drives contiene una raccolta di
campi booleani restrictions
utilizzati per indicare se un'azione può essere eseguita su un Drive condiviso.
Le limitazioni si applicano a un Drive condiviso o agli elementi al suo interno.
Le limitazioni possono essere impostate utilizzando il drives.update metodo.
Per applicare le limitazioni di download a un Drive condiviso, un gestore del Drive condiviso può impostare
il restrictions.downloadRestriction campo della drives
risorsa utilizzando l'
DownloadRestriction oggetto.
L'impostazione del campo booleano restrictedForReaders su true dichiara che sia il download sia la copia sono limitati per i lettori. L'impostazione del campo booleano restrictedForWriters su true dichiara che sia il download sia la copia sono limitati per gli autori. Tieni presente che se il campo restrictedForWriters è true, il download e la copia sono limitati anche per i lettori. Allo stesso modo, l'impostazione di restrictedForWriters su true e restrictedForReaders su false equivale all'impostazione di restrictedForWriters e restrictedForReaders su true.
Compatibilità con le versioni precedenti
Con l'introduzione dell'oggetto DownloadRestriction, la funzionalità del campo booleano
restrictions.copyRequiresWriterPermission
è stata aggiornata.
Ora, l'impostazione di restrictions.copyRequiresWriterPermission su true aggiorna il
restrictedForReaders campo booleano dell'oggetto DownloadRestriction su true per dichiarare che
sia il download sia la copia sono limitati per i lettori.
L'impostazione del campo copyRequiresWriterPermission su false aggiorna i campi restrictedForWriters e restrictedForReaders su false. Ciò significa che le impostazioni di limitazione del download o della copia vengono rimosse per tutti gli utenti.
Campi che controllano le funzionalità di download, stampa e copia
La tabella seguente elenca i campi delle risorse drives
che influiscono sulla funzionalità di download, stampa e copia:
| Campo | Descrizione | Versione |
|---|---|---|
capabilities.canCopy |
Indica se l'utente corrente può copiare i file in un Drive condiviso. | v2 e v3 |
capabilities.canDownload |
Indica se l'utente corrente può scaricare i file in un Drive condiviso. | v2 e v3 |
capabilities.canChangeCopyRequiresWriterPermission |
Indica se l'utente corrente può modificare la limitazione copyRequiresWriterPermission di un Drive condiviso. |
v2 e v3 |
capabilities.canResetDriveRestrictions |
Indica se l'utente corrente può reimpostare le limitazioni del Drive condiviso sui valori predefiniti. | v2 e v3 |
capabilities.canChangeDownloadRestriction |
Indica se l'utente corrente può modificare la limitazione di download di un Drive condiviso. | Solo v3 |
restrictions.copyRequiresWriterPermission |
Indica se le opzioni per copiare, stampare o scaricare i file all'interno di un Drive condiviso sono disattivate per lettori e commentatori. Se true, imposta il campo con lo stesso nome su true per qualsiasi file all'interno di questo Drive condiviso. |
v2 e v3 |
restrictions.downloadRestriction |
Le limitazioni di download applicate dai gestori dei Drive condivisi. | Solo v3 |
Limiti per le cartelle
Le cartelle dei Drive condivisi hanno alcuni limiti di spazio di archiviazione. Per saperne di più, vedi Limiti relativi ai Drive condivisi su Google Drive.
Limite massimo di elementi
Il Drive condiviso di ogni utente ha un limite di 500.000 elementi, inclusi file, cartelle e scorciatoie.
Una volta raggiunto il limite, il Drive condiviso non può più accettare elementi. Per riprendere a ricevere file, gli utenti devono eliminare definitivamente gli elementi dal Drive condiviso. Tieni presente che gli elementi nel cestino vengono conteggiati ai fini del limite, ma gli elementi eliminati definitivamente no. Per saperne di più, vedi Spostare file e cartelle nel cestino o eliminarli .
Limite di profondità delle cartelle
Una cartella di un Drive condiviso non può contenere più di 100 livelli di cartelle nidificate. Ciò significa che una cartella secondaria non può essere archiviata in una cartella con una profondità superiore a 99 livelli. Questa limitazione si applica solo alle cartelle secondarie.
I tentativi di aggiungere più di 100 livelli di cartelle restituiscono una
teamDriveHierarchyTooDeep
risposta con codice di stato HTTP.