Tworzy regułę kontroli dostępu. Wypróbuj lub zobacz przykład.
Prośba
Żą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 powiadomienia o zmianie w udostępnianiu kalendarza mają być wysyłane. Opcjonalnie. Wartość domyślna to True. |
Upoważnienie
To żądanie wymaga autoryzacji w tym zakresie:
Zakres |
---|
https://www.googleapis.com/auth/calendar |
Więcej informacji znajdziesz na stronie uwierzytelniania i autoryzacji.
Treść żądania
W treści żądania podaj zasób listy kontroli dostępu 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:
|
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 ” (lub publicznie) dotyczy każdego użytkownika, niezależnie od tego, czy został 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ęta w przypadku typu „default ”. |
z możliwością zapisu |
Odpowiedź
Jeśli operacja się uda, metoda zwróci zasób listy ACL w treści odpowiedzi.
Przykłady
Uwaga: dostępne dla tej metody przykłady kodu nie odzwierciedlają wszystkich obsługiwanych języków programowania. Listę obsługiwanych języków znajdziesz na stronie z bibliotekami klienta.
Java
Korzysta z biblioteki klienta Java.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.AclRule; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Create access rule with associated scope AclRule rule = new AclRule(); Scope scope = new Scope(); scope.setType("scopeType").setValue("scopeValue"); rule.setScope(scope).setRole("role"); // Insert new access rule AclRule createdRule = service.acl().insert('primary', rule).execute(); System.out.println(createdRule.getId());
Python
Używa biblioteki klienta dla języka Python.
rule = { 'scope': { 'type': 'scopeType', 'value': 'scopeEmail', }, 'role': 'role' } created_rule = service.acl().insert(calendarId='primary', body=rule).execute() print created_rule['id']
PHP
Korzysta z biblioteki klienta PHP.
$rule = new Google_Service_Calendar_AclRule(); $scope = new Google_Service_Calendar_AclRuleScope(); $scope->setType("scopeType"); $scope->setValue("scopeValue"); $rule->setScope($scope); $rule->setRole("role"); $createdRule = $service->acl->insert('primary', $rule); echo $createdRule->getId();
Ruby
Używa biblioteki klienta Ruby.
rule = Google::Apis::CalendarV3::AclRule.new( scope: { type: 'scopeType', value: 'scopeEmail', }, role: 'role' ) result = client.insert_acl('primary', rule) print result.id
Wypróbuj
Użyj Eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź.