Aktualizuje regułę kontroli dostępu. Wypróbuj lub zobacz przykład.
Prośba
Żą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 ACL. |
Opcjonalne parametry zapytania | ||
sendNotifications |
boolean |
Określa, czy powiadomienia o zmianie w udostępnianiu kalendarza mają być wysyłane. Pamiętaj, że nie ma powiadomień o usunięciu dostępu. 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 | |||
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 | |||
role |
string |
Rola przypisana do zakresu. Możliwe wartości:
|
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ę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(); // Retrieve the access rule from the API AclRule rule = service.acl().get('primary', "ruleId").execute(); // Make a change rule.setRole("newRole"); // Update the access rule AclRule updatedRule = service.acl().update('primary', rule.getId(), rule).execute(); System.out.println(updatedRule.getEtag());
Python
Używa biblioteki klienta dla języka Python.
rule = service.acl().get(calendarId='primary', ruleId='ruleId').execute() rule['role'] = 'newRole' updated_rule = service.acl().update(calendarId='primary', ruleId=rule['id'], body=rule).execute() print updated_rule['etag']
PHP
Korzysta z biblioteki klienta PHP.
$rule = $service->acl->get('primary', 'ruleId'); $rule->setRole('newRole'); $updatedRule = $service->acl->update('primary', $rule->getId(), $rule); echo $updatedRule->getEtag();
Ruby
Używa biblioteki klienta Ruby.
rule = client.get_acl('primary', 'ruleId') rule.role = 'newRole' result = client.update_acl('primary', rule.id, rule) print result.etag
Wypróbuj
Użyj Eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź.