Acl: update

Aktualizuje regułę kontroli dostępu. Wypróbuj lub zobacz przykład.

Żą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 obecnie zalogowanego użytkownika, użyj narzędzia „primary” słowa kluczowego.
ruleId string Identyfikator reguły ACL.
Opcjonalne parametry zapytania
sendNotifications boolean Określa, czy wysyłać powiadomienia o zmianie w udostępnianiu kalendarza. Pamiętaj, że nie ma powiadomień o usunięciu dostępu. Opcjonalnie: Wartość domyślna to Prawda.

Autoryzacja

To żądanie wymaga autoryzacji w tym zakresie:

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

Więcej informacji znajdziesz na stronie dotyczącej uwierzytelniania i autoryzacji.

Treść żądania

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

Nazwa usługi Wartość Opis Uwagi
Właściwości wymagane
scope object Zakres, w jakim dostęp do kalendarza jest przyznawany przez tę regułę ACL.
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” (publicznemu) dotyczą każdego użytkownika, zarówno uwierzytelnionego, jak i nieuwierzytelnionego.
Właściwości opcjonalne
role string Rola przypisana do zakresu. Możliwe wartości:
  • „none” – Nie umożliwia dostępu.
  • „freeBusyReader” - Zapewnia dostęp w trybie odczytu do informacji o stanie Wolny/Zajęty.
  • „reader” – Zapewnia uprawnienia do odczytu kalendarza. Wydarzenia prywatne będą wyświetlane użytkownikom z uprawnieniami do odczytu, ale ich szczegóły będą ukryte.
  • „writer” – Zapewnia uprawnienia do odczytu i zapisu kalendarza. Wydarzenia prywatne będą się wyświetlać użytkownikom z uprawnieniami do zapisu oraz będą widoczne szczegóły wydarzeń.
  • „owner” – Udostępnia prawo własności do kalendarza. Ta rola obejmuje wszystkie uprawnienia zapisującego oraz dodatkowe możliwości wyświetlania list kontroli dostępu i manipulowania nimi.
 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, 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

Używa 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 w Pythonie.

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

Używa 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 poniższego eksploratora interfejsów API, aby wywołać tę metodę na bieżących danych i wyświetlić odpowiedź.