リソース: 権限
ファイルの権限。権限により、ユーザー、グループ、ドメイン、または全世界に、ファイルまたはフォルダ階層へのアクセス権を付与します。
一部のリソース メソッド(permissions.update
など)には permissionId
が必要です。ファイル、フォルダ、共有ドライブの ID を取得するには、permissions.list
メソッドを使用します。
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 で権限を取得します。 |
|
ファイルまたは共有ドライブの権限を一覧表示します。 |
|
パッチ セマンティクスで権限を更新します。 |