Questa pagina è stata tradotta dall'API Cloud Translation.

Drive Service

Questo servizio consente agli script di creare, trovare e modificare file e cartelle in Google Drive. Sebbene il servizio Drive integrato sia più facile da usare, presenta alcune limitazioni. Per usufruire delle funzionalità e dell'assistenza più aggiornate e per accedere a file o cartelle nei Drive condivisi, utilizza il servizio Drive avanzato.

Se lo script utilizza un progetto Cloud standard anziché un progetto Cloud predefinito, 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 Google Drive. Questa impostazione impedisce inoltre agli utenti di utilizzare script Apps Script, app web e componenti aggiuntivi che utilizzano il servizio Drive o il servizio avanzato Drive (anche se il componente aggiuntivo o l'app web è stato installato prima che l'amministratore disattivasse l'SDK Drive).

Tuttavia, se un componente aggiuntivo che utilizza il servizio Drive viene pubblicato per l'installazione a livello di dominio e viene installato dall'amministratore per alcuni o tutti gli utenti del dominio o qualsiasi script che ha il client OAuth autorizzato dall'amministratore del dominio, il componente aggiuntivo funziona per questi 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 a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso.
`DriveApp`	Consente agli script di creare, trovare e modificare file e cartelle in Google Drive.
`File`	Un file su Google Drive.
`FileIterator`	Un iteratore che consente agli script di scorrere una raccolta di file potenzialmente di grandi dimensioni.
`Folder`	Una cartella in Google Drive.
`FolderIterator`	Un oggetto che consente agli script di scorrere una raccolta potenzialmente grande di cartelle.
`Permission`	Un'enumerazione che rappresenta le autorizzazioni concesse agli utenti che possono accedere a un file o a una cartella, oltre a qualsiasi utente individuale a cui è stato concesso esplicitamente l'accesso.
`User`	Un utente associato a un file su Google Drive.

`Access`

Proprietà

Proprietà	Tipo	Descrizione
`ANYONE`	`Enum`	Chiunque navighi su internet può trovare e accedere.
`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'enumerazione che rappresenta le classi di utenti che possono accedere a un file o a una cartella, oltre a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso.
`Permission`	`Permission`	Un'enumerazione che rappresenta le autorizzazioni concesse agli utenti che possono accedere a un file o a una cartella, oltre a qualsiasi utente individuale a cui è stato concesso esplicitamente 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 radice di Drive dell'utente da un determinato `Blob` di dati arbitrari.
`createFile(name, content)`	`File`	Crea un file di testo nella radice di Drive dell'utente con il nome e i contenuti specificati.
`createFile(name, content, mimeType)`	`File`	Crea un file nella radice del 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 Drive e alla chiave risorsa forniti e la restituisce.
`enforceSingleParent(value)`	`void`	Attiva o disattiva il comportamento enforceSingleParent per tutte le chiamate che interessano i genitori degli articoli.
`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 nel Drive dell'utente.
`getFilesByName(name)`	`FileIterator`	Recupera una raccolta di tutti i file nel Drive dell'utente con il nome specificato.
`getFilesByType(mimeType)`	`FileIterator`	Recupera una raccolta di tutti i file nel Drive dell'utente con 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 di 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 con il nome specificato.
`getRootFolder()`	`Folder`	Visualizza la cartella nella directory principale del Drive dell'utente.
`getStorageLimit()`	`Integer`	Restituisce il numero di byte che l'utente può archiviare in Drive.
`getStorageUsed()`	`Integer`	Restituisce il numero di byte attualmente archiviati dall'utente su Drive.
`getTrashedFiles()`	`FileIterator`	Recupera una raccolta di tutti i file nel cestino del Drive dell'utente.
`getTrashedFolders()`	`FolderIterator`	Recupera una raccolta di tutte le cartelle nel cestino di Drive dell'utente.
`searchFiles(params)`	`FileIterator`	Recupera una raccolta di tutti i file nel Drive dell'utente che corrispondono ai criteri di ricerca specificati.
`searchFolders(params)`	`FolderIterator`	Recupera 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 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 per `File`.
`addEditor(user)`	`File`	Aggiunge l'utente specificato all'elenco degli editor per `File`.
`addEditors(emailAddresses)`	`File`	Aggiunge l'array di utenti specificato all'elenco degli editor del `File`.
`addViewer(emailAddress)`	`File`	Aggiunge l'utente specificato all'elenco degli spettatori di `File`.
`addViewer(user)`	`File`	Aggiunge l'utente specificato all'elenco degli spettatori di `File`.
`addViewers(emailAddresses)`	`File`	Aggiunge l'array di utenti specificato all'elenco dei visualizzatori di `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 di `File`.
`getDescription()`	`String`	Recupera la descrizione di `File`.
`getDownloadUrl()`	`String`	Restituisce l'URL che può essere utilizzato per scaricare il file.
`getEditors()`	`User[]`	Recupera l'elenco degli editor per questo `File`.
`getId()`	`String`	Recupera l'ID di `File`.
`getLastUpdated()`	`Date`	Recupera la data dell'ultimo aggiornamento di `File`.
`getMimeType()`	`String`	Recupera il tipo MIME del file.
`getName()`	`String`	Recupera il nome di `File`.
`getOwner()`	`User`	Recupera il proprietario del file.
`getParents()`	`FolderIterator`	Recupera una raccolta di cartelle che sono i genitori immediati di `File`.
`getResourceKey()`	`String`	Recupera la chiave della risorsa del `File` necessaria per accedere agli elementi che sono stati condivisi tramite un link.
`getSecurityUpdateEligible()`	`Boolean`	Indica se questo `File` è idoneo per applicare l'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa per l'accesso quando viene condiviso tramite un link.
`getSecurityUpdateEnabled()`	`Boolean`	Indica se questo `File` richiede una chiave risorsa per l'accesso quando viene condiviso tramite un link.
`getSharingAccess()`	`Access`	Recupera la classe di utenti che possono accedere a `File`, oltre a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso.
`getSharingPermission()`	`Permission`	Recupera l'autorizzazione concessa agli utenti che possono accedere a `File`, oltre a tutti gli utenti individuali 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 punta.
`getTargetMimeType()`	`String`	Se si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui punta.
`getTargetResourceKey()`	`String`	Se il file è una scorciatoia, restituisce la chiave della risorsa dell'elemento a cui punta.
`getThumbnail()`	`Blob\|null`	Recupera un'immagine miniatura per il file o `null` se non esiste alcuna miniatura.
`getUrl()`	`String`	Recupera l'URL che può essere utilizzato per aprire `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 `File` possono condividere con altri utenti o modificare le autorizzazioni.
`isStarred()`	`Boolean`	Determina se `File` è stato aggiunto ai preferiti nell'unità 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 denomina con il 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 l'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 di visualizzatori e commentatori del `File`.
`removeViewer(user)`	`File`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del `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 i contenuti del file con una sostituzione specificata.
`setDescription(description)`	`File`	Imposta la descrizione per `File`.
`setName(name)`	`File`	Imposta il nome di `File`.
`setOwner(emailAddress)`	`File`	Modifica il proprietario di `File`.
`setOwner(user)`	`File`	Modifica il proprietario di `File`.
`setSecurityUpdateEnabled(enabled)`	`File`	Imposta se `File` richiede una chiave risorsa per l'accesso quando viene condiviso tramite un link.
`setShareableByEditors(shareable)`	`File`	Determina se gli utenti con autorizzazioni di modifica per `File` possono condividere con altri utenti o modificare le autorizzazioni.
`setSharing(accessType, permissionType)`	`File`	Definisce la classe di utenti che può accedere a `File` e le autorizzazioni concesse a questi utenti, oltre a eventuali singoli utenti a cui è stato concesso esplicitamente l'accesso.
`setStarred(starred)`	`File`	Determina se `File` è aggiunto ai preferiti nel Drive dell'utente.
`setTrashed(trashed)`	`File`	Indica se `File` si trova nel cestino di 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 di `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 per `Folder`.
`addEditor(user)`	`Folder`	Aggiunge l'utente specificato all'elenco degli editor per `Folder`.
`addEditors(emailAddresses)`	`Folder`	Aggiunge l'array di utenti specificato all'elenco degli editor del `Folder`.
`addViewer(emailAddress)`	`Folder`	Aggiunge l'utente specificato all'elenco degli spettatori di `Folder`.
`addViewer(user)`	`Folder`	Aggiunge l'utente specificato all'elenco degli spettatori di `Folder`.
`addViewers(emailAddresses)`	`Folder`	Aggiunge l'array di utenti specificato all'elenco dei visualizzatori di `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 il contenuto 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 attuale 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 Drive e alla chiave risorsa 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 di `Folder`.
`getDescription()`	`String`	Recupera la descrizione di `Folder`.
`getEditors()`	`User[]`	Recupera l'elenco degli editor per questo `Folder`.
`getFiles()`	`FileIterator`	Recupera una raccolta di tutti i file secondari della cartella corrente.
`getFilesByName(name)`	`FileIterator`	Recupera una raccolta di tutti i file secondari della cartella corrente con il nome specificato.
`getFilesByType(mimeType)`	`FileIterator`	Recupera una raccolta di tutti i file secondari della cartella corrente 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 con il nome specificato.
`getId()`	`String`	Recupera l'ID di `Folder`.
`getLastUpdated()`	`Date`	Recupera la data dell'ultimo aggiornamento di `Folder`.
`getName()`	`String`	Recupera il nome di `Folder`.
`getOwner()`	`User`	Restituisce il proprietario di questo `Folder`.
`getParents()`	`FolderIterator`	Recupera una raccolta di cartelle che sono i genitori immediati di `Folder`.
`getResourceKey()`	`String`	Recupera la chiave della risorsa del `Folder` necessaria per accedere agli elementi che sono stati condivisi tramite un link.
`getSecurityUpdateEligible()`	`Boolean`	Indica se questo `Folder` è idoneo per applicare l'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa per l'accesso quando viene condiviso tramite un link.
`getSecurityUpdateEnabled()`	`Boolean`	Indica se questo `Folder` richiede una chiave risorsa per l'accesso quando viene condiviso tramite un link.
`getSharingAccess()`	`Access`	Recupera la classe di utenti che possono accedere a `Folder`, oltre a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso.
`getSharingPermission()`	`Permission`	Recupera l'autorizzazione concessa agli utenti che possono accedere a `Folder`, oltre a tutti gli utenti individuali 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[]`	Recupera l'elenco di visualizzatori e commentatori per questo `Folder`.
`isShareableByEditors()`	`Boolean`	Determina se gli utenti con autorizzazioni di modifica per `Folder` possono condividere con altri utenti o modificare le autorizzazioni.
`isStarred()`	`Boolean`	Determina se `Folder` è stato aggiunto ai preferiti nell'unità Drive dell'utente.
`isTrashed()`	`Boolean`	Determina se `Folder` si trova nel cestino di Drive dell'utente.
`moveTo(destination)`	`Folder`	Sposta l'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 di visualizzatori e commentatori del `Folder`.
`removeViewer(user)`	`Folder`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del `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 di `Folder`.
`setOwner(emailAddress)`	`Folder`	Modifica il proprietario di `Folder`.
`setOwner(user)`	`Folder`	Modifica il proprietario di `Folder`.
`setSecurityUpdateEnabled(enabled)`	`Folder`	Imposta se `Folder` richiede una chiave risorsa per l'accesso quando viene condiviso tramite un link.
`setShareableByEditors(shareable)`	`Folder`	Determina se gli utenti con autorizzazioni di modifica per `Folder` possono condividere con altri utenti o modificare le autorizzazioni.
`setSharing(accessType, permissionType)`	`Folder`	Definisce la classe di utenti che può accedere a `Folder` e le autorizzazioni concesse a questi utenti, oltre a eventuali singoli utenti a cui è stato concesso esplicitamente l'accesso.
`setStarred(starred)`	`Folder`	Determina se `Folder` è aggiunto ai preferiti nel Drive dell'utente.
`setTrashed(trashed)`	`Folder`	Indica se `Folder` si trova nel cestino di 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 di `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 visualizzarli o copiarli.
`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 è 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\|null`	Recupera il nome di dominio associato all'account dell'utente.
`getEmail()`	`String\|null`	Visualizza l'indirizzo email dell'utente.
`getName()`	`String\|null`	Recupera il nome dell'utente.
`getPhotoUrl()`	`String\|null`	Visualizza l'URL della foto dell'utente.

Drive Service Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Corsi

Proprietà

Proprietà

Metodi

Metodi

Metodi

Metodi

Metodi

Proprietà

Metodi

Drive Service