Google ドライブのファイルやフォルダを共有するには、 ドライブの UI または Google Drive API:Google Chat で ドライブでは、各ユーザーがファイルの編集、コメントの追加、 ファイルを開くだけです。
リソースキーは、意図しないアクセスからファイルを保護するために役立ちます。リソースキー ユーザーが特定のファイルにアクセスできるように、 メッセージのリンクが表示されます。以前にファイルを閲覧したことがないユーザー アクセスするにはリソースキーを指定する必要があります。最近閲覧した広告の ファイルにアクセスするためにリソースキーは必要ありません。
リンクで共有されているドライブ ファイルは、
type=user
または type=group
の結果としてファイルにアクセスできるユーザー
permissions
リソース。ユーザーからのリクエスト
権限があるファイルのみにアクセスできるユーザーで、type=domain
または
type=anyone
権限でリソースキーが必要になる場合があります。
権限について詳しくは、ファイル、フォルダ、ドライブを共有するをご覧ください。ロールとオペレーションの完全なリストについては、 各ロールについては、ロールと権限。
ファイルからリソースキーを読み取る
Drive API は、読み取り専用ファイルでファイルのリソースキーを返します。
files
リソースの resourceKey
フィールド。
ファイルがドライブのショートカットの場合は、
ショートカット ターゲットのリソースキーは読み取り専用
shortcutDetails.targetResourceKey
フィールド。
URL を返す files
リソース内のフィールド
(exportLinks
、webContentLink
、webViewLink
など)のオブジェクトには、
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 つのファイルのリソースキーが
resourceKey1
、resourceKey2
、resourceKey3
。ヘッダー
これらの値からスラッシュとカンマで区切って構築すると次のようになります。
X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3