Эта страница переведена с помощью Cloud Translation API.

Acl: insert

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

Запрос

HTTP-запрос

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

Параметры

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

Авторизация

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

Объем
`https://www.googleapis.com/auth/calendar`

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

Тело запроса

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

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

// 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 .

rule = {
    'scope': {
        'type': 'scopeType',
        'value': 'scopeEmail',
    },
    'role': 'role'
}

created_rule = service.acl().insert(calendarId='primary', body=rule).execute()

print created_rule['id']

PHP

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

rule = Google::Apis::CalendarV3::AclRule.new(
  scope: {
    type: 'scopeType',
    value: 'scopeEmail',
  },
  role: 'role'
)
result = client.insert_acl('primary', rule)
print result.id

Попробуйте!

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