リソースキーを使用してリンク共有ドライブのファイルにアクセスする

Google ドライブのファイルやフォルダを共有するには、 ドライブの UI または Google Drive API:Google Chat で ドライブでは、各ユーザーがファイルの編集、コメントの追加、 ファイルを開くだけです。

リソースキーは、意図しないアクセスからファイルを保護するために役立ちます。リソースキー ユーザーが特定のファイルにアクセスできるように、 メッセージのリンクが表示されます。以前にファイルを閲覧したことがないユーザー アクセスするにはリソースキーを指定する必要があります。最近閲覧した広告の ファイルにアクセスするためにリソースキーは必要ありません。

リンクで共有されているドライブ ファイルは、 type=user または type=group の結果としてファイルにアクセスできるユーザー permissions リソース。ユーザーからのリクエスト 権限があるファイルのみにアクセスできるユーザーで、type=domain または type=anyone 権限でリソースキーが必要になる場合があります。

権限について詳しくは、ファイル、フォルダ、ドライブを共有するをご覧ください。ロールとオペレーションの完全なリストについては、 各ロールについては、ロールと権限

ファイルからリソースキーを読み取る

Drive API は、読み取り専用ファイルでファイルのリソースキーを返します。 files リソースの resourceKey フィールド。

ファイルがドライブのショートカットの場合は、 ショートカット ターゲットのリソースキーは読み取り専用 shortcutDetails.targetResourceKey フィールド。

URL を返す files リソース内のフィールド (exportLinkswebContentLinkwebViewLink など)のオブジェクトには、 resourceKey。ドライブの UI と統合するクライアントは、 state 内で resourceKeys を使用する パラメータを指定します。詳しくは、ダウンロードとエクスポート ファイル

リクエストにリソースキーを設定する

Drive API へのリクエストで参照されるファイルのリソースキー X-Goog-Drive-Resource-Keys HTTP ヘッダーで設定されている。

Drive API へのリクエストでは、リソースキーを 1 つ以上指定できます。 X-Goog-Drive-Resource-Keys HTTP ヘッダー。

構文

ファイル ID とリソースキーのペアは、スラッシュを使用してヘッダーに設定されます。 (/)区切り文字を使用します。ヘッダーは、すべてのファイル ID とリソースを組み合わせて 鍵ペアをカンマ(,)で区切って指定します。

たとえば、ファイル fileId1 をフォルダ fileId2 から次のフォルダに移動するリクエストについて考えてみましょう。 フォルダ「fileId3」。これら 3 つのファイルのリソースキーが resourceKey1resourceKey2resourceKey3。ヘッダー これらの値からスラッシュとカンマで区切って構築すると次のようになります。

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3