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

ファイルコンテンツを保護する

Google Drive API は、ファイルのコンテンツの制限や、ファイルのダウンロード、印刷、コピーのオプションの禁止など、ファイルの変更を防ぐためのさまざまな方法をサポートしています。

ドライブのコンテンツの制限を使用してファイルを読み取り専用にする

Google ドライブファイルにコンテンツの制限を追加すると、ユーザーが次の操作を行えなくなります。

タイトルの変更
コンテンツの編集
リビジョンのアップロード
コメントの追加または変更

コンテンツの制限を適用すると、ドライブアイテムのアクセス権権限を変更することなく、そのコンテンツを読み取り専用にすることができます。これはアクセス制限ではないことを意味しますユーザーはファイルの内容を変更することはできませんが、アクセスレベルに基づいて他の操作は引き続き許可されます（たとえば、編集アクセス権を持つユーザーは、アイテムの移動や共有設定の変更を行うことができます）。

ドライブ内のファイルに対してコンテンツの制限を追加または削除するには、関連する権限がユーザーに付与されている必要があります。マイドライブまたは共有ドライブ内のファイルまたはフォルダに capabilities.canModifyEditorContentRestriction が設定されている場合、role=writer が割り当てられている必要があります。マイドライブまたは共有ドライブ内のファイルまたはフォルダに ownerRestricted コンテンツ制限が適用されている場合は、そのファイルの所有者であるか、role=organizer 権限を持っている必要があります。コンテンツ制限のあるアイテムを表示するには、ユーザーが role=reader 以上の権限を持っている必要があります。ロールの一覧については、ロールと権限をご覧ください。ファイルの権限を変更するには、権限を変更するをご覧ください。

files リソースの contentRestrictions.readOnly ブールフィールドを使用して、コンテンツの制限を設定できます。アイテムにコンテンツの制限を設定すると、既存の制限が上書きされます。

コンテンツの制限のシナリオ

ドライブアイテムに対するコンテンツの制限は、コンテンツを変更できないことをユーザーに示します。これには、次のような理由が考えられます。

レビューまたは監査期間中に共同編集ドキュメントの作業を一時停止する。
アイテムを承認済みなどの最終状態に設定する。
機密性の高い会議中に変更が行われないようにする。
自動化されたシステムによって処理されるワークフローの外部変更を禁止する。
Google Apps Script と Google Workspace アドオンによる編集の制限。
ドキュメントが誤って編集されないようにする。

ただし、コンテンツの制限はコンテンツの管理に役立ちますが、十分な権限を持つユーザーがアイテムの作業を続行できないようにするためのものではありません。また、不変のレコードを作成する方法ではありません。ドライブのコンテンツ制限は変更可能であるため、アイテムに対するコンテンツ制限があっても、アイテムが変更されないことを保証するものではありません。

コンテンツの制限のあるファイルを管理する

Google ドキュメント、Google スプレッドシート、Google スライド、およびその他のすべてのファイルには、コンテンツの制限を含めることができます。

アイテムにコンテンツ制限を適用すると、タイトルとコンテンツ（以下を含む）を変更できなくなります。

コメントと提案（ドキュメント、スプレッドシート、スライド、バイナリファイル）
バイナリファイルの変更履歴
ドキュメントのテキストと書式設定
スプレッドシート内のテキストまたは数式、スプレッドシートのレイアウト、スプレッドシート内のインスタンス
スライド内のすべてのコンテンツ、スライドの順序と数

一部のファイル形式にはコンテンツの制限を含めることはできません。以下に例を示します。

Google フォーム
Google サイト
Google 図形描画
ショートカットとサードパーティ製ショートカット。詳細については、アプリによって保存されたコンテンツへのショートカットファイルを作成するとドライブファイルへのショートカットを作成するをご覧ください。

コンテンツの制限を追加する

ファイルコンテンツの制限を追加するには、contentRestrictions.readOnly フィールドを true に設定して files.update メソッドを使用します。制限を追加する理由（「契約の確定」など）を示す reason を追加します（省略可）。次のコードサンプルは、コンテンツの制限を追加する方法を示しています。

Java

File updatedFile =
  new File()
      .setContentRestrictions(
          ImmutableList.of(new ContentRestriction().setReadOnly(true).setReason("Finalized contract."));

File response = driveService.files().update("FILE_ID", updatedFile).setFields("contentRestrictions").execute();

Python

content_restriction = {'readOnly': True, 'reason':'Finalized contract.'}

response = drive_service.files().update(fileId="FILE_ID", body = {'contentRestrictions' : [content_restriction]}, fields = "contentRestrictions").execute();

Node.js

/**
* Set a content restriction on a file.
* @return{obj} updated file
**/
async function addContentRestriction() {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
  const service = google.drive({version: 'v3', auth});
  const contentRestriction = {
    'readOnly': True,
    'reason': 'Finalized contract.',
  };
  const updatedFile = {
    'contentRestrictions': [contentRestriction],
  };
  try {
    const response = await service.files.update({
      fileId: 'FILE_ID',
      resource: updatedFile,
      fields: 'contentRestrictions',
    });
    return response;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }
}

FILE_ID は、変更するファイルの fileId に置き換えます。

サンプルコードを実行すると、ファイルの内容が制限され、Google ドライブのユーザーインターフェース（UI）でファイル名の横に鍵記号（）が表示されます。ファイルは読み取り専用になりました。

コンテンツの制限を解除する

ファイルコンテンツの制限を削除するには、contentRestrictions.readOnly フィールドを false に設定して files.update メソッドを使用します。次のコードサンプルは、コンテンツの制限を削除する方法を示しています。

Java

File updatedFile =
new File()
    .setContentRestrictions(
        ImmutableList.of(new ContentRestriction().setReadOnly(false));

File response = driveService.files().update("FILE_ID", updatedFile).setFields("contentRestrictions").execute();

Python

content_restriction = {'readOnly': False}

response = drive_service.files().update(fileId="FILE_ID", body = {'contentRestrictions' : [content_restriction]}, fields = "contentRestrictions").execute();

Node.js

/**
* Remove a content restriction on a file.
* @return{obj} updated file
**/
async function removeContentRestriction() {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
  const service = google.drive({version: 'v3', auth});
  const contentRestriction = {
    'readOnly': False,
  };
  const updatedFile = {
    'contentRestrictions': [contentRestriction],
  };
  try {
    const response = await service.files.update({
      fileId: 'FILE_ID',
      resource: updatedFile,
      fields: 'contentRestrictions',
    });
    return response;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }
}

FILE_ID は、変更するファイルの fileId に置き換えます。

サンプルコードを実行すると、ファイルのコンテンツ制限が解除されます。

また、ドライブの UI を使用してコンテンツの制限を解除し、コンテンツの編集を許可することもできます（適切な権限がある場合）。これを行うには、次の 2 つの方法があります。

ドライブで、コンテンツの制限が設定されているファイルを右クリックし、[ロックを解除 ] をクリックします。

図 2. ドライブファイルリスト内のファイルコンテンツの制限を解除します。
コンテンツの制限のあるファイルを開き、（ロックされたモード） > [ファイルをロック解除] をクリックします。

図 3. ドキュメント内のファイルコンテンツの制限を削除する。

コンテンツの制限を確認する

コンテンツの制限を確認するには、返された contentRestrictions フィールドで files.get メソッドを使用します。次のコードサンプルは、コンテンツの制限のステータスを確認する方法を示しています。

Java

File response = driveService.files().get("FILE_ID").setFields("contentRestrictions").execute();

Python

response = drive_service.files().get(fileId="FILE_ID", fields = "contentRestrictions").execute();

Node.js

/**
* Get content restrictions on a file.
* @return{obj} updated file
**/
async function fetchContentRestrictions() {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
  const service = google.drive({version: 'v3', auth});
  try {
    const response = await service.files.get({
      fileId: 'FILE_ID',
      fields: 'contentRestrictions',
    });
    return response;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }
}

FILE_ID は、確認するファイルの fileId に置き換えます。

サンプルコードを実行すると、メソッドは ContentRestriction リソース（存在する場合）を返します。

ファイルのオーナーのみが変更できるコンテンツの制限を追加する

ファイル所有者のみがメカニズムを切り替えられるようにファイルコンテンツの制限を追加するには、contentRestrictions.ownerRestricted ブール値フィールドを true に設定して files.update メソッドを使用します。次のコードサンプルは、ファイル所有者のみに対してコンテンツの制限を追加する方法を示しています。

Java

File updatedFile =
  new File()
      .setContentRestrictions(
          ImmutableList.of(new ContentRestriction().setReadOnly(true).setOwnerRestricted(true).setReason("Finalized contract."));

File response = driveService.files().update("FILE_ID", updatedFile).setFields("contentRestrictions").execute();

Python

content_restriction = {'readOnly': True, 'ownerRestricted': True, 'reason':'Finalized contract.'}

response = drive_service.files().update(fileId="FILE_ID", body = {'contentRestrictions' : [content_restriction]}, fields = "contentRestrictions").execute();

Node.js

/**
* Set an owner restricted content restriction on a file.
* @return{obj} updated file
**/
async function addOwnerRestrictedContentRestriction() {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
  const service = google.drive({version: 'v3', auth});
  const contentRestriction = {
    'readOnly': True,
    'ownerRestricted': True,
    'reason': 'Finalized contract.',
  };
  const updatedFile = {
    'contentRestrictions': [contentRestriction],
  };
  try {
    const response = await service.files.update({
      fileId: 'FILE_ID',
      resource: updatedFile,
      fields: 'contentRestrictions',
    });
    return response;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }
}

FILE_ID は、変更するファイルの fileId に置き換えます。

サンプルコードを実行すると、ファイルはコンテンツが制限され、ファイルオーナーのみが削除できるようになります。ファイルのオーナーの場合は、ドライブのユーザーインターフェース（UI）内のファイル名の横にアクティブなロックシンボル（）が表示されます。自分がオーナーでない場合は、ロックアイコンが薄く表示されます。

ownerRestricted フラグを削除するには、contentRestrictions.ownerRestricted フィールドを false に設定して files.update メソッドを使用します。

コンテンツの制限機能

files リソースには、ファイルに対してアクションを実行できるかどうかを示すブール値 capabilities フィールドのコレクションが含まれています。

コンテンツの制限には、次の capabilities が含まれます。

capabilities.canModifyEditorContentRestriction: 現在のユーザーがコンテンツの制限を追加または変更できるかどうか。
capabilities.canModifyOwnerContentRestriction: 現在のユーザーがオーナーのコンテンツ制限を追加または変更できるかどうか。
capabilities.canRemoveContentRestriction: 現在のユーザーが適用されたコンテンツ制限（存在する場合）を削除できるかどうか。

詳細については、機能をご覧ください。

ファイル capabilities の取得例については、ユーザー権限を確認するをご覧ください。

ユーザーがファイルをダウンロード、印刷、コピーできないようにする

role=commenter 権限または role=reader 権限を持つユーザーがドライブ、ドキュメント、スプレッドシート、スライド内でファイルをダウンロード、印刷、コピーする方法は制限できます。

ファイルのダウンロード、印刷、コピーのオプションを削除するには、copyRequiresWriterPermission ブール値フィールドを true に設定して files.update メソッドを使用します。

ファイル コンテンツを保護する

ドライブのコンテンツの制限を使用してファイルを読み取り専用にする

コンテンツの制限のシナリオ

コンテンツの制限のあるファイルを管理する

コンテンツの制限を追加する

Java

Python

Node.js

コンテンツの制限を解除する

Java

Python

Node.js

コンテンツの制限を確認する

Java

Python

Node.js

ファイルのオーナーのみが変更できるコンテンツの制限を追加する

Java

Python

Node.js

コンテンツの制限機能

ユーザーがファイルをダウンロード、印刷、コピーできないようにする

ファイルコンテンツを保護する