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 risorsa drives
. 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ù, consulta Restituire
campi specifici.
Per scoprire 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 metodo create
sulla risorsa drives
con il parametro requestId
.
Il parametro requestId
identifica il tentativo logico di creazione idempotente
di un Drive condiviso. Se la richiesta scade o restituisce un errore di backend indeterminato, la stessa richiesta può essere ripetuta e non creerà duplicati. requestId
e 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
metodo get
sulla risorsa drives
con il parametro di percorso driveId
. 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 metodo list
nella risorsa drives
. Il metodo restituisce
un elenco di Drive condivisi.
Trasmetti 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 nei Drive condivisi. Per saperne di più, vedi Cercare i Drive condivisi.useDomainAdminAccess
: impostalo sutrue
per inviare la richiesta come amministratore di dominio e restituire tutti i Drive condivisi del dominio in cui il richiedente è un amministratore. Per maggiori informazioni, vedi Gestire i Drive condivisi come amministratori di dominio.
Aggiornare un Drive condiviso
Per aggiornare i metadati di un Drive condiviso, utilizza il metodo update
sulla risorsa
drives
con il parametro del percorso driveId
.
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 metodo hide
sulla risorsa drives
con il parametro driveId
.
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 la visualizzazione predefinita di un Drive condiviso, utilizza il metodo unhide
sulla risorsa drives
con il parametro driveId
.
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 metodo
delete
sulla risorsa drives
con il parametro driveId
.
Prima di eliminare un Drive condiviso, tutti i contenuti devono essere spostati nel cestino o eliminati. L'utente deve disporre anche dell'autorizzazione role=organizer
per la cartella del Drive condiviso. Per ulteriori informazioni, vedi Spostare nel cestino o eliminare file e cartelle.
Passa i seguenti parametri di query per filtrare i Drive condivisi:
useDomainAdminAccess
: impostalo sutrue
per inviare la richiesta come amministratore di dominio e restituire tutti i Drive condivisi del dominio in cui il richiedente è un amministratore. Per maggiori informazioni, vedi Gestire i Drive condivisi come amministratori di dominio.allowItemDeletion
: impostalo sutrue
per eliminare gli elementi all'interno del Drive condiviso. Supportato solo quandouseDomainAdminAccess
è impostato anche sutrue
.
Aggiungere o rimuovere membri del Drive condiviso
Aggiungi o rimuovi membri del Drive condiviso utilizzando la risorsa
permissions
.
Per aggiungere un membro, crea l'autorizzazione sul Drive condiviso. I metodi di autorizzazione possono essere utilizzati anche per 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 ulteriori informazioni e codice di esempio, vedi Condividere file, cartelle e unità.
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 i 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 rappresentare un amministratore autenticato utilizzando la rappresentazione del 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 gli account di servizio. Per ulteriori informazioni, consulta la panoramica dei service account.
Recuperare un Drive condiviso senza 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
restrizioni 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.
I limiti possono essere impostati utilizzando il metodo drives.update
.
Per applicare le limitazioni al download a un Drive condiviso, un gestore del Drive condiviso può impostare
il campo restrictions.downloadRestriction
della risorsa drives
utilizzando l'oggetto
DownloadRestriction
.
Se imposti il campo booleano restrictedForReaders
su true
, dichiari che sia il download che la copia sono limitati per i lettori. Se imposti il campo booleano restrictedForWriters
su true
, dichiari che sia il download che la copia sono limitati per
gli autori. Tieni presente che se il campo restrictedForWriters
è true
, anche il download e la
copia sono limitati per i lettori. Analogamente, impostare restrictedForWriters
su true
e restrictedForReaders
su false
equivale a impostare sia
restrictedForWriters
che 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
campo booleano restrictedForReaders
dell'oggetto DownloadRestriction
su true
per dichiarare che
il download e la copia sono limitati per i lettori.
Se imposti il campo copyRequiresWriterPermission
su false
, vengono aggiornati sia i campi
restrictedForWriters
che 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 sulle funzionalità di download, stampa e copia:
Campo | Descrizione | Versione |
---|---|---|
capabilities.canCopy |
Indica se l'utente attuale può copiare i file in un Drive condiviso. | v2 e v3 |
capabilities.canDownload |
Indica se l'utente attuale 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 attuale può reimpostare le limitazioni del Drive condiviso sui valori predefiniti. | v2 e v3 |
capabilities.canChangeDownloadRestriction |
Indica se l'utente corrente può modificare la limitazione dei download di un Drive condiviso. | Solo v3 |
restrictions.copyRequiresWriterPermission |
Se le opzioni per copiare, stampare o scaricare i file all'interno di un Drive condiviso sono disattivate per lettori e commentatori. Quando true , il campo con nome simile viene impostato su true per qualsiasi file all'interno di questo Drive condiviso. |
v2 e v3 |
restrictions.downloadRestriction |
Le limitazioni al download applicate dai gestori del Drive condiviso. | Solo v3 |
Limiti per le cartelle
Le cartelle dei Drive condivisi hanno alcuni limiti di spazio di archiviazione. Per informazioni, vedi Limiti relativi ai Drive condivisi su Google Drive.
Limite massimo di elementi
Il Drive condiviso di ogni utente può contenere massimo 500.000 elementi, compresi 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 quelli eliminati definitivamente no. Per saperne di più, vedi Spostare nel cestino o eliminare file e cartelle.
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 più di 99 livelli di profondità. Questa limitazione si applica solo alle cartelle secondarie.
I tentativi di aggiungere più di 100 livelli di cartelle restituiscono un codice di stato HTTP teamDriveHierarchyTooDeep
.