Questa pagina è stata tradotta dall'API Cloud Translation.

Drive Service

Questo servizio consente agli script di creare, trovare e modificare file e cartelle su Google Drive.

Se lo script utilizza un progetto Cloud standard anziché un progetto Cloud predefinito, devi attivare manualmente l'API Drive. Nel tuo progetto cloud standard, attiva l'API Drive:

Attiva l'API Drive

Il seguente esempio di codice mostra come registrare i nomi di ciascun file nella cartella Il mio Drive dell'utente:

// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Nota: gli amministratori di Google Workspace possono disattivare l'SDK Drive per il proprio dominio, impedendo così agli utenti di installare e utilizzare le app Google Drive. Questa impostazione impedisce inoltre agli utenti di utilizzare script di Apps Script, app web e componenti aggiuntivi che utilizzano il servizio Drive o il servizio Drive avanzato, anche se il componente aggiuntivo o l'app web sono stati installati prima che l'amministratore disattivasse l'SDK Drive.

Tuttavia, se un componente aggiuntivo che utilizza il servizio Drive viene pubblicato per essere installato a livello di dominio e viene installato dall'amministratore per alcuni o tutti gli utenti del dominio oppure per qualsiasi script il cui client OAuth è stato inserito nella lista consentita dall'amministratore di dominio, il componente aggiuntivo funziona per quegli utenti anche se l'SDK Drive è disattivato nel dominio.

Corsi

Nome	Breve descrizione
`Access`	Un'enumerazione che rappresenta le classi di utenti che possono accedere a un file o a una cartella, oltre ai singoli utenti a cui è stato esplicitamente concesso l'accesso.
`DriveApp`	Consente agli script di creare, trovare e modificare file e cartelle su Google Drive.
`File`	Un file su Google Drive.
`FileIterator`	Un iteratore che consente agli script di eseguire l'iterazione su una raccolta potenzialmente di grandi dimensioni di file.
`Folder`	Una cartella su Google Drive.
`FolderIterator`	Un oggetto che consente agli script di eseguire l'iterazione su una raccolta potenzialmente estesa di cartelle.
`Permission`	Un'enumerazione che rappresenta le autorizzazioni concesse agli utenti che possono accedere a un file o a una cartella, oltre ai singoli utenti a cui è stato esplicitamente concesso l'accesso.
`User`	Un utente associato a un file su Google Drive.

`Access`

Proprietà

Proprietà	Tipo	Descrizione
`ANYONE`	`Enum`	Chiunque abbia accesso a internet può trovare e accedere.
`ANYONE_WITH_LINK`	`Enum`	Chiunque abbia il link può accedere.
`DOMAIN`	`Enum`	Le persone nel tuo dominio possono trovare questo elemento e accedervi.
`DOMAIN_WITH_LINK`	`Enum`	Gli utenti del tuo dominio che hanno il link possono accedere.
`PRIVATE`	`Enum`	L'accesso è riservato a utenti che hanno esplicitamente ricevuto un'autorizzazione.

`DriveApp`

Proprietà

Proprietà	Tipo	Descrizione
`Access`	`Access`	Un'enumerazione che rappresenta le classi di utenti che possono accedere a un file o a una cartella, oltre ai singoli utenti a cui è stato esplicitamente concesso l'accesso.
`Permission`	`Permission`	Un'enumerazione che rappresenta le autorizzazioni concesse agli utenti che possono accedere a un file o a una cartella, oltre ai singoli utenti a cui è stato esplicitamente concesso l'accesso.

Metodi

Metodo	Tipo restituito	Breve descrizione
`continueFileIterator(continuationToken)`	`FileIterator`	Riprende un'iterazione del file utilizzando un token di continuazione di un iteratore precedente.
`continueFolderIterator(continuationToken)`	`FolderIterator`	Riprende l'iterazione di una cartella utilizzando un token di continuazione di un iteratore precedente.
`createFile(blob)`	`File`	Crea un file nella directory principale del Drive dell'utente a partire da un determinato `Blob` di dati arbitrari.
`createFile(name, content)`	`File`	Crea un file di testo nella directory principale di Drive dell'utente con il nome e i contenuti specificati.
`createFile(name, content, mimeType)`	`File`	Crea un file nella directory principale di Drive dell'utente con il nome, i contenuti e il tipo MIME specificati.
`createFolder(name)`	`Folder`	Crea una cartella nella directory principale di Drive dell'utente con il nome specificato.
`createShortcut(targetId)`	`File`	Crea una scorciatoia all'ID elemento di Drive fornito e la restituisce.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Crea una scorciatoia all'ID elemento di Drive e alla chiave risorsa forniti e la restituisce.
`enforceSingleParent(value)`	`void`	Consente di attivare o disattivare il comportamento applySingleParent per tutte le chiamate che interessano i genitori degli elementi.
`getFileById(id)`	`File`	Restituisce il file con l'ID specificato.
`getFileByIdAndResourceKey(id, resourceKey)`	`File`	Restituisce il file con l'ID e la chiave risorsa specificati.
`getFiles()`	`FileIterator`	Recupera una raccolta di tutti i file presenti nel Drive dell'utente.
`getFilesByName(name)`	`FileIterator`	Recupera una raccolta di tutti i file del Drive dell'utente che hanno il nome specificato.
`getFilesByType(mimeType)`	`FileIterator`	Recupera una raccolta di tutti i file del Drive dell'utente che hanno il tipo MIME specificato.
`getFolderById(id)`	`Folder`	Restituisce la cartella con l'ID specificato.
`getFolderByIdAndResourceKey(id, resourceKey)`	`Folder`	Restituisce la cartella con l'ID e la chiave della risorsa specificati.
`getFolders()`	`FolderIterator`	Recupera una raccolta di tutte le cartelle nel Drive dell'utente.
`getFoldersByName(name)`	`FolderIterator`	Recupera una raccolta di tutte le cartelle nel Drive dell'utente che hanno il nome specificato.
`getRootFolder()`	`Folder`	Recupera la cartella nella directory principale di Drive dell'utente.
`getStorageLimit()`	`Integer`	Restituisce il numero di byte che l'utente è autorizzato ad archiviare su Drive.
`getStorageUsed()`	`Integer`	Restituisce il numero di byte che l'utente sta archiviando attualmente su Drive.
`getTrashedFiles()`	`FileIterator`	Recupera una raccolta di tutti i file presenti nel cestino del Drive dell'utente.
`getTrashedFolders()`	`FolderIterator`	Recupera una raccolta di tutte le cartelle presenti nel cestino di Drive dell'utente.
`searchFiles(params)`	`FileIterator`	Restituisce una raccolta di tutti i file di Drive dell'utente che corrispondono ai criteri di ricerca specificati.
`searchFolders(params)`	`FolderIterator`	Restituisce una raccolta di tutte le cartelle nel Drive dell'utente che corrispondono ai criteri di ricerca specificati.

`File`

Metodi

Metodo	Tipo restituito	Breve descrizione
`addCommenter(emailAddress)`	`File`	Aggiungi l'utente specificato all'elenco di commentatori per `File`.
`addCommenter(user)`	`File`	Aggiungi l'utente specificato all'elenco di commentatori per `File`.
`addCommenters(emailAddresses)`	`File`	Aggiungi l'array specificato di utenti all'elenco di commentatori per `File`.
`addEditor(emailAddress)`	`File`	Aggiunge l'utente specificato all'elenco degli editor per `File`.
`addEditor(user)`	`File`	Aggiunge l'utente specificato all'elenco degli editor per `File`.
`addEditors(emailAddresses)`	`File`	Aggiunge l'array specificato di utenti all'elenco degli editor per `File`.
`addViewer(emailAddress)`	`File`	Aggiunge l'utente specificato all'elenco dei visualizzatori per `File`.
`addViewer(user)`	`File`	Aggiunge l'utente specificato all'elenco dei visualizzatori per `File`.
`addViewers(emailAddresses)`	`File`	Aggiunge l'array specificato di utenti all'elenco dei visualizzatori per `File`.
`getAccess(email)`	`Permission`	Consente di ottenere l'autorizzazione concessa all'utente specificato.
`getAccess(user)`	`Permission`	Consente di ottenere l'autorizzazione concessa all'utente specificato.
`getAs(contentType)`	`Blob`	Restituisce i dati all'interno di questo oggetto sotto forma di blob convertito nel tipo di contenuto specificato.
`getBlob()`	`Blob`	Restituisce i dati all'interno di questo oggetto sotto forma di blob.
`getDateCreated()`	`Date`	Recupera la data di creazione di `File`.
`getDescription()`	`String`	Recupera la descrizione di `File`.
`getDownloadUrl()`	`String`	Consente di acquisire l'URL che può essere utilizzato per scaricare il file.
`getEditors()`	`User[]`	Consente di acquisire l'elenco degli editor di `File`.
`getId()`	`String`	Recupera l'ID di `File`.
`getLastUpdated()`	`Date`	Visualizza la data dell'ultimo aggiornamento di `File`.
`getMimeType()`	`String`	Restituisce il tipo MIME del file.
`getName()`	`String`	Recupera il nome di `File`.
`getOwner()`	`User`	Ottieni il proprietario del file.
`getParents()`	`FolderIterator`	Recupera una raccolta di cartelle che sono elementi padre stretti di `File`.
`getResourceKey()`	`String`	Recupera la chiave risorsa di `File` necessaria per accedere agli elementi condivisi utilizzando un link.
`getSecurityUpdateEligible()`	`Boolean`	Riconosce se questo `File` è idoneo ad applicare l'aggiornamento della sicurezza che richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link.
`getSecurityUpdateEnabled()`	`Boolean`	Riconosce se questo `File` richiede una chiave della risorsa per l'accesso quando viene condiviso tramite un link.
`getSharingAccess()`	`Access`	Restituisce la classe di utenti che può accedere a `File`, oltre a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
`getSharingPermission()`	`Permission`	Ottieni l'autorizzazione concessa agli utenti che possono accedere a `File`, oltre ai singoli utenti a cui è stato concesso esplicitamente l'accesso.
`getSize()`	`Integer`	Restituisce il numero di byte utilizzati per archiviare `File` in Drive.
`getTargetId()`	`String`	Se si tratta di una scorciatoia, restituisce l'ID dell'elemento a cui rimanda.
`getTargetMimeType()`	`String`	Se si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui rimanda.
`getTargetResourceKey()`	`String`	Se il file è una scorciatoia, restituisce la chiave risorsa dell'elemento a cui rimanda.
`getThumbnail()`	`Blob`	Restituisce un'immagine in miniatura per il file o `null` se non esiste una miniatura.
`getUrl()`	`String`	Recupera l'URL che può essere utilizzato per aprire `File` in un'app Google come Drive o Documenti.
`getViewers()`	`User[]`	Visualizza l'elenco di spettatori e commentatori per `File`.
`isShareableByEditors()`	`Boolean`	Determina se gli utenti con autorizzazioni di modifica per `File` sono autorizzati a condividere contenuti con altri utenti o a modificare le autorizzazioni.
`isStarred()`	`Boolean`	Determina se `File` è stato aggiunto a Speciali nel Drive dell'utente.
`isTrashed()`	`Boolean`	Determina se `File` si trova nel cestino del Drive dell'utente.
`makeCopy()`	`File`	Crea una copia del file.
`makeCopy(destination)`	`File`	Crea una copia del file nella directory di destinazione.
`makeCopy(name)`	`File`	Crea una copia del file e lo assegna al nome fornito.
`makeCopy(name, destination)`	`File`	Crea una copia del file nella directory di destinazione e la denomina con il nome fornito.
`moveTo(destination)`	`File`	Sposta questo elemento nella cartella di destinazione fornita.
`removeCommenter(emailAddress)`	`File`	Rimuove l'utente specificato dall'elenco dei commentatori per `File`.
`removeCommenter(user)`	`File`	Rimuove l'utente specificato dall'elenco dei commentatori per `File`.
`removeEditor(emailAddress)`	`File`	Rimuove l'utente specificato dall'elenco degli editor per `File`.
`removeEditor(user)`	`File`	Rimuove l'utente specificato dall'elenco degli editor per `File`.
`removeViewer(emailAddress)`	`File`	Rimuove l'utente specificato dall'elenco dei visualizzatori e commentatori per `File`.
`removeViewer(user)`	`File`	Rimuove l'utente specificato dall'elenco dei visualizzatori e commentatori per `File`.
`revokePermissions(emailAddress)`	`File`	Revoca l'accesso a `File` concesso all'utente specificato.
`revokePermissions(user)`	`File`	Revoca l'accesso a `File` concesso all'utente specificato.
`setContent(content)`	`File`	Sovrascrive il contenuto del file con una determinata sostituzione.
`setDescription(description)`	`File`	Consente di impostare la descrizione dell'elemento `File`.
`setName(name)`	`File`	Imposta il nome dell'oggetto `File`.
`setOwner(emailAddress)`	`File`	Cambia il proprietario di `File`.
`setOwner(user)`	`File`	Cambia il proprietario di `File`.
`setSecurityUpdateEnabled(enabled)`	`File`	Consente di impostare se `File` richiede una chiave della risorsa per l'accesso quando viene condivisa tramite un link.
`setShareableByEditors(shareable)`	`File`	Consente di stabilire se gli utenti con autorizzazioni di modifica per `File` possono condividere con altri utenti o modificare le autorizzazioni.
`setSharing(accessType, permissionType)`	`File`	Imposta la classe di utenti che può accedere a `File` e le autorizzazioni concesse a tali utenti, oltre ai singoli utenti a cui è stato concesso esplicitamente l'accesso.
`setStarred(starred)`	`File`	Consente di impostare se l'elemento `File` viene aggiunto a Speciali nel Drive dell'utente.
`setTrashed(trashed)`	`File`	Consente di impostare se `File` si trova nel cestino del Drive dell'utente.

`FileIterator`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getContinuationToken()`	`String`	Recupera un token che può essere utilizzato per riprendere questa iterazione in un secondo momento.
`hasNext()`	`Boolean`	Determina se la chiamata a `next()` restituisce un elemento.
`next()`	`File`	Consente di acquisire l'elemento successivo nella raccolta di file o cartelle.

`Folder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`addEditor(emailAddress)`	`Folder`	Aggiunge l'utente specificato all'elenco degli editor per `Folder`.
`addEditor(user)`	`Folder`	Aggiunge l'utente specificato all'elenco degli editor per `Folder`.
`addEditors(emailAddresses)`	`Folder`	Aggiunge l'array specificato di utenti all'elenco degli editor per `Folder`.
`addViewer(emailAddress)`	`Folder`	Aggiunge l'utente specificato all'elenco dei visualizzatori per `Folder`.
`addViewer(user)`	`Folder`	Aggiunge l'utente specificato all'elenco dei visualizzatori per `Folder`.
`addViewers(emailAddresses)`	`Folder`	Aggiunge l'array specificato di utenti all'elenco dei visualizzatori per `Folder`.
`createFile(blob)`	`File`	Crea un file nella cartella corrente a partire da un determinato `Blob` di dati arbitrari.
`createFile(name, content)`	`File`	Crea un file di testo nella cartella corrente con il nome e i contenuti specificati.
`createFile(name, content, mimeType)`	`File`	Crea un file nella cartella corrente con il nome, i contenuti e il tipo MIME specificati.
`createFolder(name)`	`Folder`	Crea una cartella nella cartella corrente con il nome specificato.
`createShortcut(targetId)`	`File`	Crea una scorciatoia all'ID elemento di Drive fornito e la restituisce.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Crea una scorciatoia all'ID elemento di Drive e alla chiave risorsa forniti e la restituisce.
`getAccess(email)`	`Permission`	Consente di ottenere l'autorizzazione concessa all'utente specificato.
`getAccess(user)`	`Permission`	Consente di ottenere l'autorizzazione concessa all'utente specificato.
`getDateCreated()`	`Date`	Recupera la data di creazione di `Folder`.
`getDescription()`	`String`	Recupera la descrizione di `Folder`.
`getEditors()`	`User[]`	Consente di acquisire l'elenco degli editor di `Folder`.
`getFiles()`	`FileIterator`	Restituisce una raccolta di tutti i file che sono secondari della cartella corrente.
`getFilesByName(name)`	`FileIterator`	Restituisce una raccolta di tutti i file che sono secondari della cartella corrente e hanno il nome specificato.
`getFilesByType(mimeType)`	`FileIterator`	Restituisce una raccolta di tutti i file secondari della cartella corrente con il tipo MIME specificato.
`getFolders()`	`FolderIterator`	Restituisce una raccolta di tutte le cartelle secondarie della cartella corrente.
`getFoldersByName(name)`	`FolderIterator`	Restituisce una raccolta di tutte le cartelle che sono secondarie della cartella corrente e hanno il nome specificato.
`getId()`	`String`	Recupera l'ID di `Folder`.
`getLastUpdated()`	`Date`	Visualizza la data dell'ultimo aggiornamento di `Folder`.
`getName()`	`String`	Recupera il nome di `Folder`.
`getOwner()`	`User`	Ottieni il proprietario di questo `Folder`.
`getParents()`	`FolderIterator`	Recupera una raccolta di cartelle che sono elementi padre stretti di `Folder`.
`getResourceKey()`	`String`	Recupera la chiave risorsa di `Folder` necessaria per accedere agli elementi condivisi utilizzando un link.
`getSecurityUpdateEligible()`	`Boolean`	Riconosce se questo `Folder` è idoneo ad applicare l'aggiornamento della sicurezza che richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link.
`getSecurityUpdateEnabled()`	`Boolean`	Riconosce se questo `Folder` richiede una chiave della risorsa per l'accesso quando viene condiviso tramite un link.
`getSharingAccess()`	`Access`	Restituisce la classe di utenti che può accedere a `Folder`, oltre a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
`getSharingPermission()`	`Permission`	Ottieni l'autorizzazione concessa agli utenti che possono accedere a `Folder`, oltre ai singoli utenti a cui è stato concesso esplicitamente l'accesso.
`getSize()`	`Integer`	Restituisce il numero di byte utilizzati per archiviare `Folder` in Drive.
`getUrl()`	`String`	Recupera l'URL che può essere utilizzato per aprire `Folder` in un'app Google come Drive o Documenti.
`getViewers()`	`User[]`	Visualizza l'elenco di spettatori e commentatori per `Folder`.
`isShareableByEditors()`	`Boolean`	Determina se gli utenti con autorizzazioni di modifica per `Folder` sono autorizzati a condividere contenuti con altri utenti o a modificare le autorizzazioni.
`isStarred()`	`Boolean`	Determina se `Folder` è stato aggiunto a Speciali nel Drive dell'utente.
`isTrashed()`	`Boolean`	Determina se `Folder` si trova nel cestino del Drive dell'utente.
`moveTo(destination)`	`Folder`	Sposta questo elemento nella cartella di destinazione fornita.
`removeEditor(emailAddress)`	`Folder`	Rimuove l'utente specificato dall'elenco degli editor per `Folder`.
`removeEditor(user)`	`Folder`	Rimuove l'utente specificato dall'elenco degli editor per `Folder`.
`removeViewer(emailAddress)`	`Folder`	Rimuove l'utente specificato dall'elenco dei visualizzatori e commentatori per `Folder`.
`removeViewer(user)`	`Folder`	Rimuove l'utente specificato dall'elenco dei visualizzatori e commentatori per `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Revoca l'accesso a `Folder` concesso all'utente specificato.
`revokePermissions(user)`	`Folder`	Revoca l'accesso a `Folder` concesso all'utente specificato.
`searchFiles(params)`	`FileIterator`	Restituisce una raccolta di tutti i file che sono secondari della cartella corrente e che corrispondono ai criteri di ricerca specificati.
`searchFolders(params)`	`FolderIterator`	Restituisce una raccolta di tutte le cartelle che sono secondarie della cartella corrente e che corrispondono ai criteri di ricerca specificati.
`setDescription(description)`	`Folder`	Consente di impostare la descrizione dell'elemento `Folder`.
`setName(name)`	`Folder`	Imposta il nome dell'oggetto `Folder`.
`setOwner(emailAddress)`	`Folder`	Cambia il proprietario di `Folder`.
`setOwner(user)`	`Folder`	Cambia il proprietario di `Folder`.
`setSecurityUpdateEnabled(enabled)`	`Folder`	Consente di impostare se `Folder` richiede una chiave della risorsa per l'accesso quando viene condivisa tramite un link.
`setShareableByEditors(shareable)`	`Folder`	Consente di stabilire se gli utenti con autorizzazioni di modifica per `Folder` possono condividere con altri utenti o modificare le autorizzazioni.
`setSharing(accessType, permissionType)`	`Folder`	Imposta la classe di utenti che può accedere a `Folder` e le autorizzazioni concesse a tali utenti, oltre ai singoli utenti a cui è stato concesso esplicitamente l'accesso.
`setStarred(starred)`	`Folder`	Consente di impostare se l'elemento `Folder` viene aggiunto a Speciali nel Drive dell'utente.
`setTrashed(trashed)`	`Folder`	Consente di impostare se `Folder` si trova nel cestino del Drive dell'utente.

`FolderIterator`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getContinuationToken()`	`String`	Recupera un token che può essere utilizzato per riprendere questa iterazione in un secondo momento.
`hasNext()`	`Boolean`	Determina se la chiamata a `next()` restituisce un elemento.
`next()`	`Folder`	Consente di acquisire l'elemento successivo nella raccolta di file o cartelle.

`Permission`

Proprietà

Proprietà	Tipo	Descrizione
`VIEW`	`Enum`	Gli utenti che possono accedere al file o alla cartella possono solo visualizzarlo o copiarlo.
`EDIT`	`Enum`	Gli utenti che possono accedere al file o alla cartella possono modificarlo.
`COMMENT`	`Enum`	Gli utenti che possono accedere al file o alla cartella possono solo visualizzarlo, copiarlo o commentarlo.
`OWNER`	`Enum`	Il file o la cartella sono di proprietà dell'utente.
`ORGANIZER`	`Enum`	Utenti che possono organizzare file e cartelle all'interno di un Drive condiviso.
`FILE_ORGANIZER`	`Enum`	Utenti che possono modificare, spostare nel cestino e spostare contenuti all'interno di un Drive condiviso.
`NONE`	`Enum`	L'utente non dispone di alcuna autorizzazione per il file o la cartella.

`User`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getDomain()`	`String`	Restituisce il nome di dominio associato all'account dell'utente.
`getEmail()`	`String`	Consente di acquisire l'indirizzo email dell'utente.
`getName()`	`String`	Restituisce il nome dell'utente.
`getPhotoUrl()`	`String`	Consente di acquisire l'URL della foto dell'utente.