リソース: 権限
ファイルの権限。権限により、ユーザー、グループ、ドメイン、または全世界に、ファイルまたはフォルダ階層へのアクセス権を付与します。
一部のリソース メソッド(permissions.update
など)には permissionId
が必要です。ファイル、フォルダ、共有ドライブの ID を取得するには、permissions.list
メソッドを使用します。
JSON 表現 |
---|
{ "id": string, "name": string, "type": string, "role": string, "additionalRoles": [ string ], "authKey": string, "value": string, "kind": string, "withLink": boolean, "photoLink": string, "selfLink": string, "emailAddress": string, "domain": string, "etag": string, "permissionDetails": [ { "permissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "expirationDate": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
フィールド | |
---|---|
id |
この権限が参照しているユーザーの ID。概要リソースとファイル リソースの |
name |
出力のみ。この権限の名前。 |
type |
アカウントの種類。指定できる値は次のとおりです。
|
role |
このユーザーのメインのロール。今後、新しい値がサポートされますが、現時点では次の値が許可されます。
|
additionalRoles[] |
このユーザーの追加のロール。現時点では |
authKey |
出力のみ。廃止されました。 |
value |
エンティティのメールアドレスまたはドメイン名。これは挿入時に使用され、レスポンスには含まれません。 |
kind |
出力のみ。これは常に |
withLink |
この権限にリンクが必要か。 |
photoLink |
出力のみ。プロフィール写真へのリンク(ある場合)。 |
selfLink |
出力のみ。この権限へのリンク。 |
emailAddress |
出力のみ。この権限を参照するユーザーまたはグループのメールアドレス。これは出力専用のフィールドで、権限タイプが |
domain |
出力のみ。この権限が参照しているエンティティのドメイン名。これは、権限タイプが |
etag |
出力のみ。権限の ETag。 |
permissionDetails[] |
出力のみ。この共有ドライブ アイテムの権限が継承されているか、このアイテムに直接付与されているかの詳細。出力専用のフィールドで、共有ドライブのアイテムにのみ存在します。 |
permissionDetails[].permissionType |
出力のみ。このユーザーの権限タイプ。今後、新しい値が追加される可能性がありますが、現在のところ以下が可能です。
|
permissionDetails[].role |
出力のみ。このユーザーのメインのロール。今後、次のような値が追加される可能性があります。
|
permissionDetails[].additionalRoles[] |
出力のみ。このユーザーの追加のロール。現時点では |
permissionDetails[].inheritedFrom |
出力のみ。この権限の継承元であるアイテムの ID。出力専用のフィールドです。 |
permissionDetails[].inherited |
出力のみ。この権限を継承しているかどうか。このフィールドは常に入力されます。出力専用のフィールドです。 |
expirationDate |
この権限の有効期限(RFC 3339 の日時)。有効期限には次の制限があります。
|
teamDrivePermissionDetails[] |
出力のみ。非推奨: 代わりに |
teamDrivePermissionDetails[] |
出力のみ。非推奨: 代わりに |
teamDrivePermissionDetails[] |
出力のみ。非推奨: 代わりに |
teamDrivePermissionDetails[] |
出力のみ。非推奨: 代わりに |
teamDrivePermissionDetails[] |
出力のみ。非推奨: 代わりに |
teamDrivePermissionDetails[] |
出力のみ。非推奨: 代わりに |
deleted |
出力のみ。この権限に関連付けられたアカウントが削除されているかどうか。このフィールドは、ユーザーとグループの権限にのみ関係します。 |
view |
この権限のビューを示します。ビューに属する権限に対してのみ入力されます。サポートされる値は |
pendingOwner |
この権限に関連付けられたアカウントが保留中のオーナーかどうか。共有ドライブにファイルがないファイルに限り、 |
Methods |
|
---|---|
|
ファイルまたは共有ドライブから権限を削除します。 |
|
ID で権限を取得します。 |
|
メールアドレスの権限 ID を返します。 |
|
ファイルまたは共有ドライブの権限を挿入します。 |
|
ファイルまたは共有ドライブの権限を一覧表示します。 |
|
パッチ セマンティクスを使用して権限を更新します。 |
|
権限を更新します。 |