このページは Cloud Translation API によって翻訳されました。

Class File

Google ドライブ内のファイル。ファイルには DriveApp からアクセスまたは作成できます。

// Trash every untitled spreadsheet that hasn't been updated in a week.
const files = DriveApp.getFilesByName('Untitled spreadsheet');
while (files.hasNext()) {
  const file = files.next();
  if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) {
    file.setTrashed(true);
  }
}

メソッド

メソッド	戻り値の型	概要
`addCommenter(emailAddress)`	`File`	指定したユーザーを `File` のコメント投稿者のリストに追加します。
`addCommenter(user)`	`File`	指定したユーザーを `File` のコメント投稿者のリストに追加します。
`addCommenters(emailAddresses)`	`File`	指定されたユーザーの配列を `File` のコメント投稿者のリストに追加します。
`addEditor(emailAddress)`	`File`	指定されたユーザーを `File` の編集者のリストに追加します。
`addEditor(user)`	`File`	指定されたユーザーを `File` の編集者のリストに追加します。
`addEditors(emailAddresses)`	`File`	指定されたユーザーの配列を `File` の編集者のリストに追加します。
`addViewer(emailAddress)`	`File`	指定したユーザーを `File` の視聴者のリストに追加します。
`addViewer(user)`	`File`	指定したユーザーを `File` の視聴者のリストに追加します。
`addViewers(emailAddresses)`	`File`	指定されたユーザーの配列を `File` の視聴者のリストに追加します。
`getAccess(email)`	`Permission`	特定のユーザーに付与されている権限を取得します。
`getAccess(user)`	`Permission`	特定のユーザーに付与されている権限を取得します。
`getAs(contentType)`	`Blob`	このオブジェクト内のデータを指定したコンテンツタイプに変換された BLOB として返します。
`getBlob()`	`Blob`	このオブジェクト内のデータを blob として返します。
`getDateCreated()`	`Date`	`File` が作成された日付を取得します。
`getDescription()`	`String`	`File` の説明を取得します。
`getDownloadUrl()`	`String`	ファイルをダウンロードするために使用できる URL を取得します。
`getEditors()`	`User[]`	この `File` の編集者のリストを取得します。
`getId()`	`String`	`File` の ID を取得します。
`getLastUpdated()`	`Date`	`File` が最後に更新された日付を取得します。
`getMimeType()`	`String`	ファイルの MIME タイプを取得します。
`getName()`	`String`	`File` の名前を取得します。
`getOwner()`	`User`	ファイルのオーナーを取得します。
`getParents()`	`FolderIterator`	`File` の直接の親であるフォルダのコレクションを取得します。
`getResourceKey()`	`String`	リンクを使用して共有されたアイテムにアクセスするために必要な `File` のリソースキーを取得します。
`getSecurityUpdateEligible()`	`Boolean`	この `File` が、リンクを使用して共有する際にアクセスにリソースキーを必要とするセキュリティアップデートを適用できるかどうかを取得します。
`getSecurityUpdateEnabled()`	`Boolean`	この `File` をリンクを使用して共有するときに、アクセスにリソースキーが必要かどうかを取得します。
`getSharingAccess()`	`Access`	明示的にアクセス権が付与されている個々のユーザーのほかに、`File` にアクセスできるユーザークラスを取得します。
`getSharingPermission()`	`Permission`	`File` にアクセスできるユーザーに付与されている権限を取得します。明示的にアクセス権が付与されている個々のユーザーは除きます。
`getSize()`	`Integer`	ドライブに `File` を保存するために使用されるバイト数を取得します。
`getTargetId()`	`String`	ショートカットの場合は、ショートカットが参照するアイテムの ID を返します。
`getTargetMimeType()`	`String`	ショートカットの場合は、ショートカットが参照するアイテムの MIME タイプを返します。
`getTargetResourceKey()`	`String`	ファイルがショートカットの場合は、そのファイルが参照するアイテムのリソースキーを返します。
`getThumbnail()`	`Blob`	ファイルのサムネイル画像を取得します。サムネイルが存在しない場合は `null` を取得します。
`getUrl()`	`String`	Google ドライブや Google ドキュメントなどの Google アプリで `File` を開く際に使用できる URL を取得します。
`getViewers()`	`User[]`	この `File` の閲覧者とコメント投稿者のリストを取得します。
`isShareableByEditors()`	`Boolean`	`File` の編集権限を持つユーザーが、他のユーザーと共有したり、権限を変更したりできるかどうかを決定します。
`isStarred()`	`Boolean`	`File` がユーザーのドライブでスターを付けられているかどうかを判断します。
`isTrashed()`	`Boolean`	`File` がユーザーのドライブのゴミ箱にあるかどうかを判断します。
`makeCopy()`	`File`	ファイルのコピーを作成します。
`makeCopy(destination)`	`File`	ファイルのコピーを宛先ディレクトリに作成します。
`makeCopy(name)`	`File`	ファイルのコピーを作成し、指定された名前を付けます。
`makeCopy(name, destination)`	`File`	ファイルのコピーを宛先ディレクトリに作成し、指定された名前を付けます。
`moveTo(destination)`	`File`	このアイテムを指定された移動先のフォルダに移動します。
`removeCommenter(emailAddress)`	`File`	指定したユーザーを `File` のコメント投稿者のリストから削除します。
`removeCommenter(user)`	`File`	指定したユーザーを `File` のコメント投稿者のリストから削除します。
`removeEditor(emailAddress)`	`File`	指定されたユーザーを `File` の編集者のリストから削除します。
`removeEditor(user)`	`File`	指定されたユーザーを `File` の編集者のリストから削除します。
`removeViewer(emailAddress)`	`File`	指定したユーザーを `File` の閲覧者とコメント投稿者のリストから削除します。
`removeViewer(user)`	`File`	指定したユーザーを `File` の閲覧者とコメント投稿者のリストから削除します。
`revokePermissions(emailAddress)`	`File`	指定されたユーザーに付与された `File` へのアクセス権を取り消します。
`revokePermissions(user)`	`File`	指定されたユーザーに付与された `File` へのアクセス権を取り消します。
`setContent(content)`	`File`	指定された置換文字列でファイルの内容を上書きします。
`setDescription(description)`	`File`	`File` の説明を設定します。
`setName(name)`	`File`	`File` の名前を設定します。
`setOwner(emailAddress)`	`File`	`File` のオーナーを変更します。
`setOwner(user)`	`File`	`File` のオーナーを変更します。
`setSecurityUpdateEnabled(enabled)`	`File`	`File` がリンクを使用して共有されるときに、アクセスにリソースキーが必要かどうかを設定します。
`setShareableByEditors(shareable)`	`File`	`File` の編集権限を持つユーザーが他のユーザーと共有したり、権限を変更したりできるかどうかを設定します。
`setSharing(accessType, permissionType)`	`File`	`File` にアクセスできるユーザークラスと、そのユーザーに付与される権限を設定します。明示的にアクセス権が付与されている個々のユーザーは除きます。
`setStarred(starred)`	`File`	`File` がユーザーのドライブでスターを付けられるかどうかを設定します。
`setTrashed(trashed)`	`File`	`File` がユーザーのドライブのゴミ箱にあるかどうかを設定します。

詳細なドキュメント

`addCommenter(emailAddress)`

指定したユーザーを File のコメント投稿者のリストに追加します。ユーザーがすでに視聴者のリストに登録されている場合、このメソッドはユーザーを視聴者のリストから除外します。

const files = DriveApp.getFilesByName('Test');

// Loops through the files
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter('hello@example.com');
}

パラメータ

名前	型	説明
`emailAddress`	`String`	追加するユーザーのメールアドレス。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`addCommenter(user)`

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Adds the active user as a commenter.
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter(Session.getActiveUser());
}

パラメータ

名前	型	説明
`user`	`User`	追加するユーザーを表します。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`addCommenters(emailAddresses)`

指定されたユーザーの配列を File のコメント投稿者のリストに追加します。ユーザーがすでに視聴者のリストに登録されている場合、このメソッドは視聴者のリストからユーザーを昇格させます。

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

while (files.hasNext()) {
  const file = files.next();
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and
  // 'baklavainthebalkans@gmail.com' with the email addresses to add as
  // commenters.
  const emails = [
    'cloudysanfrancisco@gmail.com',
    'baklavainthebalkans@gmail.com',
  ];
  console.log(file.addCommenters(emails));
}

パラメータ

名前	型	説明
`emailAddresses`	`String[]`	追加するユーザーのメールアドレスの配列。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`addEditor(emailAddress)`

指定されたユーザーを File の編集者のリストに追加します。ユーザーがすでに視聴者のリストに登録されている場合、このメソッドはユーザーを視聴者のリストから除外します。

パラメータ

名前	型	説明
`emailAddress`	`String`	追加するユーザーのメールアドレス。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`addEditor(user)`

パラメータ

名前	型	説明
`user`	`User`	追加するユーザーを表します。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`addEditors(emailAddresses)`

指定されたユーザーの配列を File の編集者のリストに追加します。すでに視聴者のリストに登録されているユーザーは、この方法で視聴者のリストから除外されます。

パラメータ

名前	型	説明
`emailAddresses`	`String[]`	追加するユーザーのメールアドレスの配列。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`addViewer(emailAddress)`

指定したユーザーを File の視聴者のリストに追加します。ユーザーがすでに編集者のリストに登録されている場合、このメソッドは効果がありません。

パラメータ

名前	型	説明
`emailAddress`	`String`	追加するユーザーのメールアドレス。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`addViewer(user)`

パラメータ

名前	型	説明
`user`	`User`	追加するユーザーを表します。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`addViewers(emailAddresses)`

指定されたユーザーの配列を File の視聴者のリストに追加します。いずれかのユーザーがすでに編集者のリストに登録されている場合、この方法は適用されません。

パラメータ

名前	型	説明
`emailAddresses`	`String[]`	追加するユーザーのメールアドレスの配列。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`getAccess(email)`

特定のユーザーに付与されている権限を取得します。このメソッドは、Google グループの権限や Google グループから継承された権限を返すことをサポートしていません。

パラメータ

名前	型	説明
`email`	`String`	権限を確認するユーザーのメールアドレス。Google グループはサポートされていません。

戻る

Permission - ユーザーに付与されている権限。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getAccess(user)`

パラメータ

名前	型	説明
`user`	`User`	権限を確認するユーザーを表すオブジェクト。

戻る

Permission - ユーザーに付与されている権限。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getAs(contentType)`

このオブジェクト内のデータを指定したコンテンツタイプに変換された BLOB として返します。この方法では、適切な拡張子がファイル名に追加されます（例: myfile.pdf）。ただし、最後のピリオド（存在する場合）の後のファイル名の部分は、置き換えが必要な既存の拡張子であると想定しています。そのため、「ShoppingList.12.25.2014」は「ShoppingList.12.25.pdf」になります。

コンバージョンの日別割り当てを表示するには、Google サービスの割り当てをご覧ください。新しく作成された Google Workspace ドメインには、一時的に厳しい割り当てが適用される場合があります。

パラメータ

名前	型	説明
`contentType`	`String`	変換する MIME タイプ。ほとんどの blob の場合、`'application/pdf'` が唯一の有効なオプションです。BMP、GIF、JPEG、PNG 形式の画像の場合は、`'image/bmp'`、`'image/gif'`、`'image/jpeg'`、`'image/png'` のいずれも有効です。Google ドキュメントドキュメントの場合は、`'text/markdown'` も有効です。

戻る

Blob - BLOB としてのデータ。

`getBlob()`

このオブジェクト内のデータを blob として返します。

戻る

Blob - BLOB としてのデータ。

`getDateCreated()`

File が作成された日付を取得します。

戻る

Date - File が作成された日付

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getDescription()`

File の説明を取得します。

戻る

String - File の説明

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getDownloadUrl()`

ファイルをダウンロードするために使用できる URL を取得します。URL にアクセスできるのは、Google ドライブでファイルを開く権限を持つユーザーのみです。この URL をブラウザで使用してファイルをダウンロードすることはできますが、UrlFetchApp でファイルを取得することはできません。ファイルの内容をスクリプトに含める場合は、getBlob() を使用します。

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the download URLs to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getDownloadUrl());
}

戻る

String - ファイルをダウンロードするために使用できる URL。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getEditors()`

この File の編集者のリストを取得します。スクリプトを実行するユーザーに File の編集アクセス権がない場合は、このメソッドは空の配列を返します。

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Adds the email addresses in the array as editors of each file.
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com'
  // and 'baklavainthebalkans@gmail.com' with valid email addresses.
  file.addEditors([
    'cloudysanfrancisco@gmail.com',
    'baklavainthebalkans@gmail.com',
  ]);

  // Gets a list of the file editors.
  const editors = file.getEditors();

  // For each file, logs the editors' email addresses to the console.
  for (const editor of editors) {
    console.log(editor.getEmail());
  }
}

戻る

User[] - ユーザーがこの File の編集権限を持っている場合は、編集者のリストを返します。ユーザーに編集権限がない場合、空の配列を返します。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getId()`

File の ID を取得します。

戻る

String - File の ID

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getLastUpdated()`

File が最後に更新された日付を取得します。

戻る

Date - File が最後に更新された日付

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getMimeType()`

ファイルの MIME タイプを取得します。

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the MIME type to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getMimeType());
}

戻る

String - ファイルの MIME タイプ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getName()`

File の名前を取得します。

戻る

String - File の名前

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getOwner()`

ファイルのオーナーを取得します。

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the names of the file owners to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getOwner().getName());
}

戻る

User - ファイルのオーナー。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getParents()`

File の直接の親であるフォルダのコレクションを取得します。

戻る

FolderIterator - File の直接の親であるフォルダのコレクション

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getResourceKey()`

リンクを使用して共有されたアイテムにアクセスするために必要な File のリソースキーを取得します。

戻る

String - File のリソースキー。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSecurityUpdateEligible()`

この File が、リンクを使用して共有する際にアクセスにリソースキーを必要とするセキュリティアップデートを適用できるかどうかを取得します。

リンクを使用して共有された一部のファイルまたはフォルダにアクセスするには、ドライブでリソースキーが必要です。この変更はセキュリティアップデートの一環です。更新は、対象となるファイルとフォルダに対してデフォルトで有効になっています。対象ファイルのリソースキー要件をオンまたはオフにするには、setSecurityUpdateEnabled を使用します。

詳しくは、Google ドライブのセキュリティアップデートをご覧ください。

戻る

Boolean - File にリソースキーの要件を適用できるかどうか。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSecurityUpdateEnabled()`

この File をリンクを使用して共有するときに、アクセスにリソースキーが必要かどうかを取得します。この要件は、対象となるファイルとフォルダに対してデフォルトで有効になっています。対象ファイルのリソースキー要件をオンまたはオフにするには、setSecurityUpdateEnabled を使用します。

詳しくは、Google ドライブのセキュリティアップデートをご覧ください。

戻る

Boolean - この File でリソースキーの要件が有効かどうか。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSharingAccess()`

明示的にアクセス権が付与されている個々のユーザーのほかに、File にアクセスできるユーザークラスを取得します。

戻る

Access - File にアクセスできるユーザーのクラス

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSharingPermission()`

File にアクセスできるユーザーに付与されている権限を取得します。明示的にアクセス権が付与されている個々のユーザーは除きます。

戻る

Permission - File にアクセスできるユーザーに付与される権限

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSize()`

ドライブに File を保存するために使用されるバイト数を取得します。Google Workspace アプリケーションファイルはドライブの保存容量の上限にカウントされないため、0 バイトが返されます。

戻る

Integer - ドライブに File を保存するために使用されるバイト数

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getTargetId()`

ショートカットの場合は、ショートカットが参照するアイテムの ID を返します。

それ以外の場合は null を返します。

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the target ID of the shortcut.
console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);

戻る

String - ターゲットアイテム ID。

`getTargetMimeType()`

これがショートカットの場合は、ショートカットが参照するアイテムの MIME タイプを返します。

それ以外の場合は null を返します。

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the MIME type of the file that the shortcut points to.
console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);

戻る

String - ターゲットアイテムの MIME タイプ。

`getTargetResourceKey()`

ファイルがショートカットの場合は、そのファイルが参照するアイテムのリソースキーを返します。リソースキーは、リンクを使用して共有されたファイルにアクセスするために渡す必要がある追加のパラメータです。

ファイルがショートカットでない場合は、null が返されます。

//  Gets a file by its ID.
//  TODO(developer): Replace 'abc123456' with your file ID.
const file = DriveApp.getFileById('abc123456');

// If the file is a shortcut, returns the resource key of the file that it
// points to.
console.log(file.getTargetResourceKey());

戻る

String - ターゲットアイテムのリソースキー。ファイルがショートカットでない場合は null。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getThumbnail()`

ファイルのサムネイル画像を取得します。サムネイルが存在しない場合は null を取得します。

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Logs the thumbnail image for each file to the console as a blob,
  // or null if no thumbnail exists.
  console.log(file.getThumbnail());
}

戻る

Blob - ファイルのサムネイル画像。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getUrl()`

Google ドライブや Google ドキュメントなどの Google アプリで File を開く際に使用できる URL を取得します。

戻る

String - Google ドライブや Google ドキュメントなどの Google アプリでこの File を表示するために使用できる URL

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getViewers()`

この File の閲覧者とコメント投稿者のリストを取得します。スクリプトを実行するユーザーに File の編集アクセス権がない場合は、このメソッドは空の配列を返します。

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // For each file, logs the viewers' email addresses to the console.
  const viewers = file.getViewers();
  for (const viewer of viewers) {
    console.log(viewer.getEmail());
  }
}

戻る

User[] - ユーザーがこの File の編集権限を持っている場合、閲覧者とコメント投稿者のリストを返します。ユーザーに編集権限がない場合、空の配列を返します。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`isShareableByEditors()`

File の編集権限を持つユーザーが、他のユーザーと共有したり、権限を変更したりできるかどうかを決定します。

戻る

Boolean - 編集権限を持つユーザーが他のユーザーと共有したり、権限を変更したりできる場合は true、できない場合は false

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`isStarred()`

File がユーザーのドライブでスターを付けられているかどうかを判断します。

戻る

Boolean - File がユーザーのドライブでスターを付けられている場合は true、そうでない場合は false

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`isTrashed()`

File がユーザーのドライブのゴミ箱にあるかどうかを判断します。

戻る

Boolean - File がユーザーのドライブのゴミ箱にある場合は true、そうでない場合は false

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`makeCopy()`

ファイルのコピーを作成します。

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and logs the file name to the console.
  console.log(file.makeCopy().getName());
}

戻る

File - 新しいコピー。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`makeCopy(destination)`

宛先ディレクトリにファイルのコピーを作成します。

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and adds it to the specified folder.
  // TODO(developer): Replace the folder ID with your own.
  const destination = DriveApp.getFolderById('123456abcxyz');
  const copiedFile = file.makeCopy(destination);

  // Logs the file names to the console.
  console.log(copiedFile.getName());
}

パラメータ

名前	型	説明
`destination`	`Folder`	ファイルをコピーするディレクトリ。

戻る

File - 新しいコピー。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`makeCopy(name)`

ファイルのコピーを作成し、指定された名前を付けます。

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and sets the name to 'Test-Copy.'
  const filename = file.makeCopy('Test-Copy');

  // Logs the copied file's name to the console.
  console.log(filename.getName());
}

パラメータ

名前	型	説明
`name`	`String`	新しいコピーに適用するファイル名。

戻る

File - 新しいコピー。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`makeCopy(name, destination)`

宛先ディレクトリにファイルのコピーを作成し、指定された名前を付けます。

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file, sets the file name, and adds the copied file
  // to the specified folder.
  // TODO(developer): Replace the folder ID with your own.
  const destination = DriveApp.getFolderById('123456abcxyz');
  const copiedFile = file.makeCopy('Test-Copy', destination);

  // Logs the file names to the console.
  console.log(copiedFile.getName());
}

パラメータ

名前	型	説明
`name`	`String`	新しいコピーに適用するファイル名。
`destination`	`Folder`	ファイルをコピーするディレクトリ。

戻る

File - 新しいコピー。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`moveTo(destination)`

このアイテムを指定された移動先のフォルダに移動します。

アイテムを移動先のフォルダに移動するには、現在のユーザーがファイルの所有者であるか、アイテムの現在の親フォルダに対する編集権限以上を持っている必要があります。

パラメータ

名前	型	説明
`destination`	`Folder`	新しい親となるフォルダ。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`removeCommenter(emailAddress)`

指定したユーザーを File のコメント投稿者のリストから削除します。この方法では、一般的なアクセス権を持つユーザークラスに属しているユーザーが File にアクセスできないようにはなりません。たとえば、File がユーザーのドメイン全体と共有されている場合などです。

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  // TODO(developer): Replace the email with the email of the user you want to
  // remove.
  file.removeCommenter('cloudysanfrancisco@gmail.com');
}

パラメータ

名前	型	説明
`emailAddress`	`String`	削除するユーザーのメールアドレス。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`removeCommenter(user)`

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  console.log(file.removeCommenter(Session.getActiveUser()));
}

パラメータ

名前	型	説明
`user`	`User`	削除するユーザーを表す。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`removeEditor(emailAddress)`

指定されたユーザーを File の編集者のリストから削除します。この方法では、一般アクセス権を持つユーザークラスに属するユーザーが File にアクセスできないようにはなりません。たとえば、File がユーザーのドメイン全体と共有されている場合や、File がユーザーがアクセスできる共有ドライブにある場合などです。

ドライブファイルの場合、この操作により、ユーザーは閲覧者のリストからも削除されます。

パラメータ

名前	型	説明
`emailAddress`	`String`	削除するユーザーのメールアドレス。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`removeEditor(user)`

ドライブファイルの場合、この操作により、ユーザーは閲覧者のリストからも削除されます。

パラメータ

名前	型	説明
`user`	`User`	削除するユーザーを表す。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`removeViewer(emailAddress)`

指定したユーザーを File の閲覧者とコメント投稿者のリストから削除します。ユーザーが視聴者やコメント投稿者ではなく編集者である場合、この方法は効果がありません。また、この方法では、一般アクセス権を持つユーザークラスに属しているユーザーが File にアクセスできないようにはなりません。たとえば、File がユーザーのドメイン全体と共有されている場合や、File がユーザーがアクセスできる共有ドライブにある場合などです。

ドライブファイルの場合、この操作により、ユーザーは編集者のリストからも削除されます。

パラメータ

名前	型	説明
`emailAddress`	`String`	削除するユーザーのメールアドレス。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`removeViewer(user)`

指定したユーザーを File の閲覧者とコメント投稿者のリストから削除します。ユーザーが閲覧者ではなく編集者である場合、このメソッドは効果がありません。また、この方法では、一般的なアクセス権を持つユーザークラスに属しているユーザーが File にアクセスできないようにはなりません。たとえば、File がユーザーのドメイン全体と共有されている場合や、File がユーザーがアクセスできる共有ドライブにある場合などです。

ドライブファイルの場合、この操作により、ユーザーは編集者のリストからも削除されます。

パラメータ

名前	型	説明
`user`	`User`	削除するユーザーを表す。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`revokePermissions(emailAddress)`

指定されたユーザーに付与された File へのアクセス権を取り消します。この方法では、File がユーザーのドメイン全体と共有されている場合など、一般的なアクセス権を持つユーザークラスに属しているユーザーが File にアクセスできないようにはなりません。

パラメータ

名前	型	説明
`emailAddress`	`String`	アクセス権を取り消すユーザーのメールアドレス。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`revokePermissions(user)`

パラメータ

名前	型	説明
`user`	`User`	アクセス権を取り消すユーザーを表します。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`setContent(content)`

ファイルの内容を指定された置換文字列で上書きします。content が 10 MB を超えると、例外がスローされます。

// Creates a text file with the content 'Hello, world!'
const file = DriveApp.createFile('New Text File', 'Hello, world!');

// Logs the content of the text file to the console.
console.log(file.getBlob().getDataAsString());

// Updates the content of the text file to 'Updated text!'
file.setContent('Updated text!');

// Logs content of the text file to the console.
console.log(file.getBlob().getDataAsString());

パラメータ

名前	型	説明
`content`	`String`	ファイルの新しいコンテンツ。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`setDescription(description)`

File の説明を設定します。

パラメータ

名前	型	説明
`description`	`String`	`File` の新しい説明

戻る

File - チェーン用の this File

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`setName(name)`

File の名前を設定します。

パラメータ

名前	型	説明
`name`	`String`	`File` の新しい名前

戻る

File - チェーン用の this File

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`setOwner(emailAddress)`

File のオーナーを変更します。この方法では、以前のオーナーに File に対する明示的な編集アクセス権も付与されます。

パラメータ

名前	型	説明
`emailAddress`	`String`	新しいオーナーになるユーザーのメールアドレス

戻る

File - チェーン用の this File

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`setOwner(user)`

File のオーナーを変更します。この方法では、以前のオーナーに File に対する明示的な編集アクセス権も付与されます。

パラメータ

名前	型	説明
`user`	`User`	新しいオーナーになるユーザーの表現

戻る

File - チェーン用の this File

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`setSecurityUpdateEnabled(enabled)`

File がリンクを使用して共有されるときに、アクセスにリソースキーが必要かどうかを設定します。対象となるファイルとフォルダはデフォルトで有効になっています。

詳しくは、Google ドライブのセキュリティアップデートをご覧ください。

パラメータ

名前	型	説明
`enabled`	`Boolean`	`File` のリソースキー要件を有効にするかどうか。

戻る

File - チェーン用の File。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`setShareableByEditors(shareable)`

File の編集権限を持つユーザーが他のユーザーと共有したり、権限を変更したりできるかどうかを設定します。新しい File のデフォルトは true です。

パラメータ

名前	型	説明
`shareable`	`Boolean`	`true`: 編集権限を持つユーザーが他のユーザーと共有したり、権限を変更したりできるようにする場合。そうでない場合は `false`

戻る

File - チェーン用の this File

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`setSharing(accessType, permissionType)`

File にアクセスできるユーザークラスと、そのユーザーに付与される権限を設定します。明示的にアクセス権が付与されている個々のユーザーは除きます。

// Creates a folder that anyone on the Internet can read from and write to.
// (Domain administrators can prohibit this setting for users of a Google
// Workspace domain.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

パラメータ

名前	型	説明
`accessType`	`Access`	`File` にアクセスできるユーザーのクラス
`permissionType`	`Permission`	`File` にアクセスできるユーザーに付与する必要がある権限

戻る

File - チェーン用の this File

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`setStarred(starred)`

File がユーザーのドライブでスターを付けられるかどうかを設定します。新しい File のデフォルトは false です。

パラメータ

名前	型	説明
`starred`	`Boolean`	`File` をユーザーのドライブでスターを付ける必要がある場合は `true`、そうでない場合は `false`

戻る

File - チェーン用の this File

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive

`setTrashed(trashed)`

File がユーザーのドライブのゴミ箱にあるかどうかを設定します。File をゴミ箱に移動できるのはオーナーのみです。新しい File のデフォルトは false です。

パラメータ

名前	型	説明
`trashed`	`Boolean`	`File` をユーザーのドライブのゴミ箱に移動する必要がある場合は `true`、そうでない場合は `false`

戻る

File - チェーン用の this File

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/drive