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 instead of a default Cloud project, devi attivare manualmente l'API Drive. Nel progetto Cloud standard, attiva l'API Drive:

Attiva l'API Drive

Il seguente esempio di codice mostra come registrare i nomi di ogni 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 agli utenti di installare e utilizzare le app di 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 è stato installato prima che l'amministratore disattivasse l'SDK di Drive).

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

Corsi

Nome	Breve descrizione
`Access`	Un enum che rappresenta le classi di utenti che possono accedere a un file o a una cartella, oltre a eventuali singoli utenti a cui è stato concesso l'accesso esplicitamente.
`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 grande di file.
`Folder`	Una cartella in Google Drive.
`FolderIterator`	Un oggetto che consente agli script di eseguire l'iterazione su una raccolta potenzialmente grande di cartelle.
`Permission`	Un enum che rappresenta le autorizzazioni concesse agli utenti che possono accedere a un file o a una cartella, oltre a eventuali singoli utenti a cui è stato concesso l'accesso in modo esplicito.
`User`	Un utente associato a un file in Google Drive.

`Access`

Proprietà

Proprietà	Tipo	Descrizione
`ANYONE`	`Enum`	Chiunque navighi su internet può trovare e accedere a questo elemento.
`ANYONE_WITH_LINK`	`Enum`	Chiunque abbia il link può accedere.
`DOMAIN`	`Enum`	Le persone nel tuo dominio possono trovare e accedere.
`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 enum che rappresenta le classi di utenti che possono accedere a un file o a una cartella, oltre a eventuali singoli utenti a cui è stato concesso l'accesso esplicitamente.
`Permission`	`Permission`	Un enum che rappresenta le autorizzazioni concesse agli utenti che possono accedere a un file o a una cartella, oltre a eventuali singoli utenti a cui è stato concesso l'accesso in modo esplicito.

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 un'iterazione della cartella utilizzando un token di continuazione di un iteratore precedente.
`createFile(blob)`	`File`	Crea un file nella directory principale di Drive dell'utente da un determinato `Blob` di dati arbitrari.
`createFile(name, content)`	`File`	Crea un file di testo nella cartella principale del Drive dell'utente con il nome e i contenuti specificati.
`createFile(name, content, mimeType)`	`File`	Crea un file nella directory principale del Drive dell'utente con il nome, i contenuti e il tipo MIME specificati.
`createFolder(name)`	`Folder`	Crea una cartella nella cartella 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 e alla chiave della risorsa di Drive forniti e la restituisce.
`enforceSingleParent(value)`	`void`	Attiva o disattiva il comportamento enforceSingleParent per tutte le chiamate che interessano gli elementi principali.
`getFileById(id)`	`File`	Recupera il file con l'ID specificato.
`getFileByIdAndResourceKey(id, resourceKey)`	`File`	Recupera il file con l'ID e la chiave di risorsa specificati.
`getFiles()`	`FileIterator`	Recupera una raccolta di tutti i file in Drive dell'utente.
`getFilesByName(name)`	`FileIterator`	Recupera una raccolta di tutti i file nel Drive dell'utente che hanno il nome specificato.
`getFilesByType(mimeType)`	`FileIterator`	Recupera una raccolta di tutti i file nel Drive dell'utente che hanno il tipo MIME specificato.
`getFolderById(id)`	`Folder`	Recupera la cartella con l'ID specificato.
`getFolderByIdAndResourceKey(id, resourceKey)`	`Folder`	Recupera la cartella con l'ID e la chiave della risorsa specificati.
`getFolders()`	`FolderIterator`	Recupera una raccolta di tutte le cartelle in Drive dell'utente.
`getFoldersByName(name)`	`FolderIterator`	Recupera una raccolta di tutte le cartelle di Drive dell'utente che hanno il nome specificato.
`getRootFolder()`	`Folder`	Recupera la cartella principale di Drive dell'utente.
`getStorageLimit()`	`Integer`	Restituisce il numero di byte che l'utente è autorizzato a memorizzare su Drive.
`getStorageUsed()`	`Integer`	Recupera il numero di byte attualmente archiviati dall'utente su Drive.
`getTrashedFiles()`	`FileIterator`	Recupera una raccolta di tutti i file nel cestino di Drive dell'utente.
`getTrashedFolders()`	`FolderIterator`	Recupera una raccolta di tutte le cartelle presenti nel cestino di Drive dell'utente.
`searchFiles(params)`	`FileIterator`	Recupera una raccolta di tutti i file in Drive dell'utente che corrispondono ai criteri di ricerca specificati.
`searchFolders(params)`	`FolderIterator`	Recupera una raccolta di tutte le cartelle di 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 dei commentatori per `File`.
`addCommenter(user)`	`File`	Aggiungi l'utente specificato all'elenco dei commentatori per `File`.
`addCommenters(emailAddresses)`	`File`	Aggiungi l'array di utenti specificato all'elenco dei commentatori per `File`.
`addEditor(emailAddress)`	`File`	Aggiunge l'utente specificato all'elenco degli editor di `File`.
`addEditor(user)`	`File`	Aggiunge l'utente specificato all'elenco degli editor di `File`.
`addEditors(emailAddresses)`	`File`	Aggiunge l'array di utenti specificato all'elenco degli editor di `File`.
`addViewer(emailAddress)`	`File`	Aggiunge l'utente specificato all'elenco degli spettatori del `File`.
`addViewer(user)`	`File`	Aggiunge l'utente specificato all'elenco degli spettatori del `File`.
`addViewers(emailAddresses)`	`File`	Aggiunge l'array di utenti specificato all'elenco degli spettatori per `File`.
`getAccess(email)`	`Permission`	Recupera l'autorizzazione concessa a un utente specifico.
`getAccess(user)`	`Permission`	Recupera l'autorizzazione concessa a un utente specifico.
`getAs(contentType)`	`Blob`	Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato.
`getBlob()`	`Blob`	Restituisce i dati all'interno di questo oggetto come blob.
`getDateCreated()`	`Date`	Recupera la data di creazione del `File`.
`getDescription()`	`String`	Recupera la descrizione di `File`.
`getDownloadUrl()`	`String`	Recupera l'URL che può essere utilizzato per scaricare il file.
`getEditors()`	`User[]`	Recupera l'elenco degli editor di questo `File`.
`getId()`	`String`	Recupera l'ID del `File`.
`getLastUpdated()`	`Date`	Recupera la data dell'ultimo aggiornamento di `File`.
`getMimeType()`	`String`	Recupera il tipo MIME del file.
`getName()`	`String`	Recupera il nome del `File`.
`getOwner()`	`User`	Recupera il proprietario del file.
`getParents()`	`FolderIterator`	Recupera una raccolta di cartelle che sono le cartelle principali immediate di `File`.
`getResourceKey()`	`String`	Recupera la chiave della risorsa del `File` necessaria per accedere agli elementi che sono stati condivisi utilizzando un link.
`getSecurityUpdateEligible()`	`Boolean`	Indica se questo `File` è idoneo per l'applicazione dell'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa quando viene condiviso tramite un link.
`getSecurityUpdateEnabled()`	`Boolean`	Indica se questo `File` richiede una chiave della risorsa per l'accesso quando viene condiviso utilizzando un link.
`getSharingAccess()`	`Access`	Restituisce la classe di utenti che può accedere al `File`, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
`getSharingPermission()`	`Permission`	Recupera l'autorizzazione concessa agli utenti che possono accedere a `File`, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
`getSize()`	`Integer`	Recupera il numero di byte utilizzati per archiviare il file `File` su 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 della risorsa dell'elemento a cui rimanda.
`getThumbnail()`	`Blob`	Restituisce un'immagine in miniatura del file o `null` se non esiste alcuna miniatura.
`getUrl()`	`String`	Recupera l'URL che può essere utilizzato per aprire il `File` in un'app Google come Drive o Documenti.
`getViewers()`	`User[]`	Recupera l'elenco di visualizzatori e commentatori per questo `File`.
`isShareableByEditors()`	`Boolean`	Determina se gli utenti con autorizzazioni di modifica per il `File` possono condividerlo con altri utenti o modificarne le autorizzazioni.
`isStarred()`	`Boolean`	Determina se `File` è stato aggiunto ai preferiti su Drive dell'utente.
`isTrashed()`	`Boolean`	Determina se `File` si trova nel cestino di 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 la rinomina con il nome fornito.
`makeCopy(name, destination)`	`File`	Crea una copia del file nella directory di destinazione e la rinomina con il nome fornito.
`moveTo(destination)`	`File`	Sposta questo elemento nella cartella di destinazione specificata.
`removeCommenter(emailAddress)`	`File`	Rimuove l'utente specificato dall'elenco dei commentatori per il `File`.
`removeCommenter(user)`	`File`	Rimuove l'utente specificato dall'elenco dei commentatori per il `File`.
`removeEditor(emailAddress)`	`File`	Rimuove l'utente specificato dall'elenco degli editor di `File`.
`removeEditor(user)`	`File`	Rimuove l'utente specificato dall'elenco degli editor di `File`.
`removeViewer(emailAddress)`	`File`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il `File`.
`removeViewer(user)`	`File`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il `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`	Sostituisce i contenuti del file con una determinata sostituzione.
`setDescription(description)`	`File`	Imposta la descrizione per `File`.
`setName(name)`	`File`	Imposta il nome del `File`.
`setOwner(emailAddress)`	`File`	Modifica il proprietario del `File`.
`setOwner(user)`	`File`	Modifica il proprietario del `File`.
`setSecurityUpdateEnabled(enabled)`	`File`	Imposta se `File` richiede una chiave della risorsa per l'accesso quando viene condivisa utilizzando un link.
`setShareableByEditors(shareable)`	`File`	Imposta se gli utenti con autorizzazioni di modifica per il `File` possono condividerlo 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 questi utenti, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
`setStarred(starred)`	`File`	Imposta se `File` è contrassegnato come preferito in Drive dell'utente.
`setTrashed(trashed)`	`File`	Imposta se `File` si trova nel cestino di Drive dell'utente.

`FileIterator`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getContinuationToken()`	`String`	Restituisce un token che può essere utilizzato per riprendere questa iterazione in un secondo momento.
`hasNext()`	`Boolean`	Determina se la chiamata a `next()` restituirà un elemento.
`next()`	`File`	Recupera 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 di `Folder`.
`addEditor(user)`	`Folder`	Aggiunge l'utente specificato all'elenco degli editor di `Folder`.
`addEditors(emailAddresses)`	`Folder`	Aggiunge l'array di utenti specificato all'elenco degli editor di `Folder`.
`addViewer(emailAddress)`	`Folder`	Aggiunge l'utente specificato all'elenco degli spettatori del `Folder`.
`addViewer(user)`	`Folder`	Aggiunge l'utente specificato all'elenco degli spettatori del `Folder`.
`addViewers(emailAddresses)`	`Folder`	Aggiunge l'array di utenti specificato all'elenco degli spettatori per `Folder`.
`createFile(blob)`	`File`	Crea un file nella cartella corrente 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 e alla chiave della risorsa di Drive forniti e la restituisce.
`getAccess(email)`	`Permission`	Recupera l'autorizzazione concessa a un utente specifico.
`getAccess(user)`	`Permission`	Recupera l'autorizzazione concessa a un utente specifico.
`getDateCreated()`	`Date`	Recupera la data di creazione del `Folder`.
`getDescription()`	`String`	Recupera la descrizione di `Folder`.
`getEditors()`	`User[]`	Recupera l'elenco degli editor di questo `Folder`.
`getFiles()`	`FileIterator`	Recupera una raccolta di tutti i file che sono elementi secondari della cartella corrente.
`getFilesByName(name)`	`FileIterator`	Recupera una raccolta di tutti i file secondari della cartella corrente che hanno il nome specificato.
`getFilesByType(mimeType)`	`FileIterator`	Recupera una raccolta di tutti i file secondari della cartella corrente e con il tipo MIME specificato.
`getFolders()`	`FolderIterator`	Recupera una raccolta di tutte le cartelle secondarie della cartella corrente.
`getFoldersByName(name)`	`FolderIterator`	Recupera una raccolta di tutte le cartelle secondarie della cartella corrente che hanno il nome specificato.
`getId()`	`String`	Recupera l'ID del `Folder`.
`getLastUpdated()`	`Date`	Recupera la data dell'ultimo aggiornamento di `Folder`.
`getName()`	`String`	Recupera il nome del `Folder`.
`getOwner()`	`User`	Restituisce il proprietario di questo `Folder`.
`getParents()`	`FolderIterator`	Recupera una raccolta di cartelle che sono le cartelle principali immediate di `Folder`.
`getResourceKey()`	`String`	Recupera la chiave della risorsa del `Folder` necessaria per accedere agli elementi che sono stati condivisi utilizzando un link.
`getSecurityUpdateEligible()`	`Boolean`	Indica se questo `Folder` è idoneo per l'applicazione dell'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa quando viene condiviso tramite un link.
`getSecurityUpdateEnabled()`	`Boolean`	Indica se questo `Folder` richiede una chiave della risorsa per l'accesso quando viene condiviso utilizzando un link.
`getSharingAccess()`	`Access`	Restituisce la classe di utenti che può accedere al `Folder`, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
`getSharingPermission()`	`Permission`	Recupera l'autorizzazione concessa agli utenti che possono accedere a `Folder`, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
`getSize()`	`Integer`	Recupera il numero di byte utilizzati per archiviare il file `Folder` su Drive.
`getUrl()`	`String`	Recupera l'URL che può essere utilizzato per aprire il `Folder` in un'app Google come Drive o Documenti.
`getViewers()`	`User[]`	Recupera l'elenco di visualizzatori e commentatori per questo `Folder`.
`isShareableByEditors()`	`Boolean`	Determina se gli utenti con autorizzazioni di modifica per il `Folder` possono condividerlo con altri utenti o modificarne le autorizzazioni.
`isStarred()`	`Boolean`	Determina se `Folder` è stato aggiunto ai preferiti su Drive dell'utente.
`isTrashed()`	`Boolean`	Determina se `Folder` si trova nel cestino di Drive dell'utente.
`moveTo(destination)`	`Folder`	Sposta questo elemento nella cartella di destinazione specificata.
`removeEditor(emailAddress)`	`Folder`	Rimuove l'utente specificato dall'elenco degli editor di `Folder`.
`removeEditor(user)`	`Folder`	Rimuove l'utente specificato dall'elenco degli editor di `Folder`.
`removeViewer(emailAddress)`	`Folder`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il `Folder`.
`removeViewer(user)`	`Folder`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il `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`	Recupera una raccolta di tutti i file che sono figli della cartella corrente e corrispondono ai criteri di ricerca specificati.
`searchFolders(params)`	`FolderIterator`	Recupera una raccolta di tutte le cartelle secondarie della cartella corrente che corrispondono ai criteri di ricerca specificati.
`setDescription(description)`	`Folder`	Imposta la descrizione per `Folder`.
`setName(name)`	`Folder`	Imposta il nome del `Folder`.
`setOwner(emailAddress)`	`Folder`	Modifica il proprietario del `Folder`.
`setOwner(user)`	`Folder`	Modifica il proprietario del `Folder`.
`setSecurityUpdateEnabled(enabled)`	`Folder`	Imposta se `Folder` richiede una chiave della risorsa per l'accesso quando viene condivisa utilizzando un link.
`setShareableByEditors(shareable)`	`Folder`	Imposta se gli utenti con autorizzazioni di modifica per il `Folder` possono condividerlo con altri utenti o modificarne le autorizzazioni.
`setSharing(accessType, permissionType)`	`Folder`	Imposta la classe di utenti che può accedere a `Folder` e le autorizzazioni concesse a questi utenti, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
`setStarred(starred)`	`Folder`	Imposta se `Folder` è contrassegnato come preferito in Drive dell'utente.
`setTrashed(trashed)`	`Folder`	Imposta se `Folder` si trova nel cestino di Drive dell'utente.

`FolderIterator`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getContinuationToken()`	`String`	Restituisce un token che può essere utilizzato per riprendere questa iterazione in un secondo momento.
`hasNext()`	`Boolean`	Determina se la chiamata a `next()` restituirà un elemento.
`next()`	`Folder`	Recupera 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 modificarli.
`COMMENT`	`Enum`	Gli utenti che possono accedere al file o alla cartella possono solo visualizzarli, copiarli o commentarli.
`OWNER`	`Enum`	L'utente è il proprietario del file o della cartella.
`ORGANIZER`	`Enum`	Utenti che possono organizzare file e cartelle all'interno di un Drive condiviso.
`FILE_ORGANIZER`	`Enum`	Utenti che possono modificare, eliminare e spostare contenuti all'interno di un Drive condiviso.
`NONE`	`Enum`	L'utente non dispone di autorizzazioni per il file o la cartella.

`User`

Metodi

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