リソース: Permission
ファイルに対する権限。権限は、ユーザー、グループ、ドメイン、またはすべてのユーザーにファイルまたはフォルダ階層へのアクセス権を付与するものです。
一部のリソース メソッド(permissions.update
など)には permissionId
が必要です。permissions.list
メソッドを使用して、ファイル、フォルダ、または共有ドライブの ID を取得します。
JSON 表現 |
---|
{ "id": string, "displayName": string, "type": string, "kind": string, "permissionDetails": [ { "permissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "photoLink": string, "emailAddress": string, "role": string, "allowFileDiscovery": boolean, "domain": string, "expirationTime": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
フィールド | |
---|---|
id |
出力のみ。この権限の ID。これは譲受人の一意の識別子であり、 |
displayName |
出力のみ。権限の値の「美しい」名前。権限の種類ごとの例を以下に示します。
|
type |
譲受人のタイプ。指定できる値は次のとおりです。
権限を作成する際に、 |
kind |
出力のみ。リソースの種類を示します。値: 固定文字列 |
permissionDetails[] |
出力のみ。この共有ドライブ アイテムの権限が継承されるか、このアイテムで直接継承されるかの詳細。共有ドライブのアイテムにのみ存在する出力専用のフィールドです。 |
permissionDetails[].permissionType |
出力のみ。このユーザーの権限タイプ。今後新しい値が追加される可能性がありますが、現時点では以下が可能です。
|
permissionDetails[].inheritedFrom |
出力のみ。この権限の継承元のアイテムの ID です。出力専用フィールドです。 |
permissionDetails[].role |
出力のみ。このユーザーのメインの役割。今後、新しい値が追加される可能性がありますが、現時点では以下が可能です。
|
permissionDetails[].inherited |
出力のみ。この権限が継承されるかどうか。このフィールドは常に入力されます。出力専用フィールドです。 |
photoLink |
出力のみ。ユーザーのプロフィール写真へのリンク(ある場合)。 |
emailAddress |
この権限で参照されるユーザーまたはグループのメールアドレス。 |
role |
この権限によって付与されるロール。将来的に新しい値もサポートされる可能性がありますが、現在のところ次の値を使用できます。
|
allowFileDiscovery |
検索によるファイルの検索を許可するかどうか。これは、 |
domain |
この権限によって参照されるドメイン。 |
expirationTime |
この権限が期限切れになる時刻(RFC 3339 の日時)。有効期限には次の制限があります。
|
teamDrivePermissionDetails[] |
出力のみ。非推奨: 出力のみ。 |
teamDrivePermissionDetails[] |
非推奨: 出力のみ。 |
teamDrivePermissionDetails[] |
非推奨: 出力のみ。 |
teamDrivePermissionDetails[] |
非推奨: 出力のみ。 |
teamDrivePermissionDetails[] |
非推奨: 出力のみ。 |
deleted |
出力のみ。この権限に関連付けられたアカウントが削除されているかどうか。このフィールドは、ユーザーとグループの権限にのみ関連します。 |
view |
この権限のビューを示します。ビューに属する権限にのみ入力されます。サポートされている値は「published」のみです。 |
pendingOwner |
この権限に関連付けられているアカウントが保留中のオーナーかどうか。共有ドライブにないファイルに対する |
Methods |
|
---|---|
|
ファイルまたは共有ドライブの権限を作成します。 |
|
権限を削除します。 |
|
ID で権限を取得します。 |
|
ファイルまたは共有ドライブの権限を一覧表示します。 |
|
パッチ セマンティクスを使用して権限を更新します。 |