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.

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

Attivare l'API Drive

Il seguente esempio di codice mostra come registrare i nomi di ogni file nel file Cartella Il mio Drive:

// 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 puoi disattivare l'SDK Drive per il loro dominio, impedendo agli utenti di installare e utilizzare App Drive. Questa impostazione impedisce inoltre agli utenti di utilizzare Script Apps Script, applicazioni web e componenti aggiuntivi che utilizzano Drive servizio Google Cloud o servizio Drive avanzato anche se il componente aggiuntivo o l'app web sono stati installati prima che l'amministratore avesse disattivato 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 oppure qualsiasi script che il suo client OAuth è incluso nella lista consentita. dall'amministratore di 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 qualsiasi agli utenti a cui è stato concesso esplicitamente 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 l'iterazione degli script su una raccolta potenzialmente grande di file.
`Folder`	Una cartella su Google Drive.
`FolderIterator`	Un oggetto che consente l'iterazione degli script su 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 ogni singolo utente 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`	Può accedere chiunque abbia il link.
`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 a qualsiasi agli utenti 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 ogni singolo utente a cui è stato esplicitamente concesso l'accesso.

Metodi

Metodo	Tipo restituito	Breve descrizione
`continueFileIterator(continuationToken)`	`FileIterator`	Riprende un'iterazione di 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 radice 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 directory principale del 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 della risorsa forniti e la restituisce.
`enforceSingleParent(value)`	`void`	Attiva o disattiva il comportamento forzato singolo per tutte le chiamate che interessano elementi padre.
`getFileById(id)`	`File`	Recupera il file con l'ID specificato.
`getFileByIdAndResourceKey(id, resourceKey)`	`File`	Recupera il file con l'ID e la chiave della 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 con lo stesso nome presenti nel Drive dell'utente.
`getFilesByType(mimeType)`	`FileIterator`	Recupera una raccolta di tutti i file con il tipo MIME specificato nel Drive dell'utente.
`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`	Ottiene una raccolta di tutte le cartelle nel Drive dell'utente.
`getFoldersByName(name)`	`FolderIterator`	Recupera una raccolta di tutte le cartelle che hanno il nome specificato nel Drive dell'utente.
`getRootFolder()`	`Folder`	Recupera la cartella nella directory principale del Drive dell'utente.
`getStorageLimit()`	`Integer`	Recupera il numero di byte che l'utente può archiviare su 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 del Drive dell'utente.
`searchFiles(params)`	`FileIterator`	Recupera una raccolta di tutti i file nel Drive dell'utente che corrispondono alla ricerca specificata criteri.
`searchFolders(params)`	`FolderIterator`	Restituisce una raccolta di tutte le cartelle nel Drive dell'utente che corrispondono alla ricerca specificata criteri.

`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 di utenti specificato all'elenco dei commentatori per `File`.
`addEditor(emailAddress)`	`File`	Aggiunge l'utente specificato all'elenco di editor per `File`.
`addEditor(user)`	`File`	Aggiunge l'utente specificato all'elenco di editor per `File`.
`addEditors(emailAddresses)`	`File`	Aggiunge l'array di utenti specificato all'elenco di editor per `File`.
`addViewer(emailAddress)`	`File`	Aggiunge l'utente specificato all'elenco di visualizzatori per `File`.
`addViewer(user)`	`File`	Aggiunge l'utente specificato all'elenco di visualizzatori per `File`.
`addViewers(emailAddresses)`	`File`	Aggiunge l'array specificato di utenti all'elenco di 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 come blob convertito nel tipo di contenuto specificato.
`getBlob()`	`Blob`	Restituisce i dati all'interno dell'oggetto sotto forma di blob.
`getDateCreated()`	`Date`	Recupera la data di creazione di `File`.
`getDescription()`	`String`	Recupera la descrizione del `File`.
`getDownloadUrl()`	`String`	Recupera l'URL che può essere utilizzato per scaricare il file.
`getEditors()`	`User[]`	Ottiene l'elenco degli editor per questo `File`.
`getId()`	`String`	Recupera l'ID di `File`.
`getLastUpdated()`	`Date`	Ottiene la data dell'ultimo aggiornamento di `File`.
`getMimeType()`	`String`	Recupera il tipo MIME del file.
`getName()`	`String`	Ottiene il nome del `File`.
`getOwner()`	`User`	Recupera il proprietario del file.
`getParents()`	`FolderIterator`	Recupera una raccolta di cartelle padre immediate di `File`.
`getResourceKey()`	`String`	Recupera la chiave risorsa di `File` necessaria per accedere agli elementi che sono stati condivisi tramite link.
`getSecurityUpdateEligible()`	`Boolean`	Riconosce se il `File` è idoneo per 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 risorsa per l'accesso quando condiviso tramite link.
`getSharingAccess()`	`Access`	Trova la classe di utenti che può accedere all'`File`, oltre a qualsiasi individuo agli utenti a cui è stato concesso esplicitamente l'accesso.
`getSharingPermission()`	`Permission`	Consente di concedere l'autorizzazione agli utenti che possono accedere a `File`, accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
`getSize()`	`Integer`	Recupera il numero di byte utilizzati per archiviare `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 risorsa dell'elemento a cui rimanda.
`getThumbnail()`	`Blob`	Recupera 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[]`	Consente di acquisire l'elenco di visualizzatori e commentatori di `File`.
`isShareableByEditors()`	`Boolean`	Consente di stabilire 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 a Speciali nel Drive dell'utente.
`isTrashed()`	`Boolean`	Determina se l'elemento `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 gli assegna il nome fornito.
`makeCopy(name, destination)`	`File`	Crea una copia del file nella directory di destinazione e le assegna il nome fornito.
`moveTo(destination)`	`File`	Sposta questo elemento nella cartella di destinazione fornita.
`removeCommenter(emailAddress)`	`File`	Rimuove l'utente specificato dall'elenco degli autori di commenti per `File`.
`removeCommenter(user)`	`File`	Rimuove l'utente specificato dall'elenco degli autori di commenti 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 per `File`.
`removeViewer(user)`	`File`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per `File`.
`revokePermissions(emailAddress)`	`File`	Revoca l'accesso al `File` concesso all'utente specificato.
`revokePermissions(user)`	`File`	Revoca l'accesso al `File` concesso all'utente specificato.
`setContent(content)`	`File`	Sovrascrive i contenuti del file con una determinata sostituzione.
`setDescription(description)`	`File`	Consente di impostare la descrizione per `File`.
`setName(name)`	`File`	Consente di impostare il nome dell'elemento `File`.
`setOwner(emailAddress)`	`File`	Modifica il proprietario di `File`.
`setOwner(user)`	`File`	Modifica il proprietario di `File`.
`setSecurityUpdateEnabled(enabled)`	`File`	Consente di impostare se `File` richiede una chiave risorsa per l'accesso quando condiviso tramite 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 all'`File` e le autorizzazioni a questi utenti, oltre a quelli individuali a cui è stato esplicitamente concesso l'accesso.
`setStarred(starred)`	`File`	Consente di impostare se `File` viene aggiunto a Speciali nel Drive dell'utente.
`setTrashed(trashed)`	`File`	Consente di impostare se l'elemento `File` si trova nel cestino del Drive dell'utente.

`FileIterator`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getContinuationToken()`	`String`	Ottiene 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 di editor per `Folder`.
`addEditor(user)`	`Folder`	Aggiunge l'utente specificato all'elenco di editor per `Folder`.
`addEditors(emailAddresses)`	`Folder`	Aggiunge l'array di utenti specificato all'elenco di editor per `Folder`.
`addViewer(emailAddress)`	`Folder`	Aggiunge l'utente specificato all'elenco di visualizzatori per `Folder`.
`addViewer(user)`	`Folder`	Aggiunge l'utente specificato all'elenco di visualizzatori per `Folder`.
`addViewers(emailAddresses)`	`Folder`	Aggiunge l'array specificato di utenti all'elenco di 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 della 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 del `Folder`.
`getEditors()`	`User[]`	Ottiene l'elenco degli editor per questo `Folder`.
`getFiles()`	`FileIterator`	Recupera una raccolta di tutti i file secondari della cartella corrente.
`getFilesByName(name)`	`FileIterator`	Restituisce una raccolta di tutti i file secondari della cartella corrente e con 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`	Restituisce una raccolta di tutte le cartelle secondarie della cartella corrente e con il nome specificato.
`getId()`	`String`	Recupera l'ID di `Folder`.
`getLastUpdated()`	`Date`	Ottiene la data dell'ultimo aggiornamento di `Folder`.
`getName()`	`String`	Ottiene il nome del `Folder`.
`getOwner()`	`User`	Recupera il proprietario di questo `Folder`.
`getParents()`	`FolderIterator`	Recupera una raccolta di cartelle padre immediate di `Folder`.
`getResourceKey()`	`String`	Recupera la chiave risorsa di `Folder` necessaria per accedere agli elementi che sono stati condivisi tramite link.
`getSecurityUpdateEligible()`	`Boolean`	Riconosce se il `Folder` è idoneo per 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 risorsa per l'accesso quando condiviso tramite link.
`getSharingAccess()`	`Access`	Trova la classe di utenti che può accedere all'`Folder`, oltre a qualsiasi individuo agli utenti a cui è stato concesso esplicitamente l'accesso.
`getSharingPermission()`	`Permission`	Consente di concedere l'autorizzazione agli utenti che possono accedere a `Folder`, accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
`getSize()`	`Integer`	Recupera il numero di byte utilizzati per archiviare `Folder` su Drive.
`getUrl()`	`String`	Recupera l'URL che può essere utilizzato per aprire `Folder` in un'app Google come Drive o Documenti.
`getViewers()`	`User[]`	Consente di acquisire l'elenco di visualizzatori e commentatori di `Folder`.
`isShareableByEditors()`	`Boolean`	Consente di stabilire 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 a Speciali nel Drive dell'utente.
`isTrashed()`	`Boolean`	Determina se l'elemento `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 di visualizzatori e commentatori per `Folder`.
`removeViewer(user)`	`Folder`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Revoca l'accesso al `Folder` concesso all'utente specificato.
`revokePermissions(user)`	`Folder`	Revoca l'accesso al `Folder` concesso all'utente specificato.
`searchFiles(params)`	`FileIterator`	Restituisce una raccolta di tutti i file secondari della cartella corrente e corrispondenti alla ricerca specificata criteri.
`searchFolders(params)`	`FolderIterator`	Restituisce una raccolta di tutte le cartelle secondarie della cartella corrente e corrispondenti alla ricerca specificata criteri.
`setDescription(description)`	`Folder`	Consente di impostare la descrizione per `Folder`.
`setName(name)`	`Folder`	Consente di impostare il nome dell'elemento `Folder`.
`setOwner(emailAddress)`	`Folder`	Modifica il proprietario di `Folder`.
`setOwner(user)`	`Folder`	Modifica il proprietario di `Folder`.
`setSecurityUpdateEnabled(enabled)`	`Folder`	Consente di impostare se `Folder` richiede una chiave risorsa per l'accesso quando condiviso tramite 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 all'`Folder` e le autorizzazioni a questi utenti, oltre a quelli individuali a cui è stato esplicitamente concesso l'accesso.
`setStarred(starred)`	`Folder`	Consente di impostare se `Folder` viene aggiunto a Speciali nel Drive dell'utente.
`setTrashed(trashed)`	`Folder`	Consente di impostare se l'elemento `Folder` si trova nel cestino del Drive dell'utente.

`FolderIterator`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getContinuationToken()`	`String`	Ottiene 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 modificarlo.
`COMMENT`	`Enum`	Gli utenti che possono accedere al file o alla cartella possono solo visualizzarli, copiarli o commentarli.
`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 i 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`	Ottiene il nome di dominio associato all'account dell'utente.
`getEmail()`	`String`	Recupera l'indirizzo email dell'utente.
`getName()`	`String`	Ottiene il nome dell'utente.
`getPhotoUrl()`	`String`	Recupera l'URL della foto dell'utente.