diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000000..618989f99f --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,104 @@ +# Changelog + +Все изменения данного проекта будут задокументированы в этом файле. + +Формат основан на [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +проект придерживается [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +## [1.2.1] - 18-02-2024 + +### Добавлено + +- Методы работы с товарами + - Получить список категорий товаров + - Получить список товаров группы + - Получить товары по ID + - Добавить товар + - Изменить товар + - Удалить товар + - Сгруппировать товары +- Методы работы с подборками товаров + - Получить список подборок + - Получить подборки по ID + - Добавить подборку + - Удалить товар из подборки + - Удалить подборку +- Работа со свойствами товаров + - Получить список свойств + - Создать универсальное свойство товара + - Изменить универсальное свойство товара + - Удалить универсальное свойство товара + - Создать вариант значения свойства + - Изменить вариант значения свойства + - Удалить вариант значения свойства +- Unit тесты для библиотеки работы с VK + +### Исправлено + +- Деффекты SonarQube по всем библиотекам + + + +## [1.2.0] - 11-02-2024 + +### Добавлено + +- Функции для работы с файлами и папками + - Получить информацию о диске + - Получить список файлов диска + - Создать папку + - Загрузить файл (из Двоичных данных или по пути к файлу) + - Загрузить файл по URL на диск + - Получить информацию об объекте по его пути на Диске + - Создать копию объекта + - Переместить объект + - Удалить объект + - Получить ссылку на скачивание +- Функции для работы с объектами в публичном доступе + - Опубликовать объект в публичный доступ + - Получить информацию о публичном объекте по URL + - Получить ссылку для скачивания публичного объекта + - Сохранить публичный объект на свой диск Диск + - Получить список своих публичных объектов + - Отменить публикацию объекта + +### Изменено + +- Unit тесты для Yadex Disk и Telegram на замену ручному тестированию + + +## [1.1.0] - 29-01-2024 + +### Добавлено + +- Работа с базами данных + - Создание базы данных + - Получение информации о базе данных + - Изменение свойств базы данных +- Работа со страницами + - Создание страниц: дочерних другой странице и в базу данных + - Получение информации о странице + - Изменение свойств страницы +- Работа с блоками + - Создание блока + - Удаление блока + - Получение блока + - Получение списка дочерних блоков +- Работа с пользователями + - Получение списка пользователей рабочего пространства + - Получение информации о пользователе по ID + +### Исправлено + +- Деффекты SonarQube по всем библиотекам + + +## [1.0.0] - 14-01-2024 + +### Добавлено + +- Библиотека [TelegramEnterprise](https://github.com/Bayselonarrend/TelegramEnterprise/) для работы с Telegram +- Библиотека [VKEnterprise](https://github.com/Bayselonarrend/VKEnterprise/) для работы с VK +- Библиотека [ViberEnterprise](https://github.com/Bayselonarrend/ViberEnterprise/) для работы с Viber +- Новая библиотека для работы с Twitter +- Документация Docusaurus diff --git a/docs/docs/Google_Calendar/Google_Calendar.md b/docs/docs/Google_Calendar/Google_Calendar.md index f38966538b..c1625155d7 100644 --- a/docs/docs/Google_Calendar/Google_Calendar.md +++ b/docs/docs/Google_Calendar/Google_Calendar.md @@ -10,7 +10,7 @@ id: GoogleCalendar ## Начало работы -Для начала работы необходимо получить токен доступа Google: +### Создание проекта 1. Перейдите на [главную страницу Google Cloud](https://console.cloud.google.com) и создайте проект @@ -36,27 +36,42 @@ id: GoogleCalendar ![BF](../../static/img/Docs/GoogleCalendar/6.png) -7. В боковом меню выберите пункт Credentials -> Create Credentials -> OAuth client ID + +### Настройка OAuth + +1. В боковом меню выберите пункт Credentials -> Create Credentials -> OAuth client ID ![BF](../../static/img/Docs/GoogleCalendar/7.png) -8. Введите имя и выберите Application type - Desktop app +2. Введите имя и выберите Application type - Desktop app ![BF](../../static/img/Docs/GoogleCalendar/8.png) -9. Сохраните ClientID и Client Secret +3. Сохраните ClientID и Client Secret ![BF](../../static/img/Docs/GoogleCalendar/9.png) -10. Передайте ClientID в функцию OPI_GoogleWorkspace.СформироватьСсылкуПолученияКода(ClientID). Результатом функции будет URL, который необходимо открыть в браузере. Авторизуйтесь при помощи своего аккаунта Google + +### Включение сервиса Google Calendar + +1. Перейдите на [страницу Календаря в Marketplace](https://console.cloud.google.com/marketplace/product/google/calendar-json.googleapis.com) + +2. Нажмите Enable + +![BF](../../static/img/Docs/GoogleCalendar/12.png) + + +### Получение Токена + +1. Передайте ClientID в функцию OPI_GoogleWorkspace.СформироватьСсылкуПолученияКода(ClientID). Результатом функции будет URL, который необходимо открыть в браузере. Авторизуйтесь при помощи своего аккаунта Google ![BF](../../static/img/Docs/GoogleCalendar/10.png) -11. Скопируйте код из URL после авторизации +2. Скопируйте код из URL после авторизации ![BF](../../static/img/Docs/GoogleCalendar/11.png) -12. Используйте полученный код, ClientID и Client Secret для вызова функции OPI_GoogleWorkspace.ПолучитьТокенПоКоду(ClientID, ClientSecret, Code) +3. Используйте полученный код, ClientID и Client Secret для вызова функции OPI_GoogleWorkspace.ПолучитьТокенПоКоду(ClientID, ClientSecret, Code) ```json title="Результат функции ПолучитьТокенПоКоду(), если перевести его в JSON" @@ -70,4 +85,4 @@ id: GoogleCalendar ``` -13. Используйте **access_token** для передачи в качестве параметра Токен при вызове функций библиотеки, а refresh_token - для получения нового access_token (функция OPI_GoogleWorkspace.ОбновитьТокен(ClientID, ClientSecret, RefreshToken)), когда время жизни старого истечет. При обновлении токена refresh_token не обновляется - вы можете использовать его один и тот же для получения нового access_token каждый раз. +4. Используйте **access_token** для передачи в качестве параметра Токен при вызове функций библиотеки, а refresh_token - для получения нового access_token (функция OPI_GoogleWorkspace.ОбновитьТокен(ClientID, ClientSecret, RefreshToken)), когда время жизни старого истечет. При обновлении токена refresh_token не обновляется - вы можете использовать его один и тот же для получения нового access_token каждый раз. diff --git a/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Izmenit-dannye-kalendarya.md b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Izmenit-dannye-kalendarya.md new file mode 100644 index 0000000000..c6a482b6b7 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Izmenit-dannye-kalendarya.md @@ -0,0 +1,46 @@ +--- +sidebar_position: 2 +--- + +# Изменить метаданные календаря +Изменяет поля метаданных календаря + +*Функция ИзменитьМетаданныеКалендаря(Знач Токен, Знач Календарь, Знач Наименование = "", Знач Описание = "") Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + | Календарь | Строка | ID календаря для изменения | + | Наименование | Строка (необяз.) | Новое наименование календаря | + | Описание | Строка (необяз.) | Новое описание календаря | + + Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Google + +```bsl title="Пример кода" + + Наименование = "Тестовый календарь (изм.)"; + Описание = "Тестовое описание"; + Ответ = OPI_GoogleCalendar.ИзменитьМетаданныеКалендаря(Токен, "55868c32be16935f0...", Наименование, Описание); //Соответствие + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка + +``` + +![Результат](img/2.png) + +```json title="Результат" + +{ + "conferenceProperties": { + "allowedConferenceSolutionTypes": [ + "hangoutsMeet" + ] + }, + "description": "Тестовое описание", + "summary": "Тестовый календарь (изм.)", + "timeZone": "UTC", + "id": "75b64bec8700a640b004af3491867ac5e479884794f529699da23e7009f7d691@group.calendar.google.com", + "etag": "\"x8eLqpmgoxpEDEXmEbsZxxgmJhc\"", + "kind": "calendar#calendar" +} + +``` diff --git a/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Ochistit-kalendar.md b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Ochistit-kalendar.md new file mode 100644 index 0000000000..2a4367f2c8 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Ochistit-kalendar.md @@ -0,0 +1,26 @@ +--- +sidebar_position: 5 +--- + +# Очистить основной календарь +Удаляет все события основного календаря (так как его, в отличии от остальных, нельзя удалить) + +*Функция ОчиститьОсновнойКалендарь(Знач Токен) Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + + Вовзращаемое значение: Пустая строка + +```bsl title="Пример кода" + + Ответ = OPI_GoogleCalendar.ОчиститьОсновнойКалендарь(Токен); + +``` + +```json title="Результат" + +"" + +``` diff --git a/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Poluchit-metadannye-kalendarya.md b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Poluchit-metadannye-kalendarya.md new file mode 100644 index 0000000000..7346ea7c15 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Poluchit-metadannye-kalendarya.md @@ -0,0 +1,40 @@ +--- +sidebar_position: 3 +--- + +# Получить метаданные календаря +Получает метаданные календаря по ID + +*Функция ПолучитьМетаданныеКалендаря(Знач Токен, Знач Календарь) Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + | Календарь | Строка | ID календаря | + + Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Google + +```bsl title="Пример кода" + + Ответ = OPI_GoogleCalendar.ПолучитьМетаданныеКалендаря(Токен, "55868c32be16935f0..."); //Соответствие + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка + +``` + +```json title="Результат" + +{ + "conferenceProperties": { + "allowedConferenceSolutionTypes": [ + "hangoutsMeet" + ] + }, + "description": "Тестовое описание", + "summary": "Тестовый календарь (изм.)", + "timeZone": "UTC", + "id": "155868c32be26e4c4123a107810d40b929b516935f080e4747261fdc3416227c@group.calendar.google.com", + "etag": "\"4A10_PI6FFY129ggELzZ8veUU-U\"", + "kind": "calendar#calendar" +} + +``` diff --git a/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Sozdat-kalendar.md b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Sozdat-kalendar.md new file mode 100644 index 0000000000..0326a391a9 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Sozdat-kalendar.md @@ -0,0 +1,41 @@ +--- +sidebar_position: 1 +--- + +# Создать календарь +Создает новый календарь + +*Функция СоздатьКалендарь(Знач Токен, Знач Наименование) Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + | Наименование | Строка | Наименование создаваемого календаря | + + Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Google + +```bsl title="Пример кода" + + Ответ = OPI_GoogleCalendar.СоздатьКалендарь(Токен, "Тестовый календарь"); //Соответствие + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка + +``` + +![Результат](img/1.png) + +```json title="Результат" + +{ + "conferenceProperties": { + "allowedConferenceSolutionTypes": [ + "hangoutsMeet" + ] + }, + "summary": "Тестовый календарь", + "timeZone": "UTC", + "id": "75b64bec8700a640b004af3491867ac5e479884794f529699da23e7009f7d691@group.calendar.google.com", + "etag": "\"ZlOrbHnYjwJB0APkTQupgFm7F3s\"", + "kind": "calendar#calendar" +} + +``` diff --git a/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Udalit-kalendar.md b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Udalit-kalendar.md new file mode 100644 index 0000000000..d13f0605ff --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/Udalit-kalendar.md @@ -0,0 +1,27 @@ +--- +sidebar_position: 4 +--- + +# Удалить календарь +Удаляет созданный ранее календарь + +*Функция УдалитьКалендарь(Знач Токен, Знач Календарь) Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + | Календарь | Строка | ID календаря для удаления | + + Вовзращаемое значение: Пустая строка + +```bsl title="Пример кода" + + Ответ = OPI_GoogleCalendar.УдалитьКалендарь(Токен, "55868c32be16935f0..."); + +``` + +```json title="Результат" + +"" + +``` diff --git a/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/_category_.json b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/_category_.json new file mode 100644 index 0000000000..1517ea8ffe --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "Работа с метаданными календарей", + "position": 1, +} diff --git a/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/img/1.png b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/img/1.png new file mode 100644 index 0000000000..7ff06d751f Binary files /dev/null and b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/img/1.png differ diff --git a/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/img/2.png b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/img/2.png new file mode 100644 index 0000000000..fb7bd2133c Binary files /dev/null and b/docs/docs/Google_Calendar/Rabota-s-metadannymi-kalendarey/img/2.png differ diff --git a/docs/docs/Google_Calendar/Rabota-s-sobytiyami/Poluchit-opisanye-sobytiya.md b/docs/docs/Google_Calendar/Rabota-s-sobytiyami/Poluchit-opisanye-sobytiya.md new file mode 100644 index 0000000000..14a86aefa7 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-s-sobytiyami/Poluchit-opisanye-sobytiya.md @@ -0,0 +1,24 @@ +--- +sidebar_position: 1 +--- + +# Получить описание события +Возвращает пустой макет заполнения информации о событии + +*Функция ПолучитьОписаниеСобытия() Экспорт* + + Вовзращаемое значение: Соответствие - макет товара + +```json title="Метод" + + СоответствиеСобытия = Новый Соответствие; + СоответствиеСобытия.Вставить("Описание" , ""); // Описание события + СоответствиеСобытия.Вставить("Заголовок" , "Новое событие"); // Заголовок события + СоответствиеСобытия.Вставить("МестоПроведения" , ""); // Строка описание места проведения + СоответствиеСобытия.Вставить("ДатаНачала" , ТекущаяДатаСеанса()); // Дата начала события + СоответствиеСобытия.Вставить("ДатаОкончания" , СоответствиеСобытия["ДатаНачала"] + 3600); // Дата окончания события + СоответствиеСобытия.Вставить("МассивURLФайловВложений" , Новый Соответствие); // Ключ - название, Значение - URL к файлу + СоответствиеСобытия.Вставить("ОтправлятьУведомления" , Истина); // Признак отправки уведомлений участникам + + +``` diff --git a/docs/docs/Google_Calendar/Rabota-s-sobytiyami/Poluchit-sobytie.md b/docs/docs/Google_Calendar/Rabota-s-sobytiyami/Poluchit-sobytie.md new file mode 100644 index 0000000000..0368d911e9 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-s-sobytiyami/Poluchit-sobytie.md @@ -0,0 +1,74 @@ +--- +sidebar_position: 3 +--- + +# Получить событие +Получает информацию о событии календаря по ID + +*Функция ПолучитьСобытие(Знач Токен, Знач Календарь, Знач Событие) Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + | Календарь | Строка | ID календаря | + | Событие | Строка | ID события | + + Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Google + +```bsl title="Пример кода" + + Ответ = OPI_GoogleCalendar.ПолучитьСобытие(Токен, "55868c32be16935f0...", "j4nonfcc0m2..."); //Соответствие + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка + +``` + +```json title="Результат" + +{ + "eventType": "default", + "attachments": [ + { + "iconLink": "", + "title": "Картинка2", + "fileUrl": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/Media/logo.png?v1" + }, + { + "iconLink": "", + "title": "Картинка1", + "fileUrl": "https://opi.neocities.org/assets/images/logo_long-e8fdcca6ff8b32e679ea49a1ccdd3eac.png" + } + ], + "reminders": { + "useDefault": true + }, + "sequence": 0, + "start": { + "timeZone": "Europe/Minsk", + "dateTime": "2024-02-21T15:16:25+03:00" + }, + "creator": { + "self": true, + "email": "bayselonarrend@gmail.com" + }, + "end": { + "timeZone": "Europe/Minsk", + "dateTime": "2024-02-21T16:16:25+03:00" + }, + "iCalUID": "j4nonfcc0m2mtop1vc8ivo8tb8@google.com", + "description": "Описание тестового события", + "updated": "2024-02-21T09:16:28.474Z", + "created": "2024-02-21T09:16:28.000Z", + "htmlLink": "https://www.google.com/calendar/event?eid=ajRub25mY2MwbTJtdG9wMXZjOGl2bzh0YjggYmF5c2Vsb25hcnJlbmRAbQ", + "location": "В оффисе", + "summary": "Новое событие", + "organizer": { + "self": true, + "email": "bayselonarrend@gmail.com" + }, + "status": "confirmed", + "id": "j4nonfcc0m2mtop1vc8ivo8tb8", + "etag": "\"3417013976948000\"", + "kind": "calendar#event" +} + +``` diff --git a/docs/docs/Google_Calendar/Rabota-s-sobytiyami/Poluchit-spisok-sobytiy.md b/docs/docs/Google_Calendar/Rabota-s-sobytiyami/Poluchit-spisok-sobytiy.md new file mode 100644 index 0000000000..edb66ba53b --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-s-sobytiyami/Poluchit-spisok-sobytiy.md @@ -0,0 +1,77 @@ +--- +sidebar_position: 2 +--- + +# Получить список событий +Получает список соыбтий календаря + +*Функция ПолучитьСписокСобытий(Знач Токен, Знач Календарь) Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + | Календарь | Строка | ID календаря | + + Вовзращаемое значение: Массив из Соответствие - массив данных событий + +```bsl title="Пример кода" + + Ответ = OPI_GoogleCalendar.ПолучитьСписокСобытий(Токен, "55868c32be16935f0..."); + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); + +``` + +```json title="Результат" + +[ + + { + "eventType": "default", + "attachments": [ + { + "iconLink": "", + "title": "", + "fileUrl": "https://opi.neocities.org/assets/images/logo_long-e8fdcca6ff8b32e679ea49a1ccdd3eac.png" + }, + { + "iconLink": "", + "title": "", + "fileUrl": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/Media/logo.png?v1" + } + ], + "reminders": { + "useDefault": true + }, + "sequence": 0, + "start": { + "timeZone": "Europe/Minsk", + "dateTime": "2024-02-20T05:31:12+03:00" + }, + "creator": { + "self": true, + "email": "bayselonarrend@gmail.com" + }, + "end": { + "timeZone": "Europe/Minsk", + "dateTime": "2024-02-20T06:31:12+03:00" + }, + "iCalUID": "o6dt8kbedrmu15o53pgbrrv35o@google.com", + "description": "Описание тестового события", + "updated": "2024-02-20T11:31:13.044Z", + "created": "2024-02-20T11:31:13.000Z", + "htmlLink": "https://www.google.com/calendar/event?eid=bzZkdDhrYmVkcm11MTVvNTNwZ2JycnYzNW8gYmF5c2Vsb25hcnJlbmRAbQ", + "location": "В оффисе", + "summary": "Новое событие", + "organizer": { + "self": true, + "email": "bayselonarrend@gmail.com" + }, + "status": "confirmed", + "id": "o6dt8kbedrmu15o53pgbrrv35o", + "etag": "\"3416857346088000\"", + "kind": "calendar#event" + }, + +] + +``` diff --git a/docs/docs/Google_Calendar/Rabota-s-sobytiyami/Sozdat-sobytie.md b/docs/docs/Google_Calendar/Rabota-s-sobytiyami/Sozdat-sobytie.md new file mode 100644 index 0000000000..50cecba9a5 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-s-sobytiyami/Sozdat-sobytie.md @@ -0,0 +1,89 @@ +--- +sidebar_position: 4 +--- + +# Создать событие +Добавляет новое событие в календарь + +*Функция СоздатьСобытие(Знач Токен, Знач Календарь, Знач ОписаниеСобытия) Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + | Календарь | Строка | ID календаря| + | ОписаниеТовара | Соответствие | Описание создаваемого события. См. [ПолучитьОписаниеТовара](./Poluchit-opisanye-sobytiya) | + + Вовзращаемое значение: Соответствие - сериализованный JSON ответа от VK + +```bsl title="Пример кода" + + Вложения = Новый Соответствие; + Вложения.Вставить("Картинка1", "https://opi.neocities.org/assets/images/logo_long-e8fdcca6ff8b32e679ea49a1ccdd3eac.png"); + Вложения.Вставить("Картинка2", "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/Media/logo.png?v1"); + + СоответствиеСобытия = Новый Соответствие; + СоответствиеСобытия.Вставить("Описание" , Описание); + СоответствиеСобытия.Вставить("Заголовок" , Наименование); + СоответствиеСобытия.Вставить("МестоПроведения" , "В оффисе"); + СоответствиеСобытия.Вставить("ДатаНачала" , ТекущаяДатаСеанса()); + СоответствиеСобытия.Вставить("ДатаОкончания" , СоответствиеСобытия["ДатаНачала"] + 3600); + СоответствиеСобытия.Вставить("МассивURLФайловВложений" , Вложения); + СоответствиеСобытия.Вставить("ОтправлятьУведомления" , Истина); + + Ответ = OPI_GoogleCalendar.СоздатьСобытие(Токен, Календарь, СоответствиеСобытия); + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); + +``` + +![Результат](img/1.png) + +```json title="Результат" + +{ + "eventType": "default", + "attachments": [ + { + "iconLink": "", + "title": "Картинка2", + "fileUrl": "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/Media/logo.png?v1" + }, + { + "iconLink": "", + "title": "Картинка1", + "fileUrl": "https://opi.neocities.org/assets/images/logo_long-e8fdcca6ff8b32e679ea49a1ccdd3eac.png" + } + ], + "reminders": { + "useDefault": true + }, + "sequence": 0, + "start": { + "timeZone": "Europe/Minsk", + "dateTime": "2024-02-21T15:16:25+03:00" + }, + "creator": { + "self": true, + "email": "bayselonarrend@gmail.com" + }, + "end": { + "timeZone": "Europe/Minsk", + "dateTime": "2024-02-21T16:16:25+03:00" + }, + "iCalUID": "j4nonfcc0m2mtop1vc8ivo8tb8@google.com", + "description": "Описание тестового события", + "updated": "2024-02-21T09:16:28.474Z", + "created": "2024-02-21T09:16:28.000Z", + "htmlLink": "https://www.google.com/calendar/event?eid=ajRub25mY2MwbTJtdG9wMXZjOGl2bzh0YjggYmF5c2Vsb25hcnJlbmRAbQ", + "location": "В оффисе", + "summary": "Новое событие", + "organizer": { + "self": true, + "email": "bayselonarrend@gmail.com" + }, + "status": "confirmed", + "id": "j4nonfcc0m2mtop1vc8ivo8tb8", + "etag": "\"3417013976948000\"", + "kind": "calendar#event" +} + +``` diff --git a/docs/docs/Google_Calendar/Rabota-s-sobytiyami/_category_.json b/docs/docs/Google_Calendar/Rabota-s-sobytiyami/_category_.json new file mode 100644 index 0000000000..074b62f252 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-s-sobytiyami/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "Работа с событиями", + "position": 3, +} diff --git a/docs/docs/Google_Calendar/Rabota-s-sobytiyami/img/1.png b/docs/docs/Google_Calendar/Rabota-s-sobytiyami/img/1.png new file mode 100644 index 0000000000..b158479e6d Binary files /dev/null and b/docs/docs/Google_Calendar/Rabota-s-sobytiyami/img/1.png differ diff --git a/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Dobavit-calendar-v-spisok.md b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Dobavit-calendar-v-spisok.md new file mode 100644 index 0000000000..7b4847c0c2 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Dobavit-calendar-v-spisok.md @@ -0,0 +1,48 @@ +--- +sidebar_position: 3 +--- + +# Добавить календарь в список +Добавляет календарь в список календарей пользователя + +*Функция ДобавитьКалендарьВСписок(Знач Токен, Знач Календарь) Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + | Календарь | Строка | ID календаря для добавления | + + Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Google + +```bsl title="Пример кода" + + Ответ = OPI_GoogleCalendar.ДобавитьКалендарьВСписок(Токен, "55868c32be16935f0..."); //Соответствие + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка + +``` + +![Результат](img/1.png) + +```json title="Результат" + +{ + "conferenceProperties": { + "allowedConferenceSolutionTypes": [ + "hangoutsMeet" + ] + }, + "accessRole": "owner", + "selected": true, + "foregroundColor": "#000000", + "backgroundColor": "#7bd148", + "colorId": "9", + "description": "Тестовое описание", + "summary": "Тестовый календарь (изм.)", + "defaultReminders": [], + "timeZone": "UTC", + "id": "f0fad8c7db43ef0adb71cbf035eb08cf80d8f8d51ba31fa86f4d5680dc2e9725@group.calendar.google.com", + "etag": "\"1708423365033000\"", + "kind": "calendar#calendarListEntry" +} + +``` diff --git a/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Izmenit-calendar-spiska.md b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Izmenit-calendar-spiska.md new file mode 100644 index 0000000000..6dd6827307 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Izmenit-calendar-spiska.md @@ -0,0 +1,54 @@ +--- +sidebar_position: 4 +--- + +# Изменить календарь списка +Изменяет данные календаря из списка календарей пользователя + +*Функция ИзменитьКалендарьСписка(Знач Токен, Знач Календарь, Знач ОсновнойЦвет, Знач ДополнительныйЦвет, Знач Скрытый = Ложь) Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + | Календарь | Строка | ID календаря для добавления | + | ОсновнойЦвет | Строка | HEX основного цвета (цвета шрифта) в формате #ffffff | + | ДополнительныйЦвет | Строка | HEX дополнительного цвета (цвета фона) в формате #ffffff | + | Скрытый | Булево (необяз.) | Признак скрытости календаря | + + Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Google + +```bsl title="Пример кода" + + + Черный = "#000000"; + Желтый = "#ffd800"; + + Ответ = OPI_GoogleCalendar.ИзменитьКалендарьСписка(Токен, "55868c32be16935f0...", Черный, Желтый, Ложь); //Соответствие + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка + +``` + +![Результат](img/2.png) + +```json title="Результат" + +{ + "conferenceProperties": { + "allowedConferenceSolutionTypes": [ + "hangoutsMeet" + ] + }, + "accessRole": "owner", + "foregroundColor": "#000000", + "backgroundColor": "#ffd800", + "colorId": "6", + "description": "Тестовое описание", + "summary": "Тестовый календарь (изм.)", + "defaultReminders": [], + "timeZone": "UTC", + "id": "0da65d69eba1e4b27f980447827b251ca2d94ecb1d30dba22c83559c33d0ea29@group.calendar.google.com", + "etag": "\"1708424005038000\"", + "kind": "calendar#calendarListEntry" +} + +``` diff --git a/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Poluchit-calendar-spiska.md b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Poluchit-calendar-spiska.md new file mode 100644 index 0000000000..b8596e1056 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Poluchit-calendar-spiska.md @@ -0,0 +1,45 @@ +--- +sidebar_position: 2 +--- + +# Получить календарь списка +Получает информацию о календаре из списка календарей пользователя + +*Функция ПолучитьКалендарьСписка(Знач Токен, Знач Календарь) Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + | Календарь | Строка | ID календаря для получения | + + Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Google + +```bsl title="Пример кода" + + Ответ = OPI_GoogleCalendar.ПолучитьКалендарьСписка(Токен, "55868c32be16935f0..."); //Соответствие + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка + +``` + +```json title="Результат" + +{ + "conferenceProperties": { + "allowedConferenceSolutionTypes": [ + "hangoutsMeet" + ] + }, + "accessRole": "owner", + "foregroundColor": "#000000", + "backgroundColor": "#ffd800", + "colorId": "6", + "description": "Тестовое описание", + "summary": "Тестовый календарь (изм.)", + "defaultReminders": [], + "timeZone": "UTC", + "id": "f0fad8c7db43ef0adb71cbf035eb08cf80d8f8d51ba31fa86f4d5680dc2e9725@group.calendar.google.com", + "etag": "\"1708423563386000\"", + "kind": "calendar#calendarListEntry" +} + +``` diff --git a/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Poluchit-spisok-kalendarey.md b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Poluchit-spisok-kalendarey.md new file mode 100644 index 0000000000..19c64fd3eb --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Poluchit-spisok-kalendarey.md @@ -0,0 +1,162 @@ +--- +sidebar_position: 1 +--- + +# Получить список календарей +Получает список календарей пользователя + +*Функция ПолучитьСписокКалендарей(Знач Токен) Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + + Вовзращаемое значение: Массив из Соответствие - массив данных календарей + +```bsl title="Пример кода" + + Ответ = OPI_GoogleCalendar.ПолучитьСписокКалендарей(Токен); //Соответствие + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка + +``` + +```json title="Результат" + +[ + { + "conferenceProperties": { + "allowedConferenceSolutionTypes": [ + "hangoutsMeet" + ] + }, + "accessRole": "reader", + "foregroundColor": "#000000", + "backgroundColor": "#92e1c0", + "colorId": "13", + "description": "Показывает дни рождения, годовщины и другие значимые события для людей в Google Контактах.", + "summary": "Дни рождения", + "defaultReminders": [], + "timeZone": "Europe/Minsk", + "id": "addressbook#contacts@group.v.calendar.google.com", + "etag": "\"1708410978711000\"", + "kind": "calendar#calendarListEntry" + }, + { + "conferenceProperties": { + "allowedConferenceSolutionTypes": [ + "hangoutsMeet" + ] + }, + "notificationSettings": { + "notifications": [ + { + "method": "email", + "type": "eventCreation" + }, + { + "method": "email", + "type": "eventChange" + }, + { + "method": "email", + "type": "eventCancellation" + }, + { + "method": "email", + "type": "eventResponse" + } + ] + }, + "accessRole": "owner", + "selected": true, + "foregroundColor": "#000000", + "backgroundColor": "#9fe1e7", + "colorId": "14", + "primary": true, + "summary": "bayselonarrend@gmail.com", + "defaultReminders": [ + { + "minutes": 30, + "method": "popup" + } + ], + "timeZone": "Europe/Minsk", + "id": "bayselonarrend@gmail.com", + "etag": "\"1708411692097000\"", + "kind": "calendar#calendarListEntry" + }, + { + "conferenceProperties": { + "allowedConferenceSolutionTypes": [ + "hangoutsMeet" + ] + }, + "accessRole": "reader", + "foregroundColor": "#000000", + "backgroundColor": "#16a765", + "colorId": "8", + "description": "Праздники и памятные даты Беларуси", + "summary": "Праздники Беларуси", + "defaultReminders": [], + "timeZone": "Europe/Minsk", + "id": "ru.by#holiday@group.v.calendar.google.com", + "etag": "\"1708417568219000\"", + "kind": "calendar#calendarListEntry" + }, + { + "conferenceProperties": { + "allowedConferenceSolutionTypes": [ + "hangoutsMeet" + ] + }, + "accessRole": "owner", + "foregroundColor": "#000000", + "backgroundColor": "#cca6ac", + "colorId": "21", + "description": "Тестовое описание", + "summary": "Тестовый календарь (изм.)", + "defaultReminders": [], + "timeZone": "UTC", + "id": "9e3fe3b35b6a09a1fa9413a0deec2fe8e040ed7fdd0fdeb1e49028848269654d@group.calendar.google.com", + "etag": "\"1708417602744000\"", + "kind": "calendar#calendarListEntry" + }, + { + "conferenceProperties": { + "allowedConferenceSolutionTypes": [ + "hangoutsMeet" + ] + }, + "accessRole": "owner", + "foregroundColor": "#000000", + "backgroundColor": "#ffd800", + "colorId": "6", + "description": "Тестовое описание", + "summary": "Тестовый календарь (изм.)", + "defaultReminders": [], + "timeZone": "UTC", + "id": "0047d950f70f380b8ff7e2fa538b6f9f10c8a3212d0740788545406cf73431b9@group.calendar.google.com", + "etag": "\"1708417840630000\"", + "kind": "calendar#calendarListEntry" + }, + { + "conferenceProperties": { + "allowedConferenceSolutionTypes": [ + "hangoutsMeet" + ] + }, + "accessRole": "owner", + "foregroundColor": "#000000", + "backgroundColor": "#ffd800", + "colorId": "6", + "description": "Тестовое описание", + "summary": "Тестовый календарь (изм.)", + "defaultReminders": [], + "timeZone": "UTC", + "id": "b5c45ad216306688c4286a262bf66d3da38aaadec3b7a5768153740140ea787c@group.calendar.google.com", + "etag": "\"1708418157716000\"", + "kind": "calendar#calendarListEntry" + } +] + +``` diff --git a/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Udalit-kalendar-iz-spiska.md b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Udalit-kalendar-iz-spiska.md new file mode 100644 index 0000000000..b2f8ebc5f9 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/Udalit-kalendar-iz-spiska.md @@ -0,0 +1,28 @@ +--- +sidebar_position: 5 +--- + +# Удалить календарь из списка +Удаляет календарь из списка календарей пользователя + +*Функция УдалитьКалендарьИзСписка(Знач Токен, Знач Календарь) Экспорт* + + | Параметр | Тип | Назначение | + |-|-|-| + | Токен | Строка | Токен доступа | + | Календарь | Строка | ID календаря для получения | + + Вовзращаемое значение: Пустая строка + +```bsl title="Пример кода" + + Ответ = OPI_GoogleCalendar.УдалитьКалендарьИзСписка(Токен, "55868c32be16935f0..."); //Соответствие + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка + +``` + +```json title="Результат" + +"" + +``` diff --git a/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/_category_.json b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/_category_.json new file mode 100644 index 0000000000..2f5755c747 --- /dev/null +++ b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "Работа со списком календарей", + "position": 1, +} diff --git a/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/img/1.png b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/img/1.png new file mode 100644 index 0000000000..7ff06d751f Binary files /dev/null and b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/img/1.png differ diff --git a/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/img/2.png b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/img/2.png new file mode 100644 index 0000000000..72b164a82e Binary files /dev/null and b/docs/docs/Google_Calendar/Rabota-so-spiskom-kalendarey/img/2.png differ diff --git a/docs/static/img/Docs/GoogleCalendar/12.png b/docs/static/img/Docs/GoogleCalendar/12.png new file mode 100644 index 0000000000..9837e72460 Binary files /dev/null and b/docs/static/img/Docs/GoogleCalendar/12.png differ