# Google-календарь * [Как создать сервисный аккаунт](#kak-sozdat-servisnyi-akkaunt) * [Как загрузить файл ключей](#kak-zagruzit-fail-klyuchei) * [Как найти идентификатор календаря](#kak-naiti-identifikator-kalendarya) * [Как создать новый календарь](#kak-sozdat-novyi-kalendar) * [Как получить информацию о календаре](#kak-poluchit-informaciyu-o-kalendare) * [Как получить список календарей сервисного аккаунта](#kak-poluchit-spisok-kalendarei-servisnogo-akkaunta) * [Как работать с событиями/мероприятиями (Events)](#kak-rabotat-s-sobytiyami-meropriyatiyami-events) ## **Как создать сервисный аккаунт** Для этого необходимо зарегистрировать свой аккаунт в сервисах [Google](https://console.developers.google.com/cloud-resource-manager). Переходим по ссылке и создаем проект: ![](https://lh3.googleusercontent.com/9He2ARNX_3TVno8HVGVBLlnYaJB6pbMVnQHNDi9eXHUn6zJ9jRsLRWobCCn_S7WLr9xZtByTlWUC1a3Cjt7_yXBpINSVZ5bLkpZj5UB4R_9jGXmxvkT5v096yx6JTiqJ631S1_vg) Придумываем название для проекта ![](https://lh6.googleusercontent.com/xCWJa-7Jn5TVBDR39iYwTdqfWy67SA6e0yEuq8TUk5IUyYMDUBBE9rEtwBpvxFNdcElAonAYWRKFB0kYFyK2A9MZGXfddB7iSVEN3cc2GVWCzXPDDowoJapewS7TsuSaQO2g9OYu) ![](https://lh6.googleusercontent.com/P5P5uq5m9w7wfvfyFd7M7n19uJW7vCVuli5pDhv1Y0Lib7v82cDjLTdUzVwqYP0KYu48DSkJQmORqrpBvU6d2olBdPcpHKMyiyTCaRrpVJEnXyfsO7bxa8yM_MCV3fYkAI65M08j) Нажимаем Create и немного ждем, пока создается аккаунт. Перезагружаем страницу. Нажимаем “F5” ![](https://lh4.googleusercontent.com/mBBazgw3WpZtUaLTK5PoB23XyI-KcoKNgj8WYqBtq1uonidT3HmV6kIgnMNPbieRBlbh7vXEPFhQEua2_LoaAYBZGQqV6bQ8ntVlywDCVWtZGHztT6qW2tQ7ZzprTVmkMl7hIxIh) Проверяем права доступа. Должно быть Полное -”Owner” ![](https://lh6.googleusercontent.com/T4lzJAl5iKhs2C2tX_qLX5moikjcByZuv85w0Dl2xZ2MlHPyJk557oLLKkdDG68a6JUsY4tbUpD6aY3eitEewprSAWHEBxEZ1yDN1KK8-gKKJVf4kwBPCCHzoGneftybm9LpbzKm) \ Переходим в настройки сервисного аккаунта ![](https://lh5.googleusercontent.com/4W-_xQYOs2OPmbgpe-B0tYbkAnM7ZXveyMEKiwoel9df90svzx5Aa_7L-ApANlob38yGba_psuk3WQB0eVrFedp6_7ibB-TqfMZ6rgtPGi2yJF7E3mdurKCca90UZ79hz4UMX6zh) Заходим в “Сервисные аккаунты” ![](https://lh4.googleusercontent.com/GN4Q6OPwRWD6XAPZx3m1G_L08D5cAkwBJaOY8Vz5XhKAJy7B3GKKtCY1LSm8JNlVlV4UPcWoLE5MzIMpu9ptkezaoKebca0jMB74AROV6DTDBrxrEsmx4cAqj2_Vriw4C216DUcC) и создаём Сервисный аккаунт ![](https://lh5.googleusercontent.com/wnQwK9s0nUDFuxrr1s8bAFEKCjfb993gaEETgXRzFRMUMLIDrAMcDsz0DXzU1saP1JdMtTYPXmVKMwXg6MDA-hUXh9i9L686y-b3gPq0w1V33Z_BLqu98jVKo8vq5i_CUghp0tfB) Вводим название и почту сервисного аккаунта:
![](https://lh3.googleusercontent.com/ilCYmSuAs6sbZB1CIS1riozZtVAOHJrjEt3YpdXZrfnxS-RonDRW0wAImZ6T4G33sf0qnzzpC8pBmWkG9DE0AjJ0DRR3XoRZGH5I7HNGGXcJy_tVcMNkUjLEDehWTBA9DE1Ie1i-) Далее роль -> owner (Владелец): ![](https://lh3.googleusercontent.com/4nuZbjiK6GX4Xe-eJgobTeVickmnVvqlyQLA5o_3Eo_zPebNoVODCa4SdLkYkof-l8y-nahRjq0m4DK0c6EMLrVgv1w0RCVEx6yJnMHyhmhrGj1mgvp82NhksbCkJmByZRg7UzER) Сохраняем и попадаем в список сервисных аккаунтов. Переходим в настройки ключей и создаем новый: ![](https://lh3.googleusercontent.com/GwWyLE8DWmg1xAJiwEInFYIwk35j3UH5vxrfox4_aNbf92LpFZhfv0h0VApyipcuL098m7e9UYAH1Vo4I1TgYd-QvewE-ElLJYV7sHUGgdOcwYyEJlzHcWvmjGfppZ61gt_7pbT-) ![](https://lh6.googleusercontent.com/9u-qb1KrHS9Ro8To4mPvc96vqhW-c3rh3g-qIxlEo9liodL5EgWv6A7wDt8vJOdml32CZon-X4H5YH5MRiLIpPiNJt9OwtajFjru-4MsmyimRQfcHCtJxEolWPWk2n_KmixqXSx6) ![](https://lh6.googleusercontent.com/3yhTgndzJVlXJAl6CpEZwoErqKrZJtHzQDcEf0k2Bv4J4F7hmBJeTq_LbKpBWQwNufiiXNef-RB6HpZ6FmbYFFIyO70fg3Odcqho3iTvvNtHH2uEKSjbNcTQU5z5B0oASrvdxA_2) Сразу после создания ключ автоматически загрузится на ваш компьютер. Далее его нужно загрузить на хостинг или в конструктор Salebot и передавать ссылку на него в параметрах запросов, передавая полученный URL в параметре **creds\_path.** Теперь надо добавить наше API-интеграции. Для этого заходим сюда.
Находим api календаря и включаем его в этом сервисном аккаунте: ![](https://lh3.googleusercontent.com/bNmvFkn8QtrCsAULqCO-FV18FG9ajyZIEyWjPzyoK8IiX4OHJ2tolKxjJTpHH871rrh2U_hJRrkTQcnV8GrynTn67EKHNXxHAn9iQMKiDFQOCvntpT0OG_FJzIVKzYXeirFRUXlt) ![](https://lh3.googleusercontent.com/urZ90mJoYCTDPj5YrLkHR5nz0vs5aNXHpKlusJXIlUWJBAhF7zViHdcsaF5QRschSNMAJtw7N2CI3L-dQJrreRqjjZJn3Y1WmxEsZJFDHpoIGVfWXSsOoVkWOmZVXsI9JaV-_rep) На этом создание сервисного аккаунта завершено. ## **Как загрузить файл ключей** Переходим в проект и загружаем полученный файл в блок, например**,** вот так: ![](/files/mPBCMIbdCz0zffGjIXUO) Нажимаем "Готово" и переходим в тестового бота: ![](/files/NQ7ZmYcc2O98OtPGuKkr) Вводим фразу, которую задали для входа в блок. В примере это 123. В ответ получаем ссылку на файл с ключами:
![](https://lh5.googleusercontent.com/rjpWTBJNpI7ESyCbpnaBsA9xl3MuCuIK-8GNnsK40c8ftUG7gV1J7nRqMvArhcYdW4nZuVn4tumZ8wF3hLfPfWpBVckgyhDn-rkurRDYsXtF_ITj6Z0M4Pe3tawVaDgCkiDHxL5z) {% hint style="danger" %} Блок удалять нельзя, иначе файл удалится с сервера и нужно будет заново добавлять. {% endhint %} Не забудьте в дальнейшем блок схемы бота выставить как "**Не состояние**", чтобы в дальнейшем не возникла утечка ключа: ![](/files/XwWmAvwrclF4uvHvHwt2) Эту ссылку можно сохранить в переменную или передавать в параметре creds\_path как есть. ## **Как найти идентификатор календаря** Идентификатор существующего календаря можно посмотреть в его настройках: ![](https://lh3.googleusercontent.com/lyFWqw6zKnepsqrzyd46fuvm1gPQPEsA_mDG2391XVCRDALpB5nV2A7IAbTKW3IAfaErRo2PLZtdEpm7NCLDFc87cUDXER0poDewkW0wWkrqL_ssvbZFOffDAoTNDj9cjz851rwu) ## **Как создать новый календарь** Создать новый календарь можно двумя способами: вручную и через функцию (расскажем ниже). Ручное создание календаря: ![](https://lh5.googleusercontent.com/OaY3e0JgQ9HichL50iAZlX0HyXQ3CaYTV04m8qD8DUgsRVc8Fi0iYQoVTVmoDw-znyq5Wg6l-fJdQUt5ZdOV-2jgDbmUh6VUSe5pzwmjktcT3J9AYNLMJil8fK5TKLbTX8T3p2e1) Чтобы можно было добавлять записи и редактировать существующий календарь **(**или созданный вручную), нужно добавить соответствующий доступ сервисному аккаунту. Для этого перейдите в настройки нужного календаря и добавьте email сервисного аккаунта**.** ![](https://lh3.googleusercontent.com/o3LWO7HKJrryeiXVZaR7uCumUcNmcxl6XEOExwjLNGPqy3kuaYD1mBwf8TTBPvfD8eIXQucwKK3BlpGK0rjdBEb5PcA7jSDjiqUy1F2RfQ4Iczo8y6oG_gToFaB_pgfOIdtAW9JF) ### **Как создать календарь с помощью функции** **!**** URL функции:** **!**** Тип запроса**: POST-json {% tabs %} {% tab title="Основные параметры" %} | Параметры | Значение | Примечание | | ------------ | ------------------------------------------------------------------------------------------ | ---------- | | creds\_path | ссылка на ключ доступа сервисного аккаунта к апи календаря (полученный по инструкции выше) | | | command | create | | | name | название календаря | | | description | описание календаря | | | {% endtab %} | | | {% tab title="Дополнительные параметры" %}
ПараметрыОписание параметров
time_zone Часовой пояс календаря. Идентификатор часового пояса IANA. По умолчанию: Europe/Moscow
location географическое положение календаря в виде текста произвольной формы
owner_email

емейл аккаунта, который будет добавлен как владелец календаря.

С помощью данного параметра можно дать доступ другому аккаунту, например, своему основному аккаунту

{% endtab %} {% endtabs %} {% hint style="warning" %} По умолчанию календарь создастся в сервисном аккаунте. Чтобы иметь возможность визуального редактирования календаря из своего аккаунта, передавайте свой email в параметре owner\_email {% endhint %} Пример: {"creds\_path": "", "calendar\_id": "", "command": "update\_event", "event\_id": "v40c3d6j2ibl6vpg2m842538l0", "popup\_minutes": "11","email\_minutes": "22" } **Сохраняемые значения из JSON-ответа:** После успешного выполнения функция вернет следующие параметры, которые можно сохранить: `{'kind': 'calendar#calendar', 'etag': '"WgASl9FY_5zrEmCZvrt4Qlh6tGQ"', 'id': '7e2q3mka5dmfmcohdltfupclj4@group.calendar.google.com', 'summary': 'Название календаря’', 'timeZone': 'UTC'}`\ \ Сохраним id созданного календаря:\ id -> calendar\_id Для тестирования вы можете вывести на экран переменную #{custom\_answer}. Если был передан email (параметр owner\_email), то после успешного запроса необходимо перейти во Входящие и подтвердить добавление календаря в ваш аккаунт: ![](https://lh4.googleusercontent.com/0NFaKJkpCn7T0mlvdM4LxbL-EDPfk4_mBYoTQafCdcTblTg1vgZy_V2PlbnJfV9UKLhk7YmI34ATJNuK4oPEWJO_1eB_Fy7flvCYMxvHyAKvXcy6HjmZEKTlj9PHPvP-ez0IGf-y) ![](https://lh5.googleusercontent.com/fFZP8C_L32DmSxmCYTt-Kx3eVHtL0m5UpDAmof3LmqgCxVPhalkNNtYhtROOqm-z63z8s4g7DxpUwT7UDSlyLyFhfyMfSKVcfH2KtSU7Nvj7Z2JE9XrwoziXHspcKMFD45zuTCMe) ## **Как получить информацию о календаре** **URL функции:** **Тип запроса:** POST-json **Параметры:**
ПараметрыОписание параметра
creds_path ссылка на ключ доступа сервисного аккаунта к апи календаря (полученный по инструкции выше)
commandget_calendar
calendar_idидентификатор календаря
**Сохраняемые значения из JSON-ответа:**\ После успешного выполнения функция вернет следующие параметры, которые можно сохранить. Пример ответа функции: `{'kind': 'calendar#calendar', 'etag': '"6KN4OTLeoqGGu7Nr5uNIQgCGYsU"', 'id': 'rcdd8mimc6gjtasan9ansn8354@group.calendar.google.com', 'summary': 'Название календаря', 'timeZone': 'UTC'}`
## **Как получить список календарей сервисного аккаунта** **URL функции:** **Тип запроса**: POST-json **Параметры**:
ПараметрыЗначение
creds_pathссылка на ключ доступа сервисного аккаунта к апи календаря (полученный по инструкции выше)
commandcalendars_list
**Сохраняемые значения из JSON-ответа:** После успешного выполнения функция вернет следующие параметры, которые можно сохранить. Пример ответа функции: `{`\ `'kind': 'calendar#calendarList',`\ `'etag': '"p32o8pm47rfqf20g"',`\ `'nextSyncToken': 'CLCM2Ifb9PECEi5nc2hlZXRzQGdzaGVldHMtMjU0NzEzLmlhbS5nc2VydmljZWFjY291bnQuY29t',`\ `'items': [`\ `{`\ `'kind': 'calendar#calendarListEntry',`\ `'etag': '"1625235372775000"',`\ `'id': '74u4aogu34hisgvi9v0pjriqho@group.calendar.google.com',`\ `'summary': 'AAAAAAAAaa',`\ `'timeZone': 'Asia/Singapore',`\ `'colorId': '17',`\ `'backgroundColor': '#9a9cff',`\ `'foregroundColor': '#000000',`\ `'selected': True,`\ `'accessRole': 'owner',`\ `'defaultReminders': [`\ `]`\ `},`\ `{`\ `'kind': 'calendar#calendarListEntry',`\ `'etag': '"1625235805096000"',`\ `'id': '5u9q24kdh571mnm667t2d3q16c@group.calendar.google.com',`\ `'summary': 'AAAAAAAAaa',`\ `'timeZone': 'Asia/Singapore',`\ `'colorId': '21',`\ `'backgroundColor': '#cca6ac',`\ `'foregroundColor': '#000000',`\ `'selected': True,`\ `'accessRole': 'owner',`\ `'defaultReminders': [`\ `]`\ `}`\ `]`\ `}` ## **Как работать с событиями/мероприятиями (Events)** ### **Быстрое добавление события (мероприятия)** **URL функции:** **Тип запроса**: POST-json **Параметры:** creds\_path - ссылка на ключ доступа сервисного аккаунта к апи календаря (полученный по инструкции выше)\ command - quick\_add\_event\ calendar\_id - идентификатор календаря\ event\_name - название события Пример параметров: \ `{"creds_path": "https://files.salebot.pro/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json",`\ `"calendar_id": "i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com",`\ `"command": "quick_add_event","event_name": "Супер мероприятие"}`\ \ **Сохраняемые значения из JSON-ответа:** После успешного выполнения функция вернет следующие параметры, которые можно сохранить по своему усмотрению. Для дальнейшего редактирования созданного события рекомендуется сохранить его идентификатор: id -> event\_id Пример ответа функции: `{'kind': 'calendar#event', 'etag': '"3253879667088000"', 'id': 'ljp7a3ocp8oorbov9u2cq221s0', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=bGpwN2Ezb2NwOG9vcmJvdjl1MmNxMjIxczAgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-22T07:43:53.000Z', 'updated': '2021-07-22T07:43:53.544Z', 'creator': {'email': 'gsheets@gsheets-254713.iam.gserviceaccount.com'}, 'organizer': {'email': 'i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com', 'displayName': 'Testov', 'self': True}, 'start': {'dateTime': '2021-07-22T07:43:53Z', 'timeZone': 'UTC'}, 'end': {'dateTime': '2021-07-22T08:43:53Z', 'timeZone': 'UTC'}, 'iCalUID': 'ljp7a3ocp8oorbov9u2cq221s0@google.com', 'sequence': 0, 'reminders': {'useDefault': True}, 'eventType': 'default'}`
![](/files/uXxu4rWqjKavyXy9EJ2I) ### **Как добавить событие (мероприятие)** **URL функции:** **Тип запроса:** POST-json **Параметры:**
ПараметрыЗначение
creds_path ссылка на ключ доступа сервисного аккаунта к апи календаря (полученный по инструкции выше)
commandadd_event
calendar_idидентификатор календаря
event_name название события
Также нужно указать один из вариантов: дату или дату и время.\ Если мероприятие будет проводится весь день, то нужно передать даты: 1. start\_date - дата начала мероприятия в формате дд.мм.гггг (23.07.2021) 2. end\_date - дата завершения мероприятия в формате дд.мм.гггг (24.07.2021) Если мероприятие в определенное время, то нужно передать дату: 1. start\_datetime - дата и время начала мероприятия в формате дд.мм.гггг чч:мм (23.07.2021 12:00) 2. end\_datetime - дата и время завершения мероприятия в формате дд.мм.гггг чч:мм (24.07.2021 13:00) 3. time\_zone - Часовой пояс события. Идентификатор часового пояса IANA. По умолчанию: Europe/Moscow {% hint style="info" %} Если часовой пояс календаря и события разный, то событие добавится со временем в часовом поясе календаря. {% endhint %} **Пример:** Календарь в часовом поясе (чс) Europe/Moscow +3, а событие добавляется с часовым поясом Europe/Berlin +2. Время события 12:00 (чс +2) в календарь добавится на 13:00, так как по московскому времени 13:00 соответствует 12:00 в часовом поясе +2 **Дополнительные параметры:**
ПараметрыЗначениеПримечание
event_description описание события
locationгеографическое положение мероприятия в виде текста произвольной формы
email_minutesвремя в минутах: за сколько до начала события отправить уведомление участникам на емейл
popup_minutesвремя в минутах: за сколько до начала события отправить уведомление участникам во всплывающих уведомлениях.
transparencyблокировка времени в календаре, может принимать два значения "opaque" или "transparent"

"opaque" - значение по умолчанию. Событие блокирует время в календаре. Это эквивалентно настройке Показывать как занятой в пользовательском интерфейсе календаря.

"transparent" — событие не блокирует время в календаре. Это эквивалентно настройке «Показать как доступно» в пользовательском интерфейсе календаря.

recurrence_daysпараметр для задания периодичности события.

Например:

"SU,MO,TU,WE,TH,FR,SA" - событие активно каждую неделю каждый день.

"MO,TU,WE,TH,FR" - событие активно каждую неделю каждый день. кроме субботы и воскресенья

recurrence_until Дата до которой событие должно повторяться (включительно). Указывается в формате: 20240525
recurrence_count количество раз, которое должно повториться это событие
{% hint style="info" %} Параметры recurrence\_count и recurrence\_until одновременно не используются. \ Если переданы оба параметра, будет использован только recurrence\_until {% endhint %} {% tabs %} {% tab title="Пример параметров:" %} Календарь в часовом поясе (чс) Europe/Moscow +3, а событие добавляется с часовым поясом Europe/Berlin +2. Время события 12:00 (чс +2) в календарь добавится на 13:00, так как по московскому времени 13:00 соответствует 12:00 в часовом поясе +2 `{"creds_path": "https://files.salebot.pro/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json",`\ `"calendar_id": "i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com",`\ `"command": "add_event",`\ `"event_name": "Супер мероприятие",`\ `"start_datetime": "27.07.2021 12:00", "end_datetime": "27.07.2021 14:00"}` {% endtab %} {% tab title="Пример параметров с recurrence\_days" %} Создать событие на каждую неделю с 07:00 до 16:00 по понедельникам, вторникам, четвергам и пятницам. Параметры: `{ "creds_path": "https://files.salebot.pro/uploads/message/file/1/calendar-project-320517-c241d9ab0577.json", "calendar_id": "mail@gmail.com", "command": "add_event", "event_name": "Супер мероприятие 23", "start_datetime": "#{current_date} 07:00", "end_datetime": "#{current_date} 16:00", "recurrence_days": "MO,TU,TH,FR" }`
{% endtab %} {% endtabs %} **Сохраняемые значения из JSON-ответа:** После успешного выполнения функция вернет следующие параметры, которые можно сохранить. Для дальнейшего редактирования созданного события рекомендуется сохранить его идентификатор: \ id -> event\_id **Пример ответа функции:**\ `{'kind': 'calendar#event', 'etag': '"3254057128970000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T08:22:53.109Z', 'summary': 'Новое событие44', 'description': 'Descri xbb xhjxkv', 'location': 'city London', 'creator': {'email': 'gsheets@gsheets-254713.iam.gserviceaccount.com'}, 'organizer': {'email': 'i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com', 'displayName': 'Testov', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Moscow'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Moscow'}, 'iCalUID': 'ittr5291ppi7snapn8jbct5krs@google.com', 'sequence': 0, 'attendees': [{'email': 'vasya@gmail.com', 'displayName': 'Vasya', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default'}`
![](/files/h0mTmUMn4Zx6ti8Qqrk3) ### Редактирование события (мероприятия) **URL функции:** **Тип запроса:** POST-json **Параметры обязательные:**
ПараметрыЗначение
creds_path ссылка на ключ доступа сервисного аккаунта к апи календаря (полученный по инструкции выше)
command update_event
calendar_id идентификатор календаря
event_idидентификатор изменяемого события
**Возможные параметры для обновления:**
ПараметрыЗначение
event_name название события
event_description описание события location - географическое положение мероприятия в виде текста произвольной формы
email_minutes время в минутах: за сколько до начала события отправить уведомление участникам на емейл
popup_minutes время в минутах: за сколько до начала события отправить уведомление во всплывающих уведомлениях
Можно передать как один, так и несколько параметров. Если мероприятие будет проводится весь день, то можно передать даты: **start\_date** - дата начала мероприятия в формате дд.мм.гггг (23.07.2021) **end\_date** - дата завершения мероприятия в формате дд.мм.гггг (24.07.2021) Если мероприятие в определенное время, то можно передать дату со временем: **start\_datetime** - дата и время начала мероприятия в формате дд.мм.гггг чч:мм (23.07.2021 12:00) **end\_datetime** - дата и время завершения мероприятия в формате дд.мм.гггг чч:мм (24.07.2021 13:00) **time\_zone** - Часовой пояс события. Идентификатор часового пояса IANA. По умолчанию: Europe/Moscow **transparency** - блокировка времени в календаре, может принимать два значения "opaque" или "transparent": * "**opaque**" - значение по умолчанию. Событие блокирует время в календаре. Это эквивалентно настройке Показывать как занятой в пользовательском интерфейсе календаря. * "**transparent**" — событие не блокирует время в календаре. Это эквивалентно настройке «Показать как доступно» в пользовательском интерфейсе календаря. **recurrence\_days** - параметр для задания периодичности события. Например: "SU,MO,TU,WE,TH,FR,SA" - событие активно каждую неделю каждый день. "MO,TU,WE,TH,FR" - событие активно каждую неделю каждый день. кроме субботы и воскресенья. **Пример параметров:** {% tabs %} {% tab title="Пример параметров: " %} `{"creds_path": "https://files.salebot.pro/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json", "calendar_id": "i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com", "event_id": "j1lcpm4q2p9c0cv705alv3brug", "command": "update_event", "event_name": "Обновленное мероприятие", "start_datetime": "27.07.2021 12:00", "end_datetime": "27.07.2021 14:00","popup_minutes": "11","email_minutes": "22"}` {% endtab %} {% tab title="Пример параметров с recurrence\_days" %} `{ "creds_path": "https://files.salebot.pro/uploads/message/file/30037/calendar-project-320517-c241d9ab0577.json", "calendar_id": "mail@gmail.com", "command": "update_event", "event_id": "v40c3d6j2ibl6vpg2m842538l0", "popup_minutes": "11","email_minutes": "22", "recurrence_days": "MO,TU,FR" }` {% endtab %} {% endtabs %} **Сохраняемые значения из JSON-ответа:** После успешного выполнения функция вернет следующие параметры, которые можно сохранить. **Пример ответа функции:** `{"kind":"calendar#event","etag":""3276713558524000"","id":"j1lcpm4q2p9c0cv705alv3brug","status":"confirmed","htmlLink":"https://www.google.com/calendar/event?eid=ajFsY3BtNHEycDljMGN2NzA1YWx2M2JydWcgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw","created":"2021-12-01T10:40:11.000Z","updated":"2021-12-01T10:43:16.738Z","summary":"Супер","creator":{"email":"gsheets@gsheets-254713.iam.gserviceaccount.com"},"organizer":{"email":"i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com","displayName":"Testov","self":true},"start":{"dateTime":"2021-12-28T09:00:00Z","timeZone":"Europe/Moscow"},"end":{"dateTime":"2021-12-29T11:00:00Z","timeZone":"Europe/Moscow"},"iCalUID":"j1lcpm4q2p9c0cv705alv3brug@google.com","sequence":0,"reminders":{"useDefault":false,"overrides":[{"method":"email","minutes":22},{"method":"popup","minutes":12}]},"eventType":"default","update_status":"ok"}` ### **Получить список событий (мероприятий)** **URL функции:** **Тип запроса:** POST-json **Параметры**: {% tabs %} {% tab title="Основные параметры" %} | Параметры | Значение | | ------------ | ------------------------------------------------------------------------------------------ | | creds\_path | ссылка на ключ доступа сервисного аккаунта к апи календаря (полученный по инструкции выше) | | command | get\_event\_list | | calendar\_id | идентификатор календаря | | {% endtab %} | | {% tab title="Дополнительные параметры" %}
ЗначениеОписание
start_date дата от которой искать события в формате дд.мм.гггг (23.07.2021)
end_date дата до которой искать события в формате дд.мм.гггг (24.07.2021)
Если не передавать дополнительные события, то результатом будет список событий за сегодняшний день. {% endtab %} {% endtabs %} Пример параметров:\ Будут найдены события за 23 июля `{"creds_path": "https://files.salebot.pro/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json",`\ `"calendar_id": "i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com",`\ `"command": "get_event_list",`\ `"start_date": "22.07.2021", "end_date": "23.07.2021"}` **Сохраняемые значения из JSON-ответа:** После успешного выполнения функция вернет следующие параметры, которые можно сохранить. Список найденных событий можно сохранить в переменную: items -> event\_list Пример ответа функции: `{'kind': 'calendar#events', 'etag': '"p33odnesrinsv20g"', 'summary': 'Testov', 'description': 'Testov description', 'updated': '2021-07-23T12:13:05.686Z', 'timeZone': 'UTC', 'accessRole': 'owner', 'defaultReminders': [], 'items': [{'kind': 'calendar#event', 'etag': '"3254084771372000"', 'id': '6d8rocb9e2r21ue37jgsa0v06i', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=NmQ4cm9jYjllMnIyMXVlMzdqZ3NhMHYwNmkgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T12:11:13.000Z', 'updated': '2021-07-23T12:13:05.686Z', 'summary': 'DDDDDDDDD', 'creator': {'email': 'adnimdd@gmail.com'}, 'organizer': {'email': 'i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com', 'displayName': 'Testov', 'self': True}, 'start': {'date': '2021-07-20'}, 'end': {'date': '2021-07-21'}, 'transparency': 'transparent', 'iCalUID': '6d8rocb9e2r21ue37jgsa0v06i@google.com', 'sequence': 0, 'reminders': {'useDefault': False}, 'eventType': 'default'}]}` ### **Как переместить события в другой календарь** **URL функции:** **Тип запроса**: POST-json **Параметры**:
ОписаниеЗначение
creds_pathссылка на ключ доступа сервисного аккаунта к апи календаря (полученный по инструкции выше)
commandmove_event
calendar_idидентификатор календаря, из которого перемещается событие
event_id идентификатор события
destination_calendar_idидентификатор календаря, в который перемещается событие
**Сохраняемые значения из JSON-ответа:** После успешного выполнения функция вернет следующие параметры, которые можно сохранить. Пример ответа функции: `{'kind': 'calendar#event', 'etag': '"3253880350568000"', 'id': 'ljp7a3ocp8oorbov9u2cq221s0', 'status': 'cancelled', 'htmlLink': 'https://www.google.com/calendar/event?eid=bGpwN2Ezb2NwOG9vcmJvdjl1MmNxMjIxczAgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-22T07:43:53.000Z', 'updated': '2021-07-22T07:49:35.284Z', 'creator': {'email': 'gsheets@gsheets-254713.iam.gserviceaccount.com'}, 'organizer': {'email': '88q8fvkrv5ue7orsh109t6o60s@group.calendar.google.com', 'displayName': 'Тестовый календарь'}, 'start': {'dateTime': '2021-07-22T07:43:53Z', 'timeZone': 'UTC'}, 'end': {'dateTime': '2021-07-22T08:43:53Z', 'timeZone': 'UTC'}, 'iCalUID': 'ljp7a3ocp8oorbov9u2cq221s0@google.com', 'sequence': 0, 'reminders': {'useDefault': True}, 'eventType': 'default'}` ### **Как получить информацию о мероприятии** **URL функции:** **Тип запроса**: POST-json **Параметры**:
ПараметрыЗначение
creds_path ссылка на ключ доступа сервисного аккаунта к апи календаря (полученный по инструкции выше)
command get_event
calendar_id идентификатор календаря
event_id идентификатор события
**Сохраняемые значения из JSON-ответа:** После успешного выполнения функция вернет следующие параметры, которые можно сохранить. Пример ответа функции: `{'kind': 'calendar#event', 'etag': '"3254067331414000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T11:12:55.553Z', 'summary': 'Новое событие44', 'description': 'Descri xbb xhjxkv', 'location': 'city London', 'creator': {'email': 'gsheets@gsheets-254713.iam.gserviceaccount.com'}, 'organizer': {'email': 'i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com', 'displayName': 'Testov', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Moscow'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Moscow'}, 'iCalUID': 'ittr5291ppi7snapn8jbct5krs@google.com', 'sequence': 0, 'attendees': [{'email': 'adnimdd@gmail.com', 'displayName': 'Vasya', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default'}` ### **Как удалить мероприятие** **URL функции:** **Тип запроса**: POST-json **Параметры**:
creds_path ссылка на ключ доступа сервисного аккаунта к апи календаря (полученный по инструкции выше)
command remove_event
calendar_idидентификатор календаря
event_idидентификатор удаляемого события
Сохраняемые значения из JSON-ответа: После успешного выполнения функция вернет следующие параметры, которые можно сохранить. Пример ответа функции: `{'status': 'ok'}` ### **Как добавить участника мероприятия** **URL функции**: **Тип запроса:** POST-json **Параметры:** {% tabs %} {% tab title="Основные параметры" %} | Параметры | Значение | | ------------- | ------------------------------------------------------------------------------------------ | | creds\_path | ссылка на ключ доступа сервисного аккаунта к апи календаря (полученный по инструкции выше) | | command | add\_client | | calendar\_id | идентификатор календаря | | event\_id | идентификатор события | | client\_email | электронная почта клиента | {% endtab %} {% tab title="Дополнительные параметры" %}
ПараметрыЗначение
name описание события
commentкомментарий участника
{% endtab %} {% endtabs %} Пример параметров: `{`\ `"creds_path": "https://files.salebot.pro/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json",`\ `"calendar_id": "i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com",`\ `"command": "add_client",`\ `"event_id": "#{event_id}",`\ `"client_email": "asdc@mail.com",`\ `"name": "Viktor",`\ `"comment": "Буду первым!"`\ `}`
![](/files/SpIE82AvSIJMVgnEovsv) ![](https://lh6.googleusercontent.com/CENtXVp95s2yZrE_EcGzrkYPbvke8n_hYhsofK47WkUZ2eheeJoFCWmKPsLW-4DUJq5x-SC-0eMDUyftWBs4aCRXKTolbI3RKilaHw-1rPQgxEBSdUwP_PrHZo67Zi1Jw2JPcQEY) **Сохраняемые значения из JSON-ответа:** Функция всегда возвращает статус добавления add\_status. Он может иметь три значения: ok - клиент добавлен\ exist - клиент уже записан\ error - ошибка добавления. (Дополнительно с add\_status, будет параметр error\_message с текстом ошибки) Пример ответа функции при успехе: `{'kind': 'calendar#event', 'etag': '"3254059247409000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T08:58:11.548Z', 'summary': 'Новое событие44', 'description': 'Descri xbb xhjxkv', 'location': 'city London', 'creator': {'email': 'gsheets@gsheets-254713.iam.gserviceaccount.com'}, 'organizer': {'email': 'i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com', 'displayName': 'Testov', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Moscow'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Moscow'}, 'iCalUID': 'ittr5291ppi7snapn8jbct5krs@google.com', 'sequence': 0, 'attendees': [{'email': 'adnimdd@gmail.com', 'displayName': 'Vasya', 'responseStatus': 'needsAction'}, {'email': 'adnimd@gmail.com', 'displayName': 'Vasya', 'responseStatus': 'needsAction'}, {'email': 'adnidgmd@gmail.com', 'displayName': 'Vasya2', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default', ‘add_status’: 'ok'}` ### **Как удалить участника мероприятия** **URL функции**: **Тип запроса:** POST-json **Параметры:**
ПараметрыЗначение
creds_pathссылка на ключ доступа сервисного аккаунта к апи календаря (полученный по инструкции выше)
commandremove_client
calendar_id идентификатор календаря
event_idидентификатор события
client_emailэлектронная почта клиента
**Пример параметров:** `{`\ `"creds_path": "https://files.salebot.pro/uploads/message/file/30037/calendar-project-320517-c241d9ab0565.json",`\ `"calendar_id": "i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com",`\ `"command": "remove_client",`\ `"event_id": "#{event_id}",`\ `"client_email": "asdc@mail.com"`\ `}` **Сохраняемые значения из JSON-ответа:** Функция всегда возвращает статус добавления remove\_status. Он может иметь три значения:\ 1 - клиент успешно удален\ 0 - клиент не найден\ error - ошибка удаления. (Дополнительно с remove\_status, будет параметр error\_message с текстом ошибки) Пример ответа функции при успехе: `{'kind': 'calendar#event', 'etag': '"3254059247409000"', 'id': 'ittr5291ppi7snapn8jbct5krs', 'status': 'confirmed', 'htmlLink': 'https://www.google.com/calendar/event?eid=aXR0cjUyOTFwcGk3c25hcG44amJjdDVrcnMgaTlzdmVydHN0dm9vMmZxMW8waThjbjM5YThAZw', 'created': '2021-07-23T08:22:35.000Z', 'updated': '2021-07-23T08:58:11.548Z', 'summary': 'Новое событие44', 'description': 'Descri xbb xhjxkv', 'location': 'city London', 'creator': {'email': 'gsheets@gsheets-254713.iam.gserviceaccount.com'}, 'organizer': {'email': 'i9svertstvoo2fq1o0i8cn39a8@group.calendar.google.com', 'displayName': 'Testov', 'self': True}, 'start': {'dateTime': '2021-07-23T13:30:00Z', 'timeZone': 'Europe/Moscow'}, 'end': {'dateTime': '2021-07-23T14:00:00Z', 'timeZone': 'Europe/Moscow'}, 'iCalUID': 'ittr5291ppi7snapn8jbct5krs@google.com', 'sequence': 0, 'attendees': [{'email': 'adnimdd@gmail.com', 'displayName': 'Vasya', 'responseStatus': 'needsAction'}, {'email': 'adnimd@gmail.com', 'displayName': 'Vasya', 'responseStatus': 'needsAction'}, {'email': 'adnidgmd@gmail.com', 'displayName': 'Vasya2', 'responseStatus': 'needsAction'}], 'reminders': {'useDefault': False, 'overrides': [{'method': 'email', 'minutes': 10}, {'method': 'popup', 'minutes': 10}]}, 'eventType': 'default', 'remove_status': '1'}`\
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.salebot.pro/integration/google/google-kalendar.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.