Acl: update

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

Żądanie

Żądanie HTTP

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

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 głównego aktualnie zalogowanego użytkownika, użyj słowa kluczowego „primary”.
ruleId string Identyfikator reguły listy ACL.
Opcjonalne parametry zapytania
sendNotifications boolean Określa, czy wysyłać powiadomienia o zmianie udostępniania kalendarza. Pamiętaj, że nie ma powiadomień o usunięciu dostępu. 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 dotyczącej uwierzytelniania i autoryzacji.

Treść żądania

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

Nazwa usługi Wartość Opis Uwagi
Właściwości wymagane
scope object Zakres, w jakim ta reguła listy 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” (publicznym) dotyczą wszystkich użytkowników, niezależnie od tego, czy są uwierzytelnieni.
Właściwości opcjonalne
role string Rola przypisana do zakresu. Możliwe wartości:
  • „none” – nie zapewnia dostępu.
  • „freeBusyReader” – zapewnia dostęp 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 do odczytu, ale szczegóły wydarzeń będą ukryte.
  • „writerWithoutPrivateAccess” – zapewnia dostęp do odczytu i zapisu w kalendarzu. Wydarzenia prywatne będą widoczne dla użytkowników z dostępem writerWithoutPrivateAccess, ale szczegóły wydarzeń będą ukryte.
  • „writer” – zapewnia dostęp do odczytu i zapisu w kalendarzu. Wydarzenia prywatne będą widoczne dla użytkowników z dostępem do zapisu, a szczegóły wydarzeń będą widoczne. Zapewnia dostęp do odczytu list ACL kalendarza.
  • „owner” – zapewnia dostęp do zarządzania kalendarzem. Ta rola ma wszystkie uprawnienia roli zapisującego oraz dodatkową możliwość modyfikowania poziomów dostępu innych użytkowników.

Z możliwością zapisu
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, ta metoda zwróci w treści odpowiedzi zasób Acl.

Wypróbuj

Aby wywołać tę metodę na podstawie rzeczywistych danych i zobaczyć odpowiedź, użyj Eksploratora interfejsów API poniżej.