Acl
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
このリソースのメソッドの一覧は、このページの最後に掲載されています。
リソース表現
{
"kind": "calendar#aclRule",
"etag": etag,
"id": string,
"scope": {
"type": string,
"value": string
},
"role": string
}
プロパティ名 |
値 |
説明 |
メモ |
etag |
etag |
リソースの ETag。 |
|
id |
string |
アクセス制御リスト(ACL)ルールの ID。カレンダーの共有をご覧ください。 |
|
kind |
string |
リソースのタイプ(「calendar#aclRule 」)。 |
|
role |
string |
スコープに割り当てられたロール。指定できる値は次のとおりです。 - 「
none 」- アクセス権を付与しません。 - 「
freeBusyReader 」- 空き/不在情報への読み取りアクセス権を付与します。 - 「
reader 」 - カレンダーへの読み取りアクセス権を付与します。限定公開のイベントは、閲覧者権限を持つユーザーには表示されますが、イベントの詳細は非表示になります。 - 「
writer 」- カレンダーに対する読み取り / 書き込みアクセス権を付与します。非公開イベントは、作成者権限を持つユーザーに表示され、イベントの詳細も表示されます。カレンダーの ACL への読み取りアクセス権を付与します。 - 「
owner 」 - カレンダーのオーナー権限を付与します。このロールには、書き込みロールのすべての権限に加えて、ACL を操作する権限があります。 |
書き込み可能
|
scope |
object |
この ACL ルールによってカレンダーへのアクセスが許可される範囲。 |
|
scope.type |
string |
スコープのタイプ。指定できる値は次のとおりです。 - 「
default 」- 公開スコープ。これがデフォルト値です。 - 「
user 」- スコープを 1 人のユーザーに制限します。 - 「
group 」 - スコープをグループに制限します。 - 「
domain 」 - スコープをドメインに制限します。 注: 「default 」スコープ(公開スコープ)に付与された権限は、認証されているかどうかにかかわらず、すべてのユーザーに適用されます。 |
|
scope.value |
string |
スコープの種類に応じて、ユーザーまたはグループのメールアドレス、またはドメイン名。タイプ「default 」の場合は省略されます。 |
書き込み可能
|
メソッド
- delete
- アクセス制御ルールを削除します。
- get
- アクセス制御ルールを返します。
- insert
- アクセス制御ルールを作成します。
- list
- カレンダーのアクセス制御リスト内のルールを返します。
- patch
- アクセス制御ルールを更新します。このメソッドは、パッチ セマンティクスをサポートしています。各パッチ リクエストは 3 つの割り当てユニットを消費します。
get
の後に update
を使用することをおすすめします。指定したフィールド値が既存の値に置き換えられます。リクエストで指定しないフィールドは変更されません。配列フィールドが指定されている場合、既存の配列が上書きされます。これにより、以前の配列要素は破棄されます。
- update
- アクセス制御ルールを更新します。
- watch
- ACL リソースの変更を監視します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],null,["# Acl\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```carbon\n{\n \"kind\": \"calendar#aclRule\",\n \"etag\": etag,\n \"id\": string,\n \"scope\": {\n \"type\": string,\n \"value\": string\n },\n \"role\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| `etag` | `etag` | ETag of the resource. | |\n| `id` | `string` | Identifier of the Access Control List (ACL) rule. See [Sharing calendars](https://developers.google.com/workspace/calendar/concepts/sharing#sharing_calendars). | |\n| `kind` | `string` | Type of the resource (\"`calendar#aclRule`\"). | |\n| `role` | `string` | The role assigned to the scope. Possible values are: - \"`none`\" - Provides no access. - \"`freeBusyReader`\" - Provides read access to free/busy information. - \"`reader`\" - Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden. - \"`writer`\" - Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible. Provides read access to the calendar's ACLs. - \"`owner`\" - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to manipulate ACLs. | writable |\n| `scope` | `object` | The extent to which [calendar access](https://developers.google.com/workspace/calendar/concepts/sharing#sharing_calendars) is granted by this ACL rule. | |\n| scope.`type` | `string` | The type of the scope. Possible values are: - \"`default`\" - The public scope. This is the default value. - \"`user`\" - Limits the scope to a single user. - \"`group`\" - Limits the scope to a group. - \"`domain`\" - Limits the scope to a domain. Note: The permissions granted to the \"`default`\", or public, scope apply to any user, authenticated or not. | |\n| scope.`value` | `string` | The email address of a user or group, or the name of a domain, depending on the scope type. Omitted for type \"`default`\". | writable |\n\nMethods\n-------\n\n[delete](/workspace/calendar/api/v3/reference/acl/delete)\n: Deletes an access control rule.\n\n[get](/workspace/calendar/api/v3/reference/acl/get)\n: Returns an access control rule.\n\n[insert](/workspace/calendar/api/v3/reference/acl/insert)\n: Creates an access control rule.\n\n[list](/workspace/calendar/api/v3/reference/acl/list)\n: Returns the rules in the access control list for the calendar.\n\n[patch](/workspace/calendar/api/v3/reference/acl/patch)\n: Updates an access control rule. This method supports patch semantics. Note that each patch request consumes three quota units; prefer using a `get` followed by an `update`. The field values you specify replace the existing values. Fields that you don't specify in the request remain unchanged. Array fields, if specified, overwrite the existing arrays; this discards any previous array elements.\n\n[update](/workspace/calendar/api/v3/reference/acl/update)\n: Updates an access control rule.\n\n[watch](/workspace/calendar/api/v3/reference/acl/watch)\n: Watch for changes to ACL resources."]]