Acl
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Listę metod dotyczących tego zasobu znajdziesz na końcu tej strony.
Reprezentacje zasobów
{
"kind": "calendar#aclRule",
"etag": etag,
"id": string,
"scope": {
"type": string,
"value": string
},
"role": string
}
Nazwa usługi |
Wartość |
Opis |
Uwagi |
etag |
etag |
ETag zasobu. |
|
id |
string |
Identyfikator reguły listy kontroli dostępu (ACL). Zobacz Udostępnianie kalendarzy. |
|
kind |
string |
Typ zasobu („calendar#aclRule ”). |
|
role |
string |
Rola przypisana do zakresu. Możliwe wartości: - „
none ” – brak dostępu. - „
freeBusyReader ” – zapewnia dostęp tylko do odczytu informacji o dostępności. - „
reader ” – zapewnia dostęp do odczytu kalendarza. Wydarzenia prywatne będą widoczne dla użytkowników z dostępem tylko do odczytu, ale szczegóły wydarzeń będą ukryte. - „
writer ” – zapewnia uprawnienia do odczytu i zapisu w kalendarzu. Wydarzenia prywatne będą widoczne dla użytkowników z dostępem do funkcji pisania, a szczegóły wydarzeń będą widoczne. Zapewnia uprawnienia do odczytu list kontrolnych dostępu do kalendarza. - „
owner ” – określa właściciela kalendarza. Ta rola ma wszystkie uprawnienia roli autor, a dodatkowo umożliwia manipulowanie listami ACL. |
zapisywalny
|
scope |
object |
Zakres, w jakim ta reguła ACL przyznaje dostęp do kalendarza. |
|
scope.type |
string |
Typ zakresu. Możliwe wartości: - „
default ” – zakres publiczny. Jest to wartość domyślna. - „
user ” – ogranicza zakres do jednego użytkownika. - „
group ” – ogranicza zakres do grupy. - „
domain ” – ogranicza zakres do domeny. Uwaga: uprawnienia przyznane w zakresie „default ” (czyli publicznie) dotyczą wszystkich użytkowników, bez względu na to, czy są uwierzytelnieni. |
|
scope.value |
string |
Adres e-mail użytkownika lub grupy albo nazwa domeny, w zależności od typu zakresu. Pominięte w przypadku typu „default ”. |
zapisywalny
|
Metody
- usuń
- Usuwanie reguły kontroli dostępu.
- get
- Zwraca regułę kontroli dostępu.
- insert
- Tworzy regułę kontroli dostępu.
- list
- Zwraca reguły na liście kontroli dostępu do kalendarza.
- patch
- Aktualizuje regułę kontroli dostępu. Ta metoda obsługuje semantykę poprawki. Pamiętaj, że każde żądanie zmiany zużywa 3 jednostki limitu; preferuj użycie
get
, a następnie update
. Podane przez Ciebie wartości pól zastąpią dotychczasowe wartości. Pola, których nie podasz w żądaniu, pozostaną niezmienione. Pola tablic, jeśli są określone, zastępują istniejące tablice. Spowoduje to odrzucenie wszystkich poprzednich elementów tablicy.
- update
- Aktualizuje regułę kontroli dostępu.
- watch
- Sprawdzaj zmiany w zasobach listy dostępu.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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."]]