Acl: update

Обновляет правило контроля доступа. Попробуйте прямо сейчас или посмотрите пример .

Запрос

HTTP-запрос

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

Параметры

Имя параметра Ценность Описание
Параметры пути
calendarId string Идентификатор календаря. Чтобы получить идентификаторы календаря, вызовите метод calendarList.list . Если вы хотите получить доступ к основному календарю текущего пользователя, вошедшего в систему, используйте ключевое слово « primary ».
ruleId string Идентификатор правила ACL.
Необязательные параметры запроса
sendNotifications boolean Отправлять ли уведомления об изменении общего доступа к календарю. Обратите внимание, что уведомления о закрытии доступа отсутствуют. По желанию. Значение по умолчанию — Истина.

Авторизация

Этот запрос требует авторизации со следующей областью действия:

Сфера
https://www.googleapis.com/auth/calendar

Дополнительные сведения см. на странице аутентификации и авторизации .

Тело запроса

В тексте запроса укажите ресурс Acl со следующими свойствами:

Имя свойства Ценность Описание Заметки
Требуемые свойства
scope object Степень, в которой доступ к календарю предоставляется этим правилом ACL.
scope. type string Тип области. Возможные значения:
  • « default » — общедоступная область. Это значение по умолчанию.
  • « user » — ограничивает область действия одним пользователем.
  • « group » — ограничивает область действия группой.
  • « domain » — ограничивает область действия доменом.
Примечание. Разрешения, предоставленные области « default », или общедоступной, применяются к любому пользователю, прошедшему проверку подлинности или нет.
Дополнительные свойства
role string Роль, назначенная области действия. Возможные значения:
  • " none " - не предоставляет доступ.
  • « freeBusyReader » — предоставляет доступ для чтения к информации о занятости.
  • « reader » — предоставляет доступ для чтения к календарю. Частные события будут отображаться для пользователей с доступом для чтения, но сведения о событиях будут скрыты.
  • « writer » — предоставляет доступ для чтения и записи к календарю. Частные события будут отображаться для пользователей с доступом для записи, а сведения о событиях будут видны.
  • « owner » — предоставляет право собственности на календарь. Эта роль обладает всеми разрешениями роли писателя с дополнительной возможностью просмотра списков ACL и управления ими.
доступный для записи
scope. value string Адрес электронной почты пользователя или группы или имя домена, в зависимости от типа области. Опущен для типа " default ". доступный для записи

Ответ

В случае успеха этот метод возвращает ресурс Acl в теле ответа.

Примеры

Примечание. Примеры кода, доступные для этого метода, не представляют все поддерживаемые языки программирования (список поддерживаемых языков см. на странице клиентских библиотек ).

Ява

Использует клиентскую библиотеку 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 .

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

Использует клиентскую библиотеку PHP .

$rule = $service->acl->get('primary', 'ruleId');
$rule->setRole('newRole');

$updatedRule = $service->acl->update('primary', $rule->getId(), $rule);
echo $updatedRule->getEtag();

Рубин

Использует клиентскую библиотеку Ruby .

rule = client.get_acl('primary', 'ruleId')
rule.role = 'newRole'
result = client.update_acl('primary', rule.id, rule)
print result.etag

Попытайся!

Используйте обозреватель API ниже, чтобы вызвать этот метод для оперативных данных и просмотреть ответ.