Acl
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Untuk mengetahui daftar metode untuk resource ini, lihat bagian akhir halaman ini.
Representasi resource
{
"kind": "calendar#aclRule",
"etag": etag,
"id": string,
"scope": {
"type": string,
"value": string
},
"role": string
}
Nama properti |
Nilai |
Deskripsi |
Catatan |
etag |
etag |
ETag resource. |
|
id |
string |
ID aturan Daftar Kontrol Akses (ACL). Lihat Berbagi kalender. |
|
kind |
string |
Jenis resource ("calendar#aclRule "). |
|
role |
string |
Peran yang ditetapkan ke cakupan. Kemungkinan nilainya adalah: - "
none " - Tidak memberikan akses. - "
freeBusyReader " - Memberikan akses baca ke informasi luang/sibuk. - "
reader " - Memberikan akses baca ke kalender. Acara pribadi akan muncul kepada pengguna dengan akses pembaca, tetapi detail acara akan disembunyikan. - "
writer " - Memberikan akses baca dan tulis ke kalender. Acara pribadi akan muncul kepada pengguna dengan akses penulis, dan detail acara akan terlihat. Memberikan akses baca ke ACL kalender. - "
owner " - Memberikan kepemilikan kalender. Peran ini memiliki semua izin peran penulis dengan kemampuan tambahan untuk memanipulasi ACL. |
dapat ditulis
|
scope |
object |
Tingkat akses kalender yang diberikan oleh aturan ACL ini. |
|
scope.type |
string |
Jenis cakupan. Kemungkinan nilainya adalah: - "
default " - Cakupan publik. Nilai ini merupakan default. - "
user " - Membatasi cakupan ke satu pengguna. - "
group " - Membatasi cakupan ke grup. - "
domain " - Membatasi cakupan ke domain. Catatan: Izin yang diberikan ke cakupan "default ", atau publik, berlaku untuk semua pengguna, baik yang diautentikasi maupun tidak. |
|
scope.value |
string |
Alamat email pengguna atau grup, atau nama domain, bergantung pada jenis cakupan. Dihilangkan untuk jenis "default ". |
dapat ditulis
|
Metode
- hapus
- Menghapus aturan kontrol akses.
- get
- Menampilkan aturan kontrol akses.
- insert
- Membuat aturan kontrol akses.
- list
- Menampilkan aturan dalam daftar kontrol akses untuk kalender.
- patch
- Memperbarui aturan kontrol akses. Metode ini mendukung semantik patch. Perhatikan bahwa setiap permintaan patch menggunakan tiga unit kuota; sebaiknya gunakan
get
, diikuti dengan update
. Nilai kolom yang Anda tentukan akan menggantikan nilai yang ada. Kolom yang tidak Anda tentukan dalam permintaan tetap tidak berubah. Kolom array, jika ditentukan, akan menimpa array yang ada; tindakan ini akan menghapus elemen array sebelumnya.
- update
- Memperbarui aturan kontrol akses.
- watch
- Pantau perubahan pada resource ACL.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 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."]]