Acl: insert

Tworzy regułę kontroli dostępu. Wypróbuj teraz

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl

Parametry

Nazwa parametru Wartość Opis
Parametry ścieżki
calendarId string Identyfikator kalendarza. Aby pobrać identyfikatory kalendarzy, wywołaj metodę calendarList.list. Jeśli chcesz uzyskać dostęp do kalendarza podstawowego aktualnie zalogowanego użytkownika, użyj słowa kluczowego „primary”.
Opcjonalne parametry zapytania
sendNotifications boolean Określ, czy wysyłać powiadomienia o zmianie udostępniania kalendarza. Opcjonalnie: Wartość domyślna to True.

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów:

Zakres
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls

Więcej informacji znajdziesz na stronie Uwierzytelnianie i autoryzacja.

Treść żądania

W treści żądania podaj zasób Acl z tymi właściwościami:

Nazwa usługi Wartość Opis Uwagi
Wymagane właściwości
role string Rola przypisana do zakresu. Możliwe wartości:
  • „none” – nie zapewnia dostępu.
  • „freeBusyReader” – zapewnia dostęp do informacji o dostępności (tylko do odczytu).
  • „reader” – zapewnia dostęp do kalendarza w trybie odczytu. Wydarzenia prywatne będą widoczne dla użytkowników z dostępem 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 uprawnieniami do edycji, a szczegóły wydarzeń będą widoczne. Zapewnia dostęp z możliwością odczytu do list ACL kalendarza.
  • „owner” – zapewnia menedżerowi dostęp do kalendarza. Ta rola ma wszystkie uprawnienia roli osoby piszącej, a dodatkowo możliwość modyfikowania poziomów dostępu innych użytkowników.

z możliwością zapisu,
scope object Zakres dostępu do kalendarza przyznanego przez tę regułę listy kontroli dostępu.
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 zakresowi „default” lub publicznemu dotyczą każdego użytkownika, niezależnie od tego, czy jest on uwierzytelniony.
Właściwości opcjonalne
scope.value string Adres e-mail użytkownika lub grupy albo nazwa domeny, w zależności od typu zakresu. Pominięto w przypadku typu „default”. z możliwością zapisu,

Odpowiedź

Jeśli operacja się uda, metoda zwróci w treści odpowiedzi zasób Acl.

Wypróbuj

Użyj narzędzia APIs Explorer poniżej, aby wywołać tę metodę na danych na żywo i zobaczyć odpowiedź.