Этот документ содержит информацию об авторизации и аутентификации, специфичную для API Календаря Google. Прежде чем читать этот документ, обязательно прочтите общую информацию об аутентификации и авторизации Google Workspace в разделе Подробнее об аутентификации и авторизации .
Настройте OAuth 2.0 для авторизации
Настройте экран согласия OAuth и выберите области, чтобы определить, какая информация будет отображаться пользователям и рецензентам приложений, а также зарегистрируйте свое приложение, чтобы можно было опубликовать его позже.
Области API календаря
Чтобы определить уровень доступа, предоставленный вашему приложению, вам необходимо определить и объявить области авторизации . Область авторизации – это строка URI OAuth 2.0, содержащая имя приложения Google Workspace, тип данных, к которым оно обращается, и уровень доступа. Области – это запросы вашего приложения на работу с данными Google Workspace, включая данные аккаунтов Google пользователей.
Когда ваше приложение установлено, пользователю предлагается проверить области, используемые приложением. Как правило, вам следует выбирать максимально узконаправленную область действия и избегать запроса областей, которые не требуются вашему приложению. Пользователи с большей готовностью предоставляют доступ к ограниченным, четко описанным областям.
API календаря поддерживает следующие области:
| Объем | Значение |
|---|---|
https://www.googleapis.com/auth/calendar | Просматривайте, редактируйте, делитесь и безвозвратно удаляйте все календари, к которым вы можете получить доступ с помощью Календаря Google. |
https://www.googleapis.com/auth/calendar.readonly | Просматривайте и загружайте любой календарь, к которому вы можете получить доступ с помощью Календаря. |
https://www.googleapis.com/auth/calendar.freebusy | Просматривайте доступность в своих календарях. |
https://www.googleapis.com/auth/calendar.events | Просматривайте и редактируйте события во всех ваших календарях. |
https://www.googleapis.com/auth/calendar.events.readonly | Просматривайте события во всех ваших календарях. |
https://www.googleapis.com/auth/calendar.settings.readonly | Просмотрите настройки Календаря. |
https://www.googleapis.com/auth/calendar.addons.execute | Запускайте как надстройку Календаря. |
https://www.googleapis.com/auth/calendar.addons.current.event.read | Просматривайте события, которые вы открываете в Календаре Google. |
https://www.googleapis.com/auth/calendar.addons.current.event.write | Редактируйте события, которые вы открываете в Календаре Google. |
https://www.googleapis.com/auth/calendar.events.owned | Просматривайте, создавайте, изменяйте и удаляйте мероприятия в принадлежащих вам календарях Google. |
https://www.googleapis.com/auth/calendar.events.owned.readonly | Просматривайте события в принадлежащих вам календарях Google. |
https://www.googleapis.com/auth/calendar.events.freebusy | Посмотрите наличие мест в календарях Google, к которым у вас есть доступ. |
https://www.googleapis.com/auth/calendar.app.created | Создайте дополнительные календари Google и просматривайте, создавайте, изменяйте и удаляйте в них события. |
https://www.googleapis.com/auth/calendar.calendarlist | Просматривайте, добавляйте и удаляйте календари Google, на которые вы подписаны. |
https://www.googleapis.com/auth/calendar.calendarlist.readonly | Просмотрите список календарей Google, на которые вы подписаны. |
https://www.googleapis.com/auth/calendar.calendars | Просматривайте и изменяйте свойства календарей Google, к которым у вас есть доступ, а также создавайте дополнительные календари. |
https://www.googleapis.com/auth/calendar.calendars.readonly | Просматривайте заголовок, описание, часовой пояс по умолчанию и другие свойства календарей Google, к которым у вас есть доступ. |
https://www.googleapis.com/auth/calendar.acls | Просматривайте и изменяйте разрешения на общий доступ к принадлежащим вам календарям Google. |
https://www.googleapis.com/auth/calendar.acls.readonly | Ознакомьтесь с разрешениями на общий доступ к вашим календарям Google. |
https://www.googleapis.com/auth/calendar.events.public.readonly | Смотрите события в общедоступных календарях. |