Google ドライブのファイルとフォルダは、 ドライブ UI または Google Drive API を使用して他のユーザーと共有できます。ドライブから共有する際は、ファイルの編集、ファイルへのコメント、ファイルの閲覧のみ、のいずれかの権限を共有相手に対して設定できます。
リソースキー は、意図しないアクセスからファイルを保護するのに役立ちます。リソースキーは、リンクを使用して共有された特定のファイルにユーザーがアクセスできるように渡される追加のパラメータです。そのファイルを閲覧したことのないユーザーがファイルにアクセスするには、リソースキーを提供する必要があります。最近そのファイルを閲覧したユーザーや、ファイルに直接アクセスできるユーザーは、リソースキーなしでファイルにアクセスできます。
リンクで共有されているドライブ ファイルは、
type=user または type=group
permissions リソースの結果としてファイルにアクセスできるユーザーのみが検出できます。type=domain または type=anyone 権限を使用して、リンクで共有されたこれらのファイルにのみアクセスできるユーザーからのリクエストには、リソースキーが必要になる場合があります。
権限の詳細については、ファイル、フォルダ、ドライブを共有するをご覧ください。ロールと各ロールで許可される操作の一覧については、ロールと権限をご覧ください。
ファイルからリソースキーを読み取る
Drive API は、読み取り専用
resourceKey フィールドにファイルのリソースキーを返します。files
ファイルがドライブのショートカットの場合、ショートカット ターゲットのリソースキーは読み取り専用の
shortcutDetails.targetResourceKey フィールドに返されます。
URL を返す files リソースのフィールド(exportLinks、webContentLink、webViewLink など)には、resourceKey も含まれます。ドライブ UI と統合するクライアントは、
resourceKeys を state
パラメータ内で使用することもできます。詳しくは、ファイルをダウンロードしてエクスポートするをご覧ください。
リクエストにリソースキーを設定する
Drive API へのリクエストで参照されるファイルのリソースキーは、X-Goog-Drive-Resource-Keys HTTP ヘッダーに設定されます。
Drive API へのリクエストでは、X-Goog-Drive-Resource-Keys HTTP ヘッダーを使用して 1 つ以上のリソースキーを指定できます。
構文
ファイル ID とリソースキーのペアは、スラッシュ(/)区切り文字を使用してヘッダーに設定されます。ヘッダーは、カンマ(,)区切り文字を使用して、すべてのファイル ID とリソースキーのペアを組み合わせて作成されます。
たとえば、ファイル fileId1 をフォルダ fileId2 からフォルダ fileId3 に移動するリクエストについて考えてみましょう。これらの 3 つのファイルのリソースキーは、それぞれ resourceKey1、resourceKey2、resourceKey3 であるとします。スラッシュとカンマの区切り文字を使用してこれらの値から作成されたヘッダーは次のようになります。
X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3