Acl: insert

Tworzy regułę kontroli dostępu. Wypróbuj go 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 głównego aktualnie zalogowanego użytkownika, użyj słowa kluczowego „primary”.
Opcjonalne parametry zapytania
sendNotifications boolean Określa, czy wysyłać powiadomienia o zmianie udostępniania kalendarza. Opcjonalnie. Domyślnie jest to wartość True.

Autoryzacja

To żądanie wymaga autoryzacji z użyciem co najmniej jednego 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
Właściwości wymagane
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.
  • „reader” – zapewnia dostęp do 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 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” (publicznym) dotyczą wszystkich użytkowników, niezależnie od tego, czy są uwierzytelnieni.
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ęte 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.