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()DateFile が作成された日付を取得します。
getDescription()StringFile の説明を取得します。
getDownloadUrl()Stringファイルをダウンロードするために使用できる URL を取得します。
getEditors()User[]この File の編集者のリストを取得します。
getId()StringFile の ID を取得します。
getLastUpdated()DateFile が最後に更新された日付を取得します。
getMimeType()Stringファイルの MIME タイプを取得します。
getName()StringFile の名前を取得します。
getOwner()Userファイルのオーナーを取得します。
getParents()FolderIteratorFile の直接の親であるフォルダのコレクションを取得します。
getResourceKey()Stringリンクを使用して共有されたアイテムにアクセスするために必要な File のリソースキーを取得します。
getSecurityUpdateEligible()Booleanこの File が、リンクを使用して共有する際にアクセスにリソースキーを必要とするセキュリティ アップデートを適用できるかどうかを取得します。
getSecurityUpdateEnabled()Booleanこの File をリンクを使用して共有するときに、アクセスにリソースキーが必要かどうかを取得します。
getSharingAccess()Access明示的にアクセス権が付与されている個々のユーザーのほかに、File にアクセスできるユーザークラスを取得します。
getSharingPermission()PermissionFile にアクセスできるユーザーに付与されている権限を取得します。明示的にアクセス権が付与されている個々のユーザーは除きます。
getSize()Integerドライブに File を保存するために使用されるバイト数を取得します。
getTargetId()Stringショートカットの場合は、ショートカットが参照するアイテムの ID を返します。
getTargetMimeType()Stringショートカットの場合は、ショートカットが参照するアイテムの MIME タイプを返します。
getTargetResourceKey()Stringファイルがショートカットの場合は、そのファイルが参照するアイテムのリソースキーを返します。
getThumbnail()Blobファイルのサムネイル画像を取得します。サムネイルが存在しない場合は null を取得します。
getUrl()StringGoogle ドライブや Google ドキュメントなどの Google アプリで File を開く際に使用できる URL を取得します。
getViewers()User[]この File の閲覧者とコメント投稿者のリストを取得します。
isShareableByEditors()BooleanFile の編集権限を持つユーザーが、他のユーザーと共有したり、権限を変更したりできるかどうかを決定します。
isStarred()BooleanFile がユーザーのドライブでスターを付けられているかどうかを判断します。
isTrashed()BooleanFile がユーザーのドライブのゴミ箱にあるかどうかを判断します。
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)FileFile の説明を設定します。
setName(name)FileFile の名前を設定します。
setOwner(emailAddress)FileFile のオーナーを変更します。
setOwner(user)FileFile のオーナーを変更します。
setSecurityUpdateEnabled(enabled)FileFile がリンクを使用して共有されるときに、アクセスにリソースキーが必要かどうかを設定します。
setShareableByEditors(shareable)FileFile の編集権限を持つユーザーが他のユーザーと共有したり、権限を変更したりできるかどうかを設定します。
setSharing(accessType, permissionType)FileFile にアクセスできるユーザークラスと、そのユーザーに付与される権限を設定します。明示的にアクセス権が付与されている個々のユーザーは除きます。
setStarred(starred)FileFile がユーザーのドライブでスターを付けられるかどうかを設定します。
setTrashed(trashed)FileFile がユーザーのドライブのゴミ箱にあるかどうかを設定します。

詳細なドキュメント

addCommenter(emailAddress)

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

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

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

パラメータ

名前説明
emailAddressString追加するユーザーのメールアドレス。

戻る

File - チェーン用の File

承認

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

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

addCommenter(user)

指定したユーザーを 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');

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

パラメータ

名前説明
userUser追加するユーザーを表します。

戻る

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));
}

パラメータ

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

戻る

File - チェーン用の File

承認

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

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

addEditor(emailAddress)

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

パラメータ

名前説明
emailAddressString追加するユーザーのメールアドレス。

戻る

File - チェーン用の File

承認

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

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

addEditor(user)

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

パラメータ

名前説明
userUser追加するユーザーを表します。

戻る

File - チェーン用の File

承認

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

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

addEditors(emailAddresses)

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

パラメータ

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

戻る

File - チェーン用の File

承認

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

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

addViewer(emailAddress)

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

パラメータ

名前説明
emailAddressString追加するユーザーのメールアドレス。

戻る

File - チェーン用の File

承認

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

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

addViewer(user)

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

パラメータ

名前説明
userUser追加するユーザーを表します。

戻る

File - チェーン用の File

承認

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

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

addViewers(emailAddresses)

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

パラメータ

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

戻る

File - チェーン用の File

承認

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

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

getAccess(email)

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

パラメータ

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

戻る

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

承認

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

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

getAccess(user)

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

パラメータ

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

戻る

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 ドメインには、一時的に厳しい割り当てが適用される場合があります。

パラメータ

名前説明
contentTypeString変換する 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());
}

パラメータ

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

戻る

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());
}

パラメータ

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

戻る

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());
}

パラメータ

名前説明
nameString新しいコピーに適用するファイル名。
destinationFolderファイルをコピーするディレクトリ。

戻る

File - 新しいコピー。

承認

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

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

moveTo(destination)

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

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

パラメータ

名前説明
destinationFolder新しい親となるフォルダ。

戻る

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');
}

パラメータ

名前説明
emailAddressString削除するユーザーのメールアドレス。

戻る

File - チェーン用の File

承認

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

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

removeCommenter(user)

指定したユーザーを 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.
  console.log(file.removeCommenter(Session.getActiveUser()));
}

パラメータ

名前説明
userUser削除するユーザーを表す。

戻る

File - チェーン用の File

承認

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

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

removeEditor(emailAddress)

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

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

パラメータ

名前説明
emailAddressString削除するユーザーのメールアドレス。

戻る

File - チェーン用の File

承認

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

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

removeEditor(user)

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

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

パラメータ

名前説明
userUser削除するユーザーを表す。

戻る

File - チェーン用の File

承認

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

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

removeViewer(emailAddress)

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

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

パラメータ

名前説明
emailAddressString削除するユーザーのメールアドレス。

戻る

File - チェーン用の File

承認

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

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

removeViewer(user)

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

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

パラメータ

名前説明
userUser削除するユーザーを表す。

戻る

File - チェーン用の File

承認

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

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

revokePermissions(emailAddress)

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

パラメータ

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

戻る

File - チェーン用の File

承認

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

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

revokePermissions(user)

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

パラメータ

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

戻る

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());

パラメータ

名前説明
contentStringファイルの新しいコンテンツ。

戻る

File - チェーン用の File

承認

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

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

setDescription(description)

File の説明を設定します。

パラメータ

名前説明
descriptionStringFile の新しい説明

戻る

File - チェーン用の this File

承認

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

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

setName(name)

File の名前を設定します。

パラメータ

名前説明
nameStringFile の新しい名前

戻る

File - チェーン用の this File

承認

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

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

setOwner(emailAddress)

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

パラメータ

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

戻る

File - チェーン用の this File

承認

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

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

setOwner(user)

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

パラメータ

名前説明
userUser新しいオーナーになるユーザーの表現

戻る

File - チェーン用の this File

承認

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

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

setSecurityUpdateEnabled(enabled)

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

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

パラメータ

名前説明
enabledBooleanFile のリソースキー要件を有効にするかどうか。

戻る

File - チェーン用の File

承認

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

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

setShareableByEditors(shareable)

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

パラメータ

名前説明
shareableBooleantrue: 編集権限を持つユーザーが他のユーザーと共有したり、権限を変更したりできるようにする場合。そうでない場合は 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);

パラメータ

名前説明
accessTypeAccessFile にアクセスできるユーザーのクラス
permissionTypePermissionFile にアクセスできるユーザーに付与する必要がある権限

戻る

File - チェーン用の this File

承認

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

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

setStarred(starred)

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

パラメータ

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

戻る

File - チェーン用の this File

承認

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

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

setTrashed(trashed)

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

パラメータ

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

戻る

File - チェーン用の this File

承認

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

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