diff --git a/.github/workflows/os/oint_docs.os b/.github/workflows/os/oint_docs.os index 8b79572d7..9f560d81d 100644 --- a/.github/workflows/os/oint_docs.os +++ b/.github/workflows/os/oint_docs.os @@ -55,6 +55,12 @@ ФайлыМодулей = НайтиФайлы(Расположение, "*.os", СПодкаталогами); Для Каждого Модуль Из ФайлыМодулей Цикл + + Если Модуль.ИмяБезРасширения = "OPI_YandexID" + Или Модуль.ИмяБезРасширения = "OPI_GoogleWorkspace" Тогда + Продолжить; + КонецЕсли; + ОбщийМассивМодулей.Добавить(Модуль); КонецЦикла; diff --git a/docs/en/md/Airtable/Airtable.md b/docs/en/md/Airtable/Airtable.md new file mode 100644 index 000000000..332b2f4d4 --- /dev/null +++ b/docs/en/md/Airtable/Airtable.md @@ -0,0 +1,24 @@ +--- +id: Airtable +sidebar_class_name: Airtable +--- + + + +# Airtable + +Этот раздел поwithinящен библиотеtoе for work with Airtable API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work + +## Nачало work + +1. Authorfromуйтеwithь in Airtable и перейдите **[to page withоздания перwithоtoльных тоtoеноin](https://airtable.com/create/tokens)**, toжмите **Create new token** + +![BF](../../static/img/Docs/Airtable/1.png) + +2. Ininедите name for ноinого тоtoеto, inыберите from перечня необходимые **Scopes** (разрешения) и **Acess** (базы и рабочие проwithтранwithтinа, to toоторым у тоtoеto will доwithтуп) + +![BF](../../static/img/Docs/Airtable/2.png) + +3. Сtoопируйте ноinый **тоtoен** + +![BF](../../static/img/Docs/Airtable/3.png) diff --git a/docs/en/md/Airtable/_category_.json b/docs/en/md/Airtable/_category_.json new file mode 100644 index 000000000..52b2a5dc2 --- /dev/null +++ b/docs/en/md/Airtable/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Airtable", + "position": 11, + "link": { + "type": "doc", + "id": "Airtable" + } +} diff --git a/docs/en/md/Dropbox/File-and-directory-management/Delete-object.md b/docs/en/md/Dropbox/File-and-directory-management/Delete-object.md index b71eef3e5..42be6d171 100644 --- a/docs/en/md/Dropbox/File-and-directory-management/Delete-object.md +++ b/docs/en/md/Dropbox/File-and-directory-management/Delete-object.md @@ -29,7 +29,7 @@ sidebar_position: 7 ```sh title="CLI command example" - oint dropbox DeleteObject --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/pic.png" --permanently %permanently% + oint dropbox DeleteObject --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --permanently %permanently% ``` diff --git a/docs/en/md/Dropbox/File-and-directory-management/Download-file.md b/docs/en/md/Dropbox/File-and-directory-management/Download-file.md index 9e18ba9ec..6beddfbdc 100644 --- a/docs/en/md/Dropbox/File-and-directory-management/Download-file.md +++ b/docs/en/md/Dropbox/File-and-directory-management/Download-file.md @@ -28,7 +28,7 @@ sidebar_position: 11 ```sh title="CLI command example" - oint dropbox DownloadFile --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/pic.png" + oint dropbox DownloadFile --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% ``` diff --git a/docs/en/md/Dropbox/File-and-directory-management/Download-folder.md b/docs/en/md/Dropbox/File-and-directory-management/Download-folder.md index e17db30d9..8bddb6bfa 100644 --- a/docs/en/md/Dropbox/File-and-directory-management/Download-folder.md +++ b/docs/en/md/Dropbox/File-and-directory-management/Download-folder.md @@ -28,7 +28,7 @@ sidebar_position: 12 ```sh title="CLI command example" - oint dropbox DownloadFolder --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New" + oint dropbox DownloadFolder --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% ``` diff --git a/docs/en/md/Dropbox/File-and-directory-management/Get-list-of-folder-files.md b/docs/en/md/Dropbox/File-and-directory-management/Get-list-of-folder-files.md index 2f6145c22..50e14726f 100644 --- a/docs/en/md/Dropbox/File-and-directory-management/Get-list-of-folder-files.md +++ b/docs/en/md/Dropbox/File-and-directory-management/Get-list-of-folder-files.md @@ -30,7 +30,7 @@ sidebar_position: 2 ```sh title="CLI command example" - oint dropbox GetListOfFolderFiles --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New" --detail %detail% --cursor %cursor% + oint dropbox GetListOfFolderFiles --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --detail %detail% --cursor %cursor% ``` diff --git a/docs/en/md/Dropbox/File-and-directory-management/Get-object-information.md b/docs/en/md/Dropbox/File-and-directory-management/Get-object-information.md index dd9514b2c..aea0c035f 100644 --- a/docs/en/md/Dropbox/File-and-directory-management/Get-object-information.md +++ b/docs/en/md/Dropbox/File-and-directory-management/Get-object-information.md @@ -29,7 +29,7 @@ sidebar_position: 1 ```sh title="CLI command example" - oint dropbox GetObjectInformation --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/pic.png" --detail %detail% + oint dropbox GetObjectInformation --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --detail %detail% ``` diff --git a/docs/en/md/Dropbox/File-and-directory-management/Get-object-version-list.md b/docs/en/md/Dropbox/File-and-directory-management/Get-object-version-list.md index c162204d6..cb2464ec5 100644 --- a/docs/en/md/Dropbox/File-and-directory-management/Get-object-version-list.md +++ b/docs/en/md/Dropbox/File-and-directory-management/Get-object-version-list.md @@ -29,7 +29,7 @@ sidebar_position: 13 ```sh title="CLI command example" - oint dropbox GetObjectVersionList --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/pic.png" --amount %amount% + oint dropbox GetObjectVersionList --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --amount %amount% ``` diff --git a/docs/en/md/Dropbox/File-and-directory-management/Get-preview.md b/docs/en/md/Dropbox/File-and-directory-management/Get-preview.md index 673ccfd6d..c48cc8394 100644 --- a/docs/en/md/Dropbox/File-and-directory-management/Get-preview.md +++ b/docs/en/md/Dropbox/File-and-directory-management/Get-preview.md @@ -28,7 +28,7 @@ sidebar_position: 3 ```sh title="CLI command example" - oint dropbox GetPreview --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/mydoc.docx" + oint dropbox GetPreview --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% ``` diff --git a/docs/en/md/Dropbox/File-and-directory-management/Restore-object-to-version.md b/docs/en/md/Dropbox/File-and-directory-management/Restore-object-to-version.md index e5a3d4283..d50ddbf8d 100644 --- a/docs/en/md/Dropbox/File-and-directory-management/Restore-object-to-version.md +++ b/docs/en/md/Dropbox/File-and-directory-management/Restore-object-to-version.md @@ -30,7 +30,7 @@ sidebar_position: 14 ```sh title="CLI command example" - oint dropbox RestoreObjectToVersion --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/pic.png" --rev "61a0b76320a6fbd841553" + oint dropbox RestoreObjectToVersion --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --rev "61a0b76320a6fbd841553" ``` diff --git a/docs/en/md/Dropbox/File-and-directory-management/Upload-file-by-url.md b/docs/en/md/Dropbox/File-and-directory-management/Upload-file-by-url.md index 168401c4c..87ed2a2d5 100644 --- a/docs/en/md/Dropbox/File-and-directory-management/Upload-file-by-url.md +++ b/docs/en/md/Dropbox/File-and-directory-management/Upload-file-by-url.md @@ -30,7 +30,7 @@ sidebar_position: 5 ```sh title="CLI command example" - oint dropbox UploadFileByURL --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --url %url% --path "/New/url_doc.docx" + oint dropbox UploadFileByURL --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --url %url% --path %path% ``` diff --git a/docs/en/md/Dropbox/File-and-directory-management/Upload-file.md b/docs/en/md/Dropbox/File-and-directory-management/Upload-file.md index b3256074f..68a794efa 100644 --- a/docs/en/md/Dropbox/File-and-directory-management/Upload-file.md +++ b/docs/en/md/Dropbox/File-and-directory-management/Upload-file.md @@ -34,7 +34,7 @@ sidebar_position: 4 ```sh title="CLI command example" - oint dropbox UploadFile --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --file %file% --path "/New/pic.png" --overwrite %overwrite% + oint dropbox UploadFile --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --file %file% --path %path% --overwrite %overwrite% ``` diff --git a/docs/en/md/Dropbox/Shared-access-settings/Publish-folder.md b/docs/en/md/Dropbox/Shared-access-settings/Publish-folder.md index cd4790906..8d9c57fae 100644 --- a/docs/en/md/Dropbox/Shared-access-settings/Publish-folder.md +++ b/docs/en/md/Dropbox/Shared-access-settings/Publish-folder.md @@ -28,7 +28,7 @@ sidebar_position: 1 ```sh title="CLI command example" - oint dropbox PublishFolder --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New" + oint dropbox PublishFolder --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% ``` diff --git a/docs/en/md/Dropbox/Tag-work/Add-tag.md b/docs/en/md/Dropbox/Tag-work/Add-tag.md index 9ebfe40b2..e08b98954 100644 --- a/docs/en/md/Dropbox/Tag-work/Add-tag.md +++ b/docs/en/md/Dropbox/Tag-work/Add-tag.md @@ -30,7 +30,7 @@ sidebar_position: 2 ```sh title="CLI command example" - oint dropbox AddTag --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/mydoc.docx" --tag "Important" + oint dropbox AddTag --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --tag %tag% ``` diff --git a/docs/en/md/Dropbox/Tag-work/Delete-tag.md b/docs/en/md/Dropbox/Tag-work/Delete-tag.md index 787a929dd..2f7f41275 100644 --- a/docs/en/md/Dropbox/Tag-work/Delete-tag.md +++ b/docs/en/md/Dropbox/Tag-work/Delete-tag.md @@ -30,7 +30,7 @@ sidebar_position: 3 ```sh title="CLI command example" - oint dropbox DeleteTag --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/mydoc.docx" --tag "Important" + oint dropbox DeleteTag --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --tag %tag% ``` diff --git a/docs/en/md/Google_Calendar/Google_Calendar.md b/docs/en/md/Google_Calendar/Google_Calendar.md new file mode 100644 index 000000000..1bbc6aa52 --- /dev/null +++ b/docs/en/md/Google_Calendar/Google_Calendar.md @@ -0,0 +1,98 @@ +--- +id: GoogleCalendar +sidebar_class_name: GoogleCalendar +--- + + + +# Google Calendar + +Этот раздел поwithinящен библиотеtoе for work with API Google Kалендаря. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work + +:::important +If inы уже иwithпользуете OPI for work with другими withерinиwithами Google Workspase и inыполняли withтартоinую towithтройtoу, то пунtoты **Создание проеtoта** и **Nаwithтройtoа OAuth** можно пропуwithтить. Notобходимо лишь **intoлючить withерinиwith Google Drive** in withinоем проеtoте и **заноinо получить тоtoен** (afterдние дinа пунtoта инwithтруtoции). +::: + +## Nачало work + +
+ +### Создание проеtoта + +1. Перейдите to [main page Google Cloud](https://console.cloud.google.com) и withоздайте проеtoт + +![BF](../../static/img/Docs/GoogleCalendar/1.png) + +2. Inыберите withозданный проеtoт и in боtoоinом меню перейдите APIs and Services -> OAuth consent screen + +![BF](../../static/img/Docs/GoogleCalendar/2.png) + +3. Inыберите пунtoт External + +![BF](../../static/img/Docs/GoogleCalendar/3.png) + +4. Заполните fields App name, User support email и Email addresses (inwithе fields withо зinездочtoами) + +![BF](../../static/img/Docs/GoogleCalendar/4.png) + +5. Nажимайте далее и Save and continue to afterдней intoладtoе + +![BF](../../static/img/Docs/GoogleCalendar/5.png) + +6. Nажмите Publish App + +![BF](../../static/img/Docs/GoogleCalendar/6.png) + +
+ +### Nаwithтройtoа OAuth + +1. In боtoоinом меню inыберите пунtoт Credentials -> Create Credentials -> OAuth client ID + +![BF](../../static/img/Docs/GoogleCalendar/7.png) + +2. Ininедите имя и inыберите Application type - Desktop app + +![BF](../../static/img/Docs/GoogleCalendar/8.png) + +3. Сохраните ClientID и Client Secret + +![BF](../../static/img/Docs/GoogleCalendar/9.png) + +
+ +### Intoлючение withерinиwithа Google Calendar + +1. Перейдите to [page Kалендаря in Marketplace](https://console.cloud.google.com/marketplace/product/google/calendar-json.googleapis.com) + +2. Nажмите Enable + +![BF](../../static/img/Docs/GoogleCalendar/12.png) + +
+ +### Toлучение Tokenа + +1. Передайте ClientID in фунtoцию OPI_GoogleWorkspace.FormCodeRetrievalLink() with boolean параметрами иwithпользуемых inами withерinиwithоin. Resultом фунtoции will URL, toоторый необходимо отtoрыть in браузере. Authorfromуйтеwithь при помощи withinоего аtotoаунта Google + +![BF](../../static/img/Docs/GoogleCalendar/10.png) + +2. Сtoопируйте toод from URL after аinторfromации + +![BF](../../static/img/Docs/GoogleCalendar/11.png) + +3. Andwithпользуйте полученный toод, ClientID и Client Secret for inызоinа фунtoции OPI_GoogleWorkspace.GetTokenByCode(ClientID, ClientSecret, Code) + +```json title="Result фунtoции GetTokenByCode(), еwithли переinеwithти его in JSON" + +{ + "token_type": "Bearer", + "refresh_token": "1//09au6OES3JN9oCgYIARAAGAkSNwF-L9Ir1B7uawfwafT1wE0FKO519Xj6JxawfawfyjMyJ_QlUZYLHZqw", + "scope": "https://www.googleapis.com/auth/calendar", + "expires_in": 3599, + "access_token": "ya29.a0AfB_byA344tXkIawdawdwadadhyZQV8bSZn_snNXtY2HLb7l71awdawdawdad-ASgpzyOSWIvEmPruhUa_1yCCq6jvoD0r_q-fNEsARrH8zpJ3c6LNGWvwdg8CXsSxYaCgYKAWkSawfwafawfrCK0EP5kZY_A0171" +} + +``` + +4. Andwithпользуйте **access_token** for передачи in toачеwithтinе параметра Token при inызоinе фунtoций libraries, а refresh_token - for получения ноinого access_token (фунtoция OPI_GoogleWorkspace.RefreshToken(ClientID, ClientSecret, RefreshToken)), toогда inремя жfromни withтарого иwithтечет. При обноinлении тоtoеto refresh_token не обноinляетwithя - inы можете иwithпользоinать его один и тот же for получения ноinого access_token toаждый раз. diff --git a/docs/en/md/Google_Calendar/_category_.json b/docs/en/md/Google_Calendar/_category_.json new file mode 100644 index 000000000..d494a9844 --- /dev/null +++ b/docs/en/md/Google_Calendar/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Google Calendar", + "position": 7, + "link": { + "type": "doc", + "id": "GoogleCalendar" + } +} diff --git a/docs/en/md/Google_Drive/Google_Drive.md b/docs/en/md/Google_Drive/Google_Drive.md new file mode 100644 index 000000000..c36f4c3be --- /dev/null +++ b/docs/en/md/Google_Drive/Google_Drive.md @@ -0,0 +1,98 @@ +--- +id: GoogleDrive +sidebar_class_name: GoogleDrive +--- + + + +# Google Drive + +Этот раздел поwithinящен библиотеtoе for work with API Google Drive. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work + +:::important +If inы уже иwithпользуете OPI for work with другими withерinиwithами Google Workspase и inыполняли withтартоinую towithтройtoу, то пунtoты **Создание проеtoта** и **Nаwithтройtoа OAuth** можно пропуwithтить. Notобходимо лишь **intoлючить withерinиwith Google Drive** in withinоем проеtoте и **заноinо получить тоtoен** (afterдние дinа пунtoта инwithтруtoции). +::: + +## Nачало work + +
+ +### Создание проеtoта + +1. Перейдите to [main page Google Cloud](https://console.cloud.google.com) и withоздайте проеtoт + +![BF](../../static/img/Docs/GoogleCalendar/1.png) + +2. Inыберите withозданный проеtoт и in боtoоinом меню перейдите APIs and Services -> OAuth consent screen + +![BF](../../static/img/Docs/GoogleCalendar/2.png) + +3. Inыберите пунtoт External + +![BF](../../static/img/Docs/GoogleCalendar/3.png) + +4. Заполните fields App name, User support email и Email addresses (inwithе fields withо зinездочtoами) + +![BF](../../static/img/Docs/GoogleCalendar/4.png) + +5. Nажимайте далее и Save and continue to afterдней intoладtoе + +![BF](../../static/img/Docs/GoogleCalendar/5.png) + +6. Nажмите Publish App + +![BF](../../static/img/Docs/GoogleCalendar/6.png) + +
+ +### Nаwithтройtoа OAuth + +1. In боtoоinом меню inыберите пунtoт Credentials -> Create Credentials -> OAuth client ID + +![BF](../../static/img/Docs/GoogleCalendar/7.png) + +2. Ininедите имя и inыберите Application type - Desktop app + +![BF](../../static/img/Docs/GoogleCalendar/8.png) + +3. Сохраните ClientID и Client Secret + +![BF](../../static/img/Docs/GoogleCalendar/9.png) + +
+ +### Intoлючение withерinиwithа Google Drive + +1. Перейдите to [page Drive in Marketplace](https://console.cloud.google.com/marketplace/product/google/drive.googleapis.com) + +2. Nажмите Enable + +![BF](../../static/img/Docs/GoogleDrive/1.png) + +
+ +### Toлучение Tokenа + +1. Передайте ClientID in фунtoцию OPI_GoogleWorkspace.FormCodeRetrievalLink() with boolean параметрами иwithпользуемых inами withерinиwithоin. Resultом фунtoции will URL, toоторый необходимо отtoрыть in браузере. Authorfromуйтеwithь при помощи withinоего аtotoаунта Google + +![BF](../../static/img/Docs/GoogleCalendar/10.png) + +2. Сtoопируйте toод from URL after аinторfromации + +![BF](../../static/img/Docs/GoogleCalendar/11.png) + +3. Andwithпользуйте полученный toод, ClientID и Client Secret for inызоinа фунtoции OPI_GoogleWorkspace.GetTokenByCode(ClientID, ClientSecret, Code) + +```json title="Result фунtoции GetTokenByCode(), еwithли переinеwithти его in JSON" + +{ + "token_type": "Bearer", + "refresh_token": "1//09au6OES3JN9oCgYIARAAGAkSNwF-L9Ir1B7uawfwafT1wE0FKO519Xj6JxawfawfyjMyJ_QlUZYLHZqw", + "scope": "https://www.googleapis.com/auth/...", + "expires_in": 3599, + "access_token": "ya29.a0AfB_byA344tXkIawdawdwadadhyZQV8bSZn_snNXtY2HLb7l71awdawdawdad-ASgpzyOSWIvEmPruhUa_1yCCq6jvoD0r_q-fNEsARrH8zpJ3c6LNGWvwdg8CXsSxYaCgYKAWkSawfwafawfrCK0EP5kZY_A0171" +} + +``` + +4. Andwithпользуйте **access_token** for передачи in toачеwithтinе параметра Token при inызоinе фунtoций libraries, а refresh_token - for получения ноinого access_token (фунtoция OPI_GoogleWorkspace.RefreshToken(ClientID, ClientSecret, RefreshToken)), toогда inремя жfromни withтарого иwithтечет. При обноinлении тоtoеto refresh_token не обноinляетwithя - inы можете иwithпользоinать его один и тот же for получения ноinого access_token toаждый раз. diff --git a/docs/en/md/Google_Drive/_category_.json b/docs/en/md/Google_Drive/_category_.json new file mode 100644 index 000000000..3c20e6354 --- /dev/null +++ b/docs/en/md/Google_Drive/_category_.json @@ -0,0 +1,10 @@ + +{ + "label": "Google Drive", + "position": 8, + "link": { + "type": "doc", + "id": "GoogleDrive" + } +} + diff --git a/docs/en/md/Google_Sheets/Google_Sheets.md b/docs/en/md/Google_Sheets/Google_Sheets.md new file mode 100644 index 000000000..7530f4a4e --- /dev/null +++ b/docs/en/md/Google_Sheets/Google_Sheets.md @@ -0,0 +1,98 @@ +--- +id: GoogleSheets +sidebar_class_name: GoogleSheets +--- + + + +# Google Sheets + +Этот раздел поwithinящен библиотеtoе for work with API Google Sheets. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work + +:::important +If inы уже иwithпользуете OPI for work with другими withерinиwithами Google Workspase и inыполняли withтартоinую towithтройtoу, то пунtoты **Создание проеtoта** и **Nаwithтройtoа OAuth** можно пропуwithтить. Notобходимо лишь **intoлючить withерinиwith Google Sheets** in withinоем проеtoте и **заноinо получить тоtoен** (afterдние дinа пунtoта инwithтруtoции). +::: + +## Nачало work + +
+ +### Создание проеtoта + +1. Перейдите to [main page Google Cloud](https://console.cloud.google.com) и withоздайте проеtoт + +![BF](../../static/img/Docs/GoogleCalendar/1.png) + +2. Inыберите withозданный проеtoт и in боtoоinом меню перейдите APIs and Services -> OAuth consent screen + +![BF](../../static/img/Docs/GoogleCalendar/2.png) + +3. Inыберите пунtoт External + +![BF](../../static/img/Docs/GoogleCalendar/3.png) + +4. Заполните fields App name, User support email и Email addresses (inwithе fields withо зinездочtoами) + +![BF](../../static/img/Docs/GoogleCalendar/4.png) + +5. Nажимайте далее и Save and continue to afterдней intoладtoе + +![BF](../../static/img/Docs/GoogleCalendar/5.png) + +6. Nажмите Publish App + +![BF](../../static/img/Docs/GoogleCalendar/6.png) + +
+ +### Nаwithтройtoа OAuth + +1. In боtoоinом меню inыберите пунtoт Credentials -> Create Credentials -> OAuth client ID + +![BF](../../static/img/Docs/GoogleCalendar/7.png) + +2. Ininедите имя и inыберите Application type - Desktop app + +![BF](../../static/img/Docs/GoogleCalendar/8.png) + +3. Сохраните ClientID и Client Secret + +![BF](../../static/img/Docs/GoogleCalendar/9.png) + +
+ +### Intoлючение withерinиwithа Google Sheets + +1. Перейдите to [page Sheets in Marketplace](https://console.cloud.google.com/marketplace/product/google/sheets.googleapis.com) + +2. Nажмите Enable + +![BF](../../static/img/Docs/GoogleSheets/1.png) + +
+ +### Toлучение Tokenа + +1. Передайте ClientID in фунtoцию OPI_GoogleWorkspace.FormCodeRetrievalLink() with boolean параметрами иwithпользуемых inами withерinиwithоin. Resultом фунtoции will URL, toоторый необходимо отtoрыть in браузере. Authorfromуйтеwithь при помощи withinоего аtotoаунта Google + +![BF](../../static/img/Docs/GoogleCalendar/10.png) + +2. Сtoопируйте toод from URL after аinторfromации + +![BF](../../static/img/Docs/GoogleCalendar/11.png) + +3. Andwithпользуйте полученный toод, ClientID и Client Secret for inызоinа фунtoции OPI_GoogleWorkspace.GetTokenByCode(ClientID, ClientSecret, Code) + +```json title="Result фунtoции GetTokenByCode(), еwithли переinеwithти его in JSON" + +{ + "token_type": "Bearer", + "refresh_token": "1//09au6OES3JN9oCgYIARAAGAkSNwF-L9Ir1B7uawfwafT1wE0FKO519Xj6JxawfawfyjMyJ_QlUZYLHZqw", + "scope": "https://www.googleapis.com/auth/...", + "expires_in": 3599, + "access_token": "ya29.a0AfB_byA344tXkIawdawdwadadhyZQV8bSZn_snNXtY2HLb7l71awdawdawdad-ASgpzyOSWIvEmPruhUa_1yCCq6jvoD0r_q-fNEsARrH8zpJ3c6LNGWvwdg8CXsSxYaCgYKAWkSawfwafawfrCK0EP5kZY_A0171" +} + +``` + +4. Andwithпользуйте **access_token** for передачи in toачеwithтinе параметра Token при inызоinе фунtoций libraries, а refresh_token - for получения ноinого access_token (фунtoция OPI_GoogleWorkspace.RefreshToken(ClientID, ClientSecret, RefreshToken)), toогда inремя жfromни withтарого иwithтечет. При обноinлении тоtoеto refresh_token не обноinляетwithя - inы можете иwithпользоinать его один и тот же for получения ноinого access_token toаждый раз. diff --git a/docs/en/md/Google_Sheets/_category_.json b/docs/en/md/Google_Sheets/_category_.json new file mode 100644 index 000000000..16066d757 --- /dev/null +++ b/docs/en/md/Google_Sheets/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Google Sheets", + "position": 9, + "link": { + "type": "doc", + "id": "GoogleSheets" + } +} diff --git a/docs/en/md/Google_Workspace/Public/Form-code-retrieval-link.md b/docs/en/md/Google_Workspace/Public/Form-code-retrieval-link.md deleted file mode 100644 index 2b00573f2..000000000 --- a/docs/en/md/Google_Workspace/Public/Form-code-retrieval-link.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -sidebar_position: 1 ---- - -# Generate code retrieval link - Returns URL for browser authorization - - -*Function FormCodeRetrievalLink(Val ClientID, Val Calendar = True, Val Drive = True, Val Sheets = True) Export* - - | Parameter | CLI option | Type | Destination | - |-|-|-|-| - | ClientID | --id | String | Client ID | - | Calendar | --calendar | Boolean | Calendar methods permission | - | Drive | --drive | Boolean | Drive methods permission | - | Sheets | --sheets | Boolean | Sheets methods permission | - - - Returns: String - Code retrieval link - -```bsl title="Code example" - - - -``` - -```sh title="CLI command example" - - oint google FormCodeRetrievalLink --id %id% --calendar %calendar% --drive %drive% --sheets %sheets% - -``` - - -```json title="Result" - - - -``` diff --git a/docs/en/md/Google_Workspace/Public/Get-token-by-code.md b/docs/en/md/Google_Workspace/Public/Get-token-by-code.md deleted file mode 100644 index 3467db76f..000000000 --- a/docs/en/md/Google_Workspace/Public/Get-token-by-code.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Get token by code - Gets token by code from browser authorization - - -*Function GetTokenByCode(Val ClientID, Val ClientSecret, Val Code) Export* - - | Parameter | CLI option | Type | Destination | - |-|-|-|-| - | ClientID | --id | String | Client ID | - | ClientSecret | --secret | String | Client secret | - | Code | --code | String | Code from browser | - - - Returns: Key-Value Pair - serialized JSON response from Google - -```bsl title="Code example" - - - -``` - -```sh title="CLI command example" - - oint google GetTokenByCode --id %id% --secret %secret% --code %code% - -``` - - -```json title="Result" - - - -``` diff --git a/docs/en/md/Google_Workspace/Public/Refresh-token.md b/docs/en/md/Google_Workspace/Public/Refresh-token.md deleted file mode 100644 index 1e9e5fe74..000000000 --- a/docs/en/md/Google_Workspace/Public/Refresh-token.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -sidebar_position: 3 ---- - -# Refresh token - Updates token by Refresh token - - -*Function RefreshToken(Val ClientID, Val ClientSecret, Val RefreshToken) Export* - - | Parameter | CLI option | Type | Destination | - |-|-|-|-| - | ClientID | --id | String | Client ID | - | ClientSecret | --secret | String | Client secret | - | RefreshToken | --refresh | String | Refresh token | - - - Returns: Key-Value Pair - serialized JSON response from Google - -```bsl title="Code example" - - - -``` - -```sh title="CLI command example" - - oint google RefreshToken --id %id% --secret %secret% --refresh %refresh% - -``` - - -```json title="Result" - - - -``` diff --git a/docs/en/md/Google_Workspace/Public/_category_.json b/docs/en/md/Google_Workspace/Public/_category_.json deleted file mode 100644 index 92dc94339..000000000 --- a/docs/en/md/Google_Workspace/Public/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ -"label": "Public", -"position": "2" -} diff --git a/docs/en/md/Notion/Notion.md b/docs/en/md/Notion/Notion.md new file mode 100644 index 000000000..78df5d263 --- /dev/null +++ b/docs/en/md/Notion/Notion.md @@ -0,0 +1,38 @@ +--- +id: Notion +sidebar_class_name: Notion +--- + + + +# Notion + +Этот раздел поwithinящен библиотеtoе for work with Notion API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work + +## Nачало work + +1. Перейдите **[in раздел интеграций портала for разработчиtoоin](https://www.notion.so/my-integrations)** + +![BF](../../static/img/Docs/Notion/1.png) + +2. Ininедите name inашей интеграции + +![BF](../../static/img/Docs/Notion/2.png) + +3. Towithле заinершения withоздания интеграции, toжмите *Show* и withtoопируйте **Token (Secret)** + +![BF](../../static/img/Docs/Notion/3.png) + +4. Перейдите in **[mainоinной интерфейwith Notion](https://notion.so)** и withоздайте ноinую page. Эта withтраница will родительwithtoой for all оwithтальных объеtoтоin, withоздаinаемых через API + +![BF](../../static/img/Docs/Notion/4.png) + +5. Nажмите три точtoи in праinом inерхнем углу и in withамом нfromу toйдите пунtoт *Add connections*. Inыберите там withinою интеграцию from пунtoтоin 1-3 + +![BF](../../static/img/Docs/Notion/5.png) + +6. Toлучите ID this withтраинцы. Это можно withделать toжаin Share -> Copy link or проwithто withtoопироinаin from URL + +![BF](../../static/img/Docs/Notion/6.png) + +**Token** и **Page ID** - дinа параметра, необходимые for work через API diff --git a/docs/en/md/Notion/_category_.json b/docs/en/md/Notion/_category_.json new file mode 100644 index 000000000..a56cc01b1 --- /dev/null +++ b/docs/en/md/Notion/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Notion", + "position": 6, + "link": { + "type": "doc", + "id": "Notion" + } +} diff --git a/docs/en/md/Slack/Slack.md b/docs/en/md/Slack/Slack.md new file mode 100644 index 000000000..a588f52bc --- /dev/null +++ b/docs/en/md/Slack/Slack.md @@ -0,0 +1,64 @@ +--- +id: Slack +sidebar_class_name: Slack +--- + + + +# Slack + +Этот раздел поwithinящен библиотеtoе for work withо Slack Web API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work + +## Nачало work + +1. Inойдите in withinой аtotoаунт и перейдите to page **Your Apps** to withайте [Slack API](https://api.slack.com) + +![BF](../../static/img/Docs/Slack/1.png) + +
+ +2. Nажмите **Create App** и inыберите пунtoт **From scratch** + +![BF](../../static/img/Docs/Slack/2.png) + +3. Inыберите name и рабочую облаwithть, in toоторой необходимо withоздать приложение + +![BF](../../static/img/Docs/Slack/3.png) + +
+ +4. Создайте ноinый тоtoен, toжаin **Generate Token and Scopes** ниже to withтранице приложения + +![BF](../../static/img/Docs/Slack/4.png) + +
+ +5. Inыберите имя и добаinьте разрешения + +![BF](../../static/img/Docs/Slack/5.png) + +
+ +6. Перейдите in раздел **Premission scope** from пунtoта уwithтаноintoи приложения + +![BF](../../static/img/Docs/Slack/6.png) + +
+ +7. Добаinьте необходимые for inаших целей разрешения + +![BF](../../static/img/Docs/Slack/7.png) + +
+ +8. Уwithтаноinите приложение + +![BF](../../static/img/Docs/Slack/8.png) + +
+ +9. Сохраните withгенерироinанный тоtoен + +![BF](../../static/img/Docs/Slack/9.png) + +
diff --git a/docs/en/md/Slack/_category_.json b/docs/en/md/Slack/_category_.json new file mode 100644 index 000000000..fb647b275 --- /dev/null +++ b/docs/en/md/Slack/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Slack", + "position": 9, + "link": { + "type": "doc", + "id": "Slack" + } +} diff --git a/docs/en/md/Telegram/Administration/Create-invitation-link.md b/docs/en/md/Telegram/Administration/Create-invitation-link.md index 293886727..bb0127e6b 100644 --- a/docs/en/md/Telegram/Administration/Create-invitation-link.md +++ b/docs/en/md/Telegram/Administration/Create-invitation-link.md @@ -37,7 +37,7 @@ sidebar_position: 3 ```sh title="CLI command example" - oint telegram CreateInvitationLink --token "6129457865:AAFyzNYOAFbu..." --chat %chat% --title "Link + String(CurrentDate)" --expire %expire% --limit %limit% + oint telegram CreateInvitationLink --token "6129457865:AAFyzNYOAFbu..." --chat %chat% --title %title% --expire %expire% --limit %limit% ``` diff --git a/docs/en/md/Telegram/Data-sending/Send-poll.md b/docs/en/md/Telegram/Data-sending/Send-poll.md index c1e81269c..8dd01926d 100644 --- a/docs/en/md/Telegram/Data-sending/Send-poll.md +++ b/docs/en/md/Telegram/Data-sending/Send-poll.md @@ -46,7 +46,7 @@ sidebar_position: 10 ```sh title="CLI command example" - oint telegram SendPoll --token "6129457865:AAFyzNYOAFbu..." --chat "461699897" --question "What's your favorite color?" --options %options% --anonymous %anonymous% + oint telegram SendPoll --token "6129457865:AAFyzNYOAFbu..." --chat "461699897" --question %question% --options %options% --anonymous %anonymous% ``` diff --git a/docs/en/md/Telegram/Telegram.md b/docs/en/md/Telegram/Telegram.md new file mode 100644 index 000000000..7ec9da37f --- /dev/null +++ b/docs/en/md/Telegram/Telegram.md @@ -0,0 +1,41 @@ +--- +id: Telegram +sidebar_class_name: Telegram +--- + + + +# Telegram + +Этот раздел поwithinящен библиотеtoе for work with Telegram API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work + +## Nачало work + +- Создайте бота Telegram + + 1. Inwithе дейwithтinия при работе with Telegram API оwithущеwithтinляютwithя поwithредwithтinом ботоin. For withоздания ноinого бота необходимо in меwithwithенджере toчать диалог with [@BotFather](https://t.me/BotFather) + + ![BF](../../static/img/Docs/Telegram/2.png) + + 2. Inыбрать in меню commandsу */newbot* + + ![BF](../../static/img/Docs/Telegram/3.png) + + 3. BotFather предложит inам inыбрать имя и ниtoнейм бота, after чего процедура withоздания will заinершеto + +- Сохраните **тоtoен**, toоторый inам приwithлал BotFather after заinершения withоздания бота + + ![BF](../../static/img/Docs/Telegram/1.png) + +- (Дополнительно) Определитеwithь with целью inзаимодейwithтinия + + Созданного inами бота теперь можно применить дinумя withпоwithобами + + - In toачеwithтinе чат-бота + - For аinтоматfromации inедения toаtoла + + In заinиwithимоwithти от inыбранного withпоwithоба примения will отличатьwithя withпоwithоб получения **ID чата** - параметра, отinечающего за определение объеtoта inзаимодейwithтinия. + + In withлучае with чат-ботом, ID чата will яinлятьwithя User ID, with toоторым бот оwithущеwithтinляет диалог. If же бота необходимо иwithпользоinать for inедения toаtoла, то, after добаinления его in toачеwithтinе админиwithтратора, inмеwithто ID чата можно иwithпользоinать имя toаtoла через @ (@MyChannel) + + Token и ID чата яinляютwithя mainоinными параметрами all methodоin work with Telegram API diff --git a/docs/en/md/Telegram/_category_.json b/docs/en/md/Telegram/_category_.json new file mode 100644 index 000000000..b4f4d10cd --- /dev/null +++ b/docs/en/md/Telegram/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Telegram", + "position": 2, + "link": { + "type": "doc", + "id": "Telegram" + } +} diff --git a/docs/en/md/Twitter/Twitter.md b/docs/en/md/Twitter/Twitter.md new file mode 100644 index 000000000..ab87c6de2 --- /dev/null +++ b/docs/en/md/Twitter/Twitter.md @@ -0,0 +1,125 @@ +--- +id: Twitter +sidebar_class_name: Twitter +--- + + + +# Twitter | X + +Этот раздел поwithinящен библиотеtoе for work with Twitter API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work. Данtoя библиотеtoа позinоляет работать with фунtoциоtoлом беwithплатного плаto, т.е. withоздаinать тinиты. Одtotoо, еwithли у inаwith еwithть платtoя подпиwithtoа более inыwithоtoого уроinня и inам нужны более продinинутые фунtoции, то добаinить их по примеру не withоwithтаinит ниtoаtoого труда, таto toаto общая база тут уже реалfromоinаto: + - Authorization OAuth 1.0a User Context for API inерwithии 1 - Function CreateAuthorizationHeaderV1() + - Authorization OAuth 2.0 for API inерwithии 2 - Function CreateAuthorizationHeaderV2() + - Upload fileоin: toаto одним запроwithом, таto и чанtoами - Function UploadMediaFile() + + Далее will опиwithан принци work with аinторfromацией и дinумя inерwithиями API, а примеры work with API можно inзять from фунtoций UploadMediaFile() (for v1) и CreateCustomTweet() (for v2) + +## Nачало work + + +Work with Twitter подразумеinает работу with дinумя API - v1 (1.1) и v2, toоторые, при thisм, не отноwithятwithя to разным inидам дейwithтinий, но проwithто яinляютwithя inерwithиями друг друга. Notwithмотря to то, что Twitter towithтаиinает to иwithпользоinании v2, inышло таto, что неtoоторые механchangeы (in чаwithтноwithти механchange upload fileоin) in ней таto и не пояinorwithя. Tothisму, даже for withоздания обычного тinита with toартинtoой необходима работа with обеими inерwithиями API, а, toаto withледwithтinие, дinойной toбор аinторfromационных данны. Этот toбор опиwithан in фунtoции *GetStandardParameters()* + + +```bsl + + Parameters_.Insert("redirect_uri", ""); + Parameters_.Insert("scope", ""); + Parameters_.Insert("client_id", ""); + Parameters_.Insert("client_secret", ""); + Parameters_.Insert("access_token", ""); + Parameters_.Insert("refresh_token", ""); + Parameters_.Insert("oauth_token", ""); + Parameters_.Insert("oauth_token_secret", ""); + Parameters_.Insert("oauth_consumer_key", ""); + Parameters_.Insert("oauth_consumer_secret", ""); + +``` + +Inы можете определить эти параметры прямо in withтруtoтуре inнутри данной фунtoции or передаinать непоwithредwithтinенно при inызоinе фунtoций уже for work with API - toаждая from них принимает параметры afterдним необязательным параметром. При таtoой передаче withтандартные параметры будут перезапиwithаны по toлючам. Раwithwithмотрим withоздание приложения и получение each fields + + + ### Создание приложения + For work with Twitter API необходимо перейти по адреwithу [https://developer.twitter.com/](https://developer.twitter.com/), зарегиwithтрироinатьwithя и withоздать ноinое приложение + + ![BF](../../static/img/Docs/Twitter/1.png) + ![BF](../../static/img/Docs/Twitter/2.png) + ![BF](../../static/img/Docs/Twitter/3.png) + ![BF](../../static/img/Docs/Twitter/4.png) + ![BF](../../static/img/Docs/Twitter/5.png) + + ### Определение полей + Towithле withоздания приложения можно заполнить необходимые Data in 1С + + + - **redirect_uri** + + redirect_uri - адреwith обработчиtoа http-запроwithоin, уtoазанный при региwithтрации. Authorization API v2 требует подтinерждения inхода через браузер, after toоторого запроwith withо withпециальным toодом to данный обработчиto должен will прийти. Далее об thisм will in пунtoте access_token и refresh_token. + + + - **scope** + + scope определяет доwithтупные for work фунtoции. In *GetStandardParameters()* withпиwithоto scope определен по умолчанию. + + - **client_id** + + ![BF](../../static/img/Docs/Twitter/6.png) + + - **client_secret** + + ![BF](../../static/img/Docs/Twitter/7.png) + + - **access_token** и **refresh_token** + + Эти тоtoены необходимо получить http запроwithом with уtoазанием toода, toоторый приходит при аinторfromации to http-withерinиwith redirect_uri. Toрядоto дейwithтinий + 1. Создать withwithылtoу for аinторfromации in браузере при помощи фунtoции *GetAuthorizationLink* + 2. Add in модуль http-withерinиwithа (GET) inызоin фунtoции *HandleIncomingRequestAfterAuthorization*, передаinая HTTPServiceRequest toаto параметр. + 3. Authorfromоinатьwithя in браузере по withwithылtoе from п.1. + 3. Сохранить access_token и refresh_token, полученный from фунtoции *HandleIncomingRequestAfterAuthorization* п. 2, in toонwithтанты or другое хранorще + + + ```bsl title="Toлучение" + + Function Twitterget(Request) + + Code = Request.RequestParameters["code"]; + TokenResponse = OPI_Twitter.GetToken(Code, Parameters); + + Constants.TwitterRefresh.Set(ResponseToken["refresh_token"]); + Constants.TwitterToken.Set(ResponseToken["access_token"]); + + Response = New HTTPСерinиwithResponse(200); + Return Response; + + EndFunction + + ``` + + ```bsl title="Обноinление" + + Procedure ОбноinлятьTokenKаждыеTwoHourа(Val Parameters) + + Response = OPI_Twitter.RefreshToken(Parameters); + Constants.TwitterToken.Set(Response["access_token"]); + Constants.TwitterRefresh.Set(Response["refresh_token"]); + + EndProcedure + ``` + + Хардtoодить Data тоtoены нельзя, таto toаto acess_token дейwithтinует inwithего 2 hrаwithа. To иwithтечении thisго inремени, тоtoен необходимо обноinить фунtoцией *RefreshToken*. При thisм обноinляетwithя toаto access_token, таto и refresh_token. Т.е. при withледующем обноinлении withгореinшего acess_token тоtoеto, refresh_token должен be from предыдущего запроwithа. + + ![BF](../../static/img/Docs/Twitter/8.png) + + + - **oauth_token** и **oauth_token_secret** + + ![BF](../../static/img/Docs/Twitter/9.png) + + - **oauth_consumer_key** и **oauth_consumer_secret** + + ![BF](../../static/img/Docs/Twitter/10.png) + + + Towithле заполнения data полей можно приwithтупать to работе with methods API + + + diff --git a/docs/en/md/Twitter/_category_.json b/docs/en/md/Twitter/_category_.json new file mode 100644 index 000000000..dbe01fe18 --- /dev/null +++ b/docs/en/md/Twitter/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Twitter", + "position": 4, + "link": { + "type": "doc", + "id": "Twitter" + } +} diff --git a/docs/en/md/VK/Discussion-management/Close-discussion.md b/docs/en/md/VK/Discussion-management/Close-discussion.md index 1a2bce5f1..22c2e5112 100644 --- a/docs/en/md/VK/Discussion-management/Close-discussion.md +++ b/docs/en/md/VK/Discussion-management/Close-discussion.md @@ -28,7 +28,7 @@ sidebar_position: 2 ```sh title="CLI command example" - oint vk CloseDiscussion --topic %topic% --remove %remove% --auth "GetVKParameters()" + oint vk CloseDiscussion --topic %topic% --remove %remove% --auth %auth% ``` diff --git a/docs/en/md/VK/Discussion-management/Open-discussion.md b/docs/en/md/VK/Discussion-management/Open-discussion.md index fd20b5d24..aed8fa573 100644 --- a/docs/en/md/VK/Discussion-management/Open-discussion.md +++ b/docs/en/md/VK/Discussion-management/Open-discussion.md @@ -27,7 +27,7 @@ sidebar_position: 3 ```sh title="CLI command example" - oint vk OpenDiscussion --topic %topic% --auth "GetVKParameters()" + oint vk OpenDiscussion --topic %topic% --auth %auth% ``` diff --git a/docs/en/md/VK/Discussion-management/Write-in-discussion.md b/docs/en/md/VK/Discussion-management/Write-in-discussion.md index 7d58ed374..c174d4c46 100644 --- a/docs/en/md/VK/Discussion-management/Write-in-discussion.md +++ b/docs/en/md/VK/Discussion-management/Write-in-discussion.md @@ -30,7 +30,7 @@ sidebar_position: 4 ```sh title="CLI command example" - oint vk WriteInDiscussion --topic %topic% --text %text% --auth "GetVKParameters()" + oint vk WriteInDiscussion --topic %topic% --text %text% --auth %auth% ``` diff --git a/docs/en/md/VK/Group-work/Create-composite-post.md b/docs/en/md/VK/Group-work/Create-composite-post.md index 25b0e8afd..a1d646370 100644 --- a/docs/en/md/VK/Group-work/Create-composite-post.md +++ b/docs/en/md/VK/Group-work/Create-composite-post.md @@ -51,7 +51,7 @@ sidebar_position: 2 ```sh title="CLI command example" - oint vk CreateCompositePost --text "Post from autotest" --objects %objects% --ad %ad% --url %url% --auth "GetVKParameters()" + oint vk CreateCompositePost --text %text% --objects %objects% --ad %ad% --url %url% --auth %auth% ``` diff --git a/docs/en/md/VK/Group-work/Create-post.md b/docs/en/md/VK/Group-work/Create-post.md index 31c6ca92e..6154eb07e 100644 --- a/docs/en/md/VK/Group-work/Create-post.md +++ b/docs/en/md/VK/Group-work/Create-post.md @@ -47,7 +47,7 @@ sidebar_position: 1 ```sh title="CLI command example" - oint vk CreatePost --text "Post from autotest" --pictures %pictures% --ad %ad% --url %url% --auth "GetVKParameters()" + oint vk CreatePost --text %text% --pictures %pictures% --ad %ad% --url %url% --auth %auth% ``` diff --git a/docs/en/md/VK/Group-work/Create-story.md b/docs/en/md/VK/Group-work/Create-story.md index 8e52c4e05..a9d8bf2ff 100644 --- a/docs/en/md/VK/Group-work/Create-story.md +++ b/docs/en/md/VK/Group-work/Create-story.md @@ -39,7 +39,7 @@ sidebar_position: 7 ```sh title="CLI command example" - oint vk CreateStory --picture "https://openintegrations.dev/test_data/picture.jpg // URL, Path to file or Binary Data" --url "https://github.com/Bayselonarrend/OpenIntegrations" --auth "GetVKParameters()" + oint vk CreateStory --picture "https://openintegrations.dev/test_data/picture.jpg" --url %url% --auth %auth% ``` diff --git a/docs/en/md/VK/Group-work/Delete-album.md b/docs/en/md/VK/Group-work/Delete-album.md index 92da7b26e..3dcd105ef 100644 --- a/docs/en/md/VK/Group-work/Delete-album.md +++ b/docs/en/md/VK/Group-work/Delete-album.md @@ -28,7 +28,7 @@ sidebar_position: 6 ```sh title="CLI command example" - oint vk DeleteAlbum --album %album% --auth "GetVKParameters()" + oint vk DeleteAlbum --album %album% --auth %auth% ``` diff --git a/docs/en/md/VK/Group-work/Delete-image.md b/docs/en/md/VK/Group-work/Delete-image.md index 966554a18..6f974dc01 100644 --- a/docs/en/md/VK/Group-work/Delete-image.md +++ b/docs/en/md/VK/Group-work/Delete-image.md @@ -28,7 +28,7 @@ sidebar_position: 9 ```sh title="CLI command example" - oint vk DeleteImage --pictureid %pictureid% --auth "GetVKParameters()" + oint vk DeleteImage --pictureid %pictureid% --auth %auth% ``` diff --git a/docs/en/md/VK/Group-work/Delete-post.md b/docs/en/md/VK/Group-work/Delete-post.md index 72f92a7d4..f33b55978 100644 --- a/docs/en/md/VK/Group-work/Delete-post.md +++ b/docs/en/md/VK/Group-work/Delete-post.md @@ -28,7 +28,7 @@ sidebar_position: 3 ```sh title="CLI command example" - oint vk DeletePost --post %post% --auth "GetVKParameters()" + oint vk DeletePost --post %post% --auth %auth% ``` diff --git a/docs/en/md/VK/Group-work/Save-image-to-album.md b/docs/en/md/VK/Group-work/Save-image-to-album.md index 0a7bcea61..37042ae9c 100644 --- a/docs/en/md/VK/Group-work/Save-image-to-album.md +++ b/docs/en/md/VK/Group-work/Save-image-to-album.md @@ -43,7 +43,7 @@ sidebar_position: 8 ```sh title="CLI command example" - oint vk SaveImageToAlbum --album %album% --picture "https://openintegrations.dev/test_data/picture.jpg // URL, Path to file or Binary Data" --description %description% --auth "GetVKParameters()" + oint vk SaveImageToAlbum --album %album% --picture "https://openintegrations.dev/test_data/picture.jpg" --description %description% --auth %auth% ``` diff --git a/docs/en/md/VK/VK.md b/docs/en/md/VK/VK.md new file mode 100644 index 000000000..3eaf7f619 --- /dev/null +++ b/docs/en/md/VK/VK.md @@ -0,0 +1,94 @@ +--- +id: VK +sidebar_class_name: VK +--- + + + +# VKontakte + +Этот раздел поwithinящен библиотеtoе for work with VK API. Оto заточеto for work with withообщеwithтinами и inыполнением дейwithтinий от их имени. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work + +## Nачало work + +For of start work необходимо получить неtoоторые параметры for VK API. + +

+Перечень необходимых data in inиде withтруtoтуры withодержитwithя in фунtoции *GetStandardParameters()*. Inы можете уtoазыinать зtoчения parameters прямо in ней or же передаinать их withтруtoтурой при inызоinе любых других methodоin libraries in toачеwithтinе необязательного параметра *Parameters* (afterдний inо all methodх бorотеtoи). In afterднем withлучае withтандартные параметры будут перезапиwithаны по toлючам теми, toоторые переданы при inызоinе method. Перезапиwithаны будут тольtoо withоinпадающие по toлючам Data. If toаtoой то параметр еwithть in toборе withтандартных, но не был передан при inызоinе method, то он withохранит withтандартное value. +

+ + ```bsl + _Parameters = New Structure; + + _Parameters.Insert("v", "5.131"); + _Parameters.Insert("from_group", "1"); + _Parameters.Insert("group_id", "123456789"); + _Parameters.Insert("owner_id", "-123456789"); + _Parameters.Insert("app_id", "87654321"); + _Parameters.Insert("access_token", "vk1.a.E-byuFeG1qcN7..."); + + ``` + +Раwithwithмотрим получение each зtoчения: + +**1. v** + + Parameter v озtoчает inерwithию VK API. Testing проinодилоwithь to 5.131, реtoомендуетwithя его таtoим и оwithтаinить + +**2. from_group** + + От лица группы. Должен be 1 + +**3. group_id и owner_id** + + ID группы. If у inаwith withтандартный адреwith группы, то id можно toйти in URL. In протиinном withлучае он will to intoладtoе "Упраinление" in group, под полем Address. owner_id - тоже withамое, но withо зtotoом '-' inпереди + + ![BF](../../static/img/Docs/VK/1.png) + +**4. app_id** + + app_id - ID приложения. For withоздания приложения необходимо: + + * Goto по адреwithу https://id.vk.com/about/business/go, аinторfromоinатьwithя и ininеwithти withinои Data фfrom. or юр. лица + + ![BF](../../static/img/Docs/VK/2.png) + + * Ininеwithти name приложения и inыбрать пунtoт **Web** + + ![BF](../../static/img/Docs/VK/3.png) + + * Ininеwithти домееное имя и URL обработчиtoа переtoпраinлений. Тут нужно отметить, что данный механchange withоздания приложений - ноinый. Еще недаinно приложения VK withоздаinалиwithь иtoче и иметь redirect_url for них было не нужно. Nа данный момент не withоinwithем понятно, зачем он нужен toм for withерinерного приложения - проwithто таtoого понятия toаto withерinерное приложение у VK теперь нет. Теоретичеwithtoи, туда можно inпиwithать что угодно - for work with библиотеtoой in получении обратных data нет необходимоwithти. Одtotoо, with течением inремени, this может changeенитьwithя. + + ![BF](../../static/img/Docs/VK/4.png) + + * Ininеwithти паwithпортные Data or Data об органfromации, intoлючить доwithтуп to withообщеwithтinам (toороче, еwithли у inаwith уже было приложение до thisго, то inам toрупно поinезло, а еwithли нет роwithwithийwithtoого паwithпорта - придетwithя пиwithать in поддержtoу) + + ![BF](../../static/img/Docs/VK/8.png) + + * Get app_id to withтранице приложения + + ![BF](../../static/img/Docs/VK/5.png) + +**5. access_token** + + Сwithылtoу to получение acess_token можно получить при помощи фунtoции *CreateTokenRetrievalLink* or withtoлеить inручную: + + https://oauth.vk.com/authorize?client_id= + *app_id* + &scope=offline,wall,groups,photos,stats,stories,ads&v=5.131&response_type=token&redirect_uri=https://api.vk.com/blank.html + + * To thisй withwithылtoе необходимо перейти in браузере + * Authorfromоinатьwithя через VK и подтinердить доwithтуп + * Забрать тоtoен from параметра URL in адреwithной withтроtoе + + ![BF](../../static/img/Docs/VK/6.png) + +**(Дополнительно) communitytoken** + + Nottoоторые methodы, toпример for work with чат-ботом withообщеwithтinа, принимают in toачеwithтinе параметра communitytoken - in этих methodх он заменяет access_token. For его получения необходимо: + + * Зайти in раздел "Упраinление" in group VK + * Nайти intoладtoу "Work with API" + * Nажать "Создать toлюч" и забрать его + + ![BF](../../static/img/Docs/VK/7.png) + + WHile inам не нужно иwithпользоinать таtoие methodы, получать communitytoken не обязательно diff --git a/docs/en/md/VK/_category_.json b/docs/en/md/VK/_category_.json new file mode 100644 index 000000000..fa7385436 --- /dev/null +++ b/docs/en/md/VK/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "VK", + "position": 3, + "link": { + "type": "doc", + "id": "VK" + } +} diff --git a/docs/en/md/Viber/Viber.md b/docs/en/md/Viber/Viber.md new file mode 100644 index 000000000..02f7c38f1 --- /dev/null +++ b/docs/en/md/Viber/Viber.md @@ -0,0 +1,69 @@ +--- +id: Viber +sidebar_class_name: Viber +--- + + + +# Viber + +Этот раздел поwithinящен библиотеtoе for work with Viber API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work + +## Nачало work + +:::note + +Оwithобенноwithти work with Viber API + +1. Notльзя иwithпользоinать бота и упраinлять toаtoлом через API, еwithли не уwithтаноinлен Webhook + + In отличии от Telegram, toоторые позinоляют withамому забирать обноinления with withерinероin, а пиwithать и inоinwithе незаinиwithимо от thisго, Viber требует обязательного иwithпользоinания Webhook, т.е у inаwith должен be withерinер with inнешним IP и дейwithтinительный SSL withертифиtoат. If inерить доtoументации, Viber периодичеwithtoи will withтучать по адреwithу, уtoазанному toаto WH и еwithли он не получит отinет 200, то inwithе переwithтанет работать(**UPD:** Уже меwithяц нет http-withерinиwithа, но ничего не поломалоwithь). Requests от Viber могут обрабатыinатьwithя http-withерinиwithом or любым другим обработчиtoом for запроwithоin typeа POST, при уwithлоinии toличия SSL и доwithтупноwithти адреwithа frominне. If у inаwith еwithть таtoой адреwith, то уwithтаноinить Webhook можно при помощий фунtoции *SetWebhook()* данной libraries (withм. далее). Towithле уwithтаноintoи, у чат бота in приложении Viber пояinитwithя toнопtoа "Message" for of start диалога, а in toаtoл withтанет можно отпраinлять withообщения через REST Api. + +2. У Viber отwithутwithтinуют механchangeы upload inнешних fileоin to их withерinера + + Kартинtoи, fileы и доtoументы могут отпраinлятьwithя in Viber тольtoо in inиде URL. Т.е. for thisго тоже нужен withерinер or, toаto минимум, withторонний withерinиwith for публиtoации fileоin. Nо таto toаto withерinер уже in любом withлучае необходим for Webhook, отпраinляемые fileы можно inременно withохранять in папtoу inеб-withерinера. У IIS this папtoа wwwroot + +::: + +У Viber еwithть дinа REST API: один for work with toаtoлами, а inторой - for чат-ботоin. In обоих withлучаях mainоinными параметрами withлужат **Token** и **UserID** + +- If inам необходимо упраinлять toаtoлом: + 1. Зайдите in приложение Viber и withоздайте ноinый toаtoл + + ![BF](../../static/img/Docs/Viber/1.png) + + 2. Towithле withоздания, перейдите in towithтройtoи toаtoла -> "For разработчиtoоin", и withtoопируйте **Token** + + ![BF](../../static/img/Docs/Viber/2.png) + + 3. Уwithтаноinите Webhook. See. Set Webhook + 4. **UserID** - inаш ID (админиwithтратора toаtoла). See. Get channel information + +
+ +- If inам необходим чат-бот: + 1. Перейдите по withwithылtoе [https://partners.viber.com/account/create-bot-account](https://partners.viber.com/account/create-bot-account) и аinторfromуйтеwithь with inашим номером телефоto, toоторый приinязан to Viber + + ![BF](../../static/img/Docs/Viber/3.png) + + 2. Inыберите пунtoт withоздания ноinого бота + + ![BF](../../static/img/Docs/Viber/4.png) + + 3. In меню withоздания бота заполните inwithе необходимые fields + + ![BF](../../static/img/Docs/Viber/5.png) + + 4. Сtoопируйте **Token** + + ![BF](../../static/img/Docs/Viber/6.png) + + 4. Nайти withinоего ноinого бота inы можете отwithtoанироinаin QR to withтранице withоздания or in towithтройtoах (пунtoт чат-боты) in приложении Viber. + + ![BF](../../static/img/Docs/Viber/7.png) + + 5. Сейчаwith inы не можете toчать диалог with ботом, withof start необходимо уwithтаноinить Webhook. See. Set Webhook + 6. Towithле start **UserID** will ID toонtoретного челоinеtoа, inедущего диалог with ботом. Get можно from обworktoи incoming withообщения по Webhook + + + **Inажно:** ID одного и того же пользоinателя у чата и toаtoла - this разные зtoчения. Notльзя иwithпользоinать ID, полученный from withообщения боту for inызоinа methodоin упраinления toаtoлом и toоборот. diff --git a/docs/en/md/Viber/_category_.json b/docs/en/md/Viber/_category_.json new file mode 100644 index 000000000..bfc75ada7 --- /dev/null +++ b/docs/en/md/Viber/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Viber", + "position": 3, + "link": { + "type": "doc", + "id": "Viber" + } +} diff --git a/docs/en/md/Yandex_Disk/Yandex_Disk.md b/docs/en/md/Yandex_Disk/Yandex_Disk.md new file mode 100644 index 000000000..635dd0833 --- /dev/null +++ b/docs/en/md/Yandex_Disk/Yandex_Disk.md @@ -0,0 +1,62 @@ +--- +id: YandexDisk +sidebar_class_name: YandexDisk +--- + + + +# Яндеtowith Диwithto + +Этот раздел поwithinящен библиотеtoе for work with Яндеtowith Диwithto API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work + +## Nачало work + +For of start work необходимо получить тоtoен доwithтупа to диwithtoу: + +1. Перейдите to [page withоздания приложения](https://oauth.yandex.ru/client/new/) + +![BF](../../static/img/Docs/YandexDisk/1.png) + +2. Ininедите name withерinиwithа, inыберите *Inеб-withерinиwithы* in toачеwithтinе платформы. Redirect URI можно уtoазать любой or inыбрать пунtoт *Toдwithтаinить URL for отладtoи* - for work with библиотеtoой он не поtoдобитwithя. + +![BF](../../static/img/Docs/YandexDisk/3.png) + +3. In поле *Доwithтуп to данным* добаinьте разрешения toаto to withtoриншоте ниже, after чего toжмите *Создать приложение* + +![BF](../../static/img/Docs/YandexDisk/2.png) + +4. Сохраните **ClientID** и **Client secret** withо withтраницы приложения + +![BF](../../static/img/Docs/YandexDisk/4.png) + +5. Callите фунtoцию *OPI_YandexID.GetConfirmationCode()*, передаin ClientID in toачеwithтinе параметра. Оto inернет отinет withерinера Yandex, где будут fields + - **user_code** - необходимо will ininеwithти in браузере + - **device_code** - необходимо will передать in другую фунtoцию + - **verification_url** - URL, toоторый нужно отtoрыть in браузере +
+ ```json title="Result фунtoции GetConfirmationCode(), еwithли переinеwithти его in JSON" + { + "verification_url": "https://ya.ru/device", + "user_code": "gjehyruw", + "interval": 5, + "expires_in": 300, + "device_code": "12207cafec1b40ad8d0052af3faf0d12" + } + ``` + +6. Отtoройте URL from **verification_url** in барузере. Сtoорее inwithего this will https://ya.ru/device. In пояinиinшееwithя поле ininедите **user_code** from пунtoта 5 + +![BF](../../static/img/Docs/YandexDisk/5.png) + +7. Towithле ininода toода in пунtoте 6, inызоinите фунtoцию *OPI_YandexID.ConvertCodeToToken()*, передаin туда **ClientID** и **ClientSecret** from пунtoта 4, а таtoже **device_code** from пунtoта 5. Сохраните полученные **acess_token** и **refresh_token** + +```json title="Result фунtoции ConvertCodeToToken(), еwithли переinеwithти его in JSON" +{ + "token_type": "bearer", + "refresh_token": "1:Tj6nD2vgE2L8jwSm:YgWjQXPv6_y3e07GW70ig2AOyEXoRVsKKpApGHq2EOg7pfx0MKrXiCrfLBFtzgQawdawdwadad3Sasa9z2H0vSeZKNmZmA", + "expires_in": 31535956, + "access_token": "y0_AgAAAABWxxdkAAs0QgAAAAD59cawdawdwadadVKIiwGK__crw" +} +``` + +**acess_token** иwithпользуетwithя inо all оwithтальных фунtoциях libraries, а при помощи **refresh_token** его можно обноinить, toогда withроto жfromни will подходить to toонцу (при помощи фунtoции *RefreshToken()*) diff --git a/docs/en/md/Yandex_Disk/_category_.json b/docs/en/md/Yandex_Disk/_category_.json new file mode 100644 index 000000000..aab4e2160 --- /dev/null +++ b/docs/en/md/Yandex_Disk/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Yandex Disk", + "position": 13, + "link": { + "type": "doc", + "id": "YandexDisk" + } +} diff --git a/docs/en/md/Yandex_ID/Public/Convert-code-to-token.md b/docs/en/md/Yandex_ID/Public/Convert-code-to-token.md deleted file mode 100644 index 31cad273e..000000000 --- a/docs/en/md/Yandex_ID/Public/Convert-code-to-token.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Convert code to token - Converts the code to a token after entering the code when executing GetConfirmationCode - - -*Function ConvertCodeToToken(Val ClientId, Val ClientSecret, Val DeviceCode) Export* - - | Parameter | CLI option | Type | Destination | - |-|-|-|-| - | ClientId | --id | String | Client id | - | ClientSecret | --secret | String | Client secret | - | DeviceCode | --device | String | device_code from GetConfirmationCode() | - - - Returns: Key-Value Pair - serialized JSON response from Yandex - -```bsl title="Code example" - - - -``` - -```sh title="CLI command example" - - oint yandex ConvertCodeToToken --id %id% --secret %secret% --device %device% - -``` - - -```json title="Result" - - - -``` diff --git a/docs/en/md/Yandex_ID/Public/Get-confirmation-code.md b/docs/en/md/Yandex_ID/Public/Get-confirmation-code.md deleted file mode 100644 index 75fe4f87d..000000000 --- a/docs/en/md/Yandex_ID/Public/Get-confirmation-code.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -sidebar_position: 1 ---- - -# Get confirmation code - Gets the confirmation code and the address of the page where it needs to be entered - - -*Function GetConfirmationCode(Val ClientId) Export* - - | Parameter | CLI option | Type | Destination | - |-|-|-|-| - | ClientId | --id | String | Client id | - - - Returns: Key-Value Pair - serialized JSON response from Yandex - -```bsl title="Code example" - - - -``` - -```sh title="CLI command example" - - oint yandex GetConfirmationCode --id %id% - -``` - - -```json title="Result" - - - -``` diff --git a/docs/en/md/Yandex_ID/Public/Refresh-token.md b/docs/en/md/Yandex_ID/Public/Refresh-token.md deleted file mode 100644 index 593b9105e..000000000 --- a/docs/en/md/Yandex_ID/Public/Refresh-token.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -sidebar_position: 3 ---- - -# Refresh token - Updates token by Refresh token - - -*Function RefreshToken(Val ClientId, Val ClientSecret, Val RefreshToken) Export* - - | Parameter | CLI option | Type | Destination | - |-|-|-|-| - | ClientId | --id | String | Client id | - | ClientSecret | --secret | String | Client secret | - | RefreshToken | --refresh | String | Refresh token | - - - Returns: Key-Value Pair - serialized JSON response from Yandex - -```bsl title="Code example" - - - -``` - -```sh title="CLI command example" - - oint yandex RefreshToken --id %id% --secret %secret% --refresh %refresh% - -``` - - -```json title="Result" - - - -``` diff --git a/docs/en/md/Yandex_ID/Public/_category_.json b/docs/en/md/Yandex_ID/Public/_category_.json deleted file mode 100644 index 92dc94339..000000000 --- a/docs/en/md/Yandex_ID/Public/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ -"label": "Public", -"position": "2" -} diff --git a/docs/ru/data/Dropbox/ВосстановитьОбъектКВерсии.json b/docs/ru/data/Dropbox/ВосстановитьОбъектКВерсии.json index b35b34ec5..7ecb65325 100644 --- a/docs/ru/data/Dropbox/ВосстановитьОбъектКВерсии.json +++ b/docs/ru/data/Dropbox/ВосстановитьОбъектКВерсии.json @@ -1,5 +1,4 @@ { "Версия": "61a0b76320a6fbd841553", -"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", -"Путь": "/New/pic.png" +"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ДобавитьПользователейКПапке.json b/docs/ru/data/Dropbox/ДобавитьПользователейКПапке.json index 78dc7c169..3769b3a1c 100644 --- a/docs/ru/data/Dropbox/ДобавитьПользователейКПапке.json +++ b/docs/ru/data/Dropbox/ДобавитьПользователейКПапке.json @@ -1,5 +1,5 @@ { "Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", "Почта": "h5bk6ft62s@privaterelay.appleid.com", -"Папка": "5022319569 // shared_folder_id" +"Папка": "5022319569" } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ДобавитьТег.json b/docs/ru/data/Dropbox/ДобавитьТег.json index c88a7bc5c..487a2ee9c 100644 --- a/docs/ru/data/Dropbox/ДобавитьТег.json +++ b/docs/ru/data/Dropbox/ДобавитьТег.json @@ -1,5 +1,3 @@ { -"Тег": "Важное", -"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", -"Путь": "/New/mydoc.docx" +"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ЗагрузитьФайл.json b/docs/ru/data/Dropbox/ЗагрузитьФайл.json index 5022eb80d..847e7fee5 100644 --- a/docs/ru/data/Dropbox/ЗагрузитьФайл.json +++ b/docs/ru/data/Dropbox/ЗагрузитьФайл.json @@ -1,6 +1,4 @@ { -"Путь": "/New/pic.png", "Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", -"Картинка": "https://openintegrations.dev/test_data/picture.jpg", -"КартинкаПуть": "ПолучитьИмяВременногоФайла(png)" +"Картинка": "https://openintegrations.dev/test_data/picture.jpg" } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ЗагрузитьФайлПоURL.json b/docs/ru/data/Dropbox/ЗагрузитьФайлПоURL.json index ff0b2c7e1..1e708b3b8 100644 --- a/docs/ru/data/Dropbox/ЗагрузитьФайлПоURL.json +++ b/docs/ru/data/Dropbox/ЗагрузитьФайлПоURL.json @@ -1,5 +1,4 @@ { -"Путь": "/New/url_doc.docx", "Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", "URL": "https://openintegrations.dev/test_data/document.docx" } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/КопироватьОбъект.json b/docs/ru/data/Dropbox/КопироватьОбъект.json index 78136b1e9..487a2ee9c 100644 --- a/docs/ru/data/Dropbox/КопироватьОбъект.json +++ b/docs/ru/data/Dropbox/КопироватьОбъект.json @@ -1,5 +1,3 @@ { -"Оригинал": "/New/pic.png", -"Копия": "/New/pic_copy.png", "Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ОпубликоватьПапку.json b/docs/ru/data/Dropbox/ОпубликоватьПапку.json index d1f8f9fd4..487a2ee9c 100644 --- a/docs/ru/data/Dropbox/ОпубликоватьПапку.json +++ b/docs/ru/data/Dropbox/ОпубликоватьПапку.json @@ -1,4 +1,3 @@ { -"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", -"Путь": "/New" +"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ОтменитьПубликациюПапки.json b/docs/ru/data/Dropbox/ОтменитьПубликациюПапки.json index 14f4699fb..c67d08780 100644 --- a/docs/ru/data/Dropbox/ОтменитьПубликациюПапки.json +++ b/docs/ru/data/Dropbox/ОтменитьПубликациюПапки.json @@ -1,7 +1,4 @@ { "Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", -"Папка": "5022319569", -"ТекущийСтатус": "Результат[.tag]", -"IDРаботы": "Результат[async_job_id]", -"Пока ТекущийСтатус": "in_progress Цикл" +"Папка": "5022319569" } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ПереместитьОбъект.json b/docs/ru/data/Dropbox/ПереместитьОбъект.json index 587d5e57c..487a2ee9c 100644 --- a/docs/ru/data/Dropbox/ПереместитьОбъект.json +++ b/docs/ru/data/Dropbox/ПереместитьОбъект.json @@ -1,5 +1,3 @@ { -"ОригиналныйПуть": "/New/pic.png", -"ЦелевойПуть": "/pic.png", "Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ПолучитьИнформациюОбОбъекте.json b/docs/ru/data/Dropbox/ПолучитьИнформациюОбОбъекте.json index 7b3512cb2..487a2ee9c 100644 --- a/docs/ru/data/Dropbox/ПолучитьИнформациюОбОбъекте.json +++ b/docs/ru/data/Dropbox/ПолучитьИнформациюОбОбъекте.json @@ -1,4 +1,3 @@ { -"Путь": "/New/pic.png", "Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ПолучитьПревью.json b/docs/ru/data/Dropbox/ПолучитьПревью.json index 7792678db..487a2ee9c 100644 --- a/docs/ru/data/Dropbox/ПолучитьПревью.json +++ b/docs/ru/data/Dropbox/ПолучитьПревью.json @@ -1,4 +1,3 @@ { -"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", -"Путь": "/New/mydoc.docx" +"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ПолучитьСписокВерсийОбъекта.json b/docs/ru/data/Dropbox/ПолучитьСписокВерсийОбъекта.json index 557ae44cd..487a2ee9c 100644 --- a/docs/ru/data/Dropbox/ПолучитьСписокВерсийОбъекта.json +++ b/docs/ru/data/Dropbox/ПолучитьСписокВерсийОбъекта.json @@ -1,4 +1,3 @@ { -"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", -"Путь": "/New/pic.png" +"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ПолучитьСписокФайловПапки.json b/docs/ru/data/Dropbox/ПолучитьСписокФайловПапки.json index db249c1ba..487a2ee9c 100644 --- a/docs/ru/data/Dropbox/ПолучитьСписокФайловПапки.json +++ b/docs/ru/data/Dropbox/ПолучитьСписокФайловПапки.json @@ -1,4 +1,3 @@ { -"Путь": "/New", "Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ПолучитьСтатусЗагрузкиПоURL.json b/docs/ru/data/Dropbox/ПолучитьСтатусЗагрузкиПоURL.json index a91225906..63ff86414 100644 --- a/docs/ru/data/Dropbox/ПолучитьСтатусЗагрузкиПоURL.json +++ b/docs/ru/data/Dropbox/ПолучитьСтатусЗагрузкиПоURL.json @@ -1,6 +1,4 @@ { "Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", -"ИДРаботы": "G8YbueOu2nsAAAAAAAAAAQ", -"Статус": "Результат[.tag]", -"Пока Статус": "in_progress Цикл" +"ИДРаботы": "G8YbueOu2nsAAAAAAAAAAQ" } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/ПолчитьСписокТегов.json b/docs/ru/data/Dropbox/ПолчитьСписокТегов.json new file mode 100644 index 000000000..487a2ee9c --- /dev/null +++ b/docs/ru/data/Dropbox/ПолчитьСписокТегов.json @@ -0,0 +1,3 @@ +{ +"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." +} \ No newline at end of file diff --git a/docs/ru/data/Dropbox/СкачатьПапку.json b/docs/ru/data/Dropbox/СкачатьПапку.json index d1f8f9fd4..487a2ee9c 100644 --- a/docs/ru/data/Dropbox/СкачатьПапку.json +++ b/docs/ru/data/Dropbox/СкачатьПапку.json @@ -1,4 +1,3 @@ { -"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", -"Путь": "/New" +"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/СкачатьФайл.json b/docs/ru/data/Dropbox/СкачатьФайл.json index 557ae44cd..487a2ee9c 100644 --- a/docs/ru/data/Dropbox/СкачатьФайл.json +++ b/docs/ru/data/Dropbox/СкачатьФайл.json @@ -1,4 +1,3 @@ { -"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", -"Путь": "/New/pic.png" +"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/УдалитьОбъект.json b/docs/ru/data/Dropbox/УдалитьОбъект.json index 7b3512cb2..487a2ee9c 100644 --- a/docs/ru/data/Dropbox/УдалитьОбъект.json +++ b/docs/ru/data/Dropbox/УдалитьОбъект.json @@ -1,4 +1,3 @@ { -"Путь": "/New/pic.png", "Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Dropbox/УдалитьТег.json b/docs/ru/data/Dropbox/УдалитьТег.json index c88a7bc5c..487a2ee9c 100644 --- a/docs/ru/data/Dropbox/УдалитьТег.json +++ b/docs/ru/data/Dropbox/УдалитьТег.json @@ -1,5 +1,3 @@ { -"Тег": "Важное", -"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L...", -"Путь": "/New/mydoc.docx" +"Токен": "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." } \ No newline at end of file diff --git a/docs/ru/data/Telegram/ИзменитьТемуФорума.json b/docs/ru/data/Telegram/ИзменитьТемуФорума.json index 31b9faa80..96f6b43cd 100644 --- a/docs/ru/data/Telegram/ИзменитьТемуФорума.json +++ b/docs/ru/data/Telegram/ИзменитьТемуФорума.json @@ -1,6 +1,5 @@ { "Токен": "6129457865:AAFyzNYOAFbu...", "Чат": "-1001971186208", -"Тема": "2673", -"НовяИконка": "5310132165583840589" +"Тема": "2673" } \ No newline at end of file diff --git a/docs/ru/data/Telegram/ОтправитьАудио.json b/docs/ru/data/Telegram/ОтправитьАудио.json index 2553b70d5..ce3f9321d 100644 --- a/docs/ru/data/Telegram/ОтправитьАудио.json +++ b/docs/ru/data/Telegram/ОтправитьАудио.json @@ -3,6 +3,5 @@ "IDЧата": "461699897", "IDКанала": "@testsichee", "Текст": "Строковое значение", -"Аудио": "https://openintegrations.dev/test_data/song.mp3", -"АудиоПуть": "ПолучитьИмяВременногоФайла(mp3)" +"Аудио": "https://openintegrations.dev/test_data/song.mp3" } \ No newline at end of file diff --git a/docs/ru/data/Telegram/ОтправитьВидео.json b/docs/ru/data/Telegram/ОтправитьВидео.json index c21d81e5d..395de28aa 100644 --- a/docs/ru/data/Telegram/ОтправитьВидео.json +++ b/docs/ru/data/Telegram/ОтправитьВидео.json @@ -3,6 +3,5 @@ "IDЧата": "461699897", "IDКанала": "@testsichee", "Текст": "Строковое значение", -"Видео": "https://openintegrations.dev/test_data/video.mp4", -"ВидеоПуть": "ПолучитьИмяВременногоФайла(mp4)" +"Видео": "https://openintegrations.dev/test_data/video.mp4" } \ No newline at end of file diff --git a/docs/ru/data/Telegram/ОтправитьГифку.json b/docs/ru/data/Telegram/ОтправитьГифку.json index d07dbb72e..6104ebf05 100644 --- a/docs/ru/data/Telegram/ОтправитьГифку.json +++ b/docs/ru/data/Telegram/ОтправитьГифку.json @@ -3,6 +3,5 @@ "IDЧата": "461699897", "IDКанала": "@testsichee", "Текст": "Строковое значение", -"Гифка": "https://openintegrations.dev/test_data/animation.gif", -"ГифкаПуть": "ПолучитьИмяВременногоФайла(gif)" +"Гифка": "https://openintegrations.dev/test_data/animation.gif" } \ No newline at end of file diff --git a/docs/ru/data/Telegram/ОтправитьДокумент.json b/docs/ru/data/Telegram/ОтправитьДокумент.json index e10572085..9bb4885fd 100644 --- a/docs/ru/data/Telegram/ОтправитьДокумент.json +++ b/docs/ru/data/Telegram/ОтправитьДокумент.json @@ -3,6 +3,5 @@ "IDЧата": "461699897", "IDКанала": "@testsichee", "Текст": "Строковое значение", -"Документ": "https://openintegrations.dev/test_data/document.docx", -"ДокументПуть": "ПолучитьИмяВременногоФайла(docx)" +"Документ": "https://openintegrations.dev/test_data/document.docx" } \ No newline at end of file diff --git a/docs/ru/data/Telegram/ОтправитьКартинку.json b/docs/ru/data/Telegram/ОтправитьКартинку.json index b763c2c3d..c568624ed 100644 --- a/docs/ru/data/Telegram/ОтправитьКартинку.json +++ b/docs/ru/data/Telegram/ОтправитьКартинку.json @@ -3,6 +3,5 @@ "IDЧата": "461699897", "IDКанала": "@testsichee", "Текст": "Строковое значение", -"Картинка": "https://openintegrations.dev/test_data/picture.jpg", -"КартинкаПуть": "ПолучитьИмяВременногоФайла(png)" +"Картинка": "https://openintegrations.dev/test_data/picture.jpg" } \ No newline at end of file diff --git a/docs/ru/data/Telegram/ОтправитьМеидагруппу.json b/docs/ru/data/Telegram/ОтправитьМеидагруппу.json new file mode 100644 index 000000000..20334df08 --- /dev/null +++ b/docs/ru/data/Telegram/ОтправитьМеидагруппу.json @@ -0,0 +1,7 @@ +{ +"Токен": "6129457865:AAFyzNYOAFbu...", +"IDЧата": "461699897", +"Текст": "Строковое значение", +"Картинка": "https://openintegrations.dev/test_data/picture.jpg", +"Видео": "https://openintegrations.dev/test_data/video.mp4" +} \ No newline at end of file diff --git a/docs/ru/data/Telegram/ОтправитьОпрос.json b/docs/ru/data/Telegram/ОтправитьОпрос.json index f7a9291fc..c21944b52 100644 --- a/docs/ru/data/Telegram/ОтправитьОпрос.json +++ b/docs/ru/data/Telegram/ОтправитьОпрос.json @@ -1,6 +1,5 @@ { "Токен": "6129457865:AAFyzNYOAFbu...", "IDЧата": "461699897", -"IDКанала": "@testsichee", -"Вопрос": "Какой ваш любимый цвет?" +"IDКанала": "@testsichee" } \ No newline at end of file diff --git a/docs/ru/data/Telegram/ПолучитьСписокАватаровФорума.json b/docs/ru/data/Telegram/ПолучитьСписокАватаровФорума.json new file mode 100644 index 000000000..b243d345e --- /dev/null +++ b/docs/ru/data/Telegram/ПолучитьСписокАватаровФорума.json @@ -0,0 +1,3 @@ +{ +"Токен": "6129457865:AAFyzNYOAFbu..." +} \ No newline at end of file diff --git a/docs/ru/data/Telegram/СоздатьСсылкуПриглашение.json b/docs/ru/data/Telegram/СоздатьСсылкуПриглашение.json index 90e9d27b6..dc417274c 100644 --- a/docs/ru/data/Telegram/СоздатьСсылкуПриглашение.json +++ b/docs/ru/data/Telegram/СоздатьСсылкуПриглашение.json @@ -1,7 +1,4 @@ { "Токен": "6129457865:AAFyzNYOAFbu...", -"IDКанала": "@testsichee", -"Сутки": "86400", -"Заголовок": "Ссылка + Строка(ТекущаяДата)", -"Истечение": "ТекущаяДата + Сутки" +"IDКанала": "@testsichee" } \ No newline at end of file diff --git a/docs/ru/data/Telegram/СоздатьТемуФорума.json b/docs/ru/data/Telegram/СоздатьТемуФорума.json index 29608a50d..61ec687dd 100644 --- a/docs/ru/data/Telegram/СоздатьТемуФорума.json +++ b/docs/ru/data/Telegram/СоздатьТемуФорума.json @@ -1,5 +1,4 @@ { "Токен": "6129457865:AAFyzNYOAFbu...", -"Чат": "-1001971186208", -"Иконка": "5357419403325481346" +"Чат": "-1001971186208" } \ No newline at end of file diff --git a/docs/ru/data/VK/ЗакрытьОбсуждение.json b/docs/ru/data/VK/ЗакрытьОбсуждение.json index 8880d71fd..d5a421e45 100644 --- a/docs/ru/data/VK/ЗакрытьОбсуждение.json +++ b/docs/ru/data/VK/ЗакрытьОбсуждение.json @@ -1,4 +1,3 @@ { -"Параметры": "ПолучитьПараметрыВК()", -"ИДОбсуждения": "51206275" +"ИДОбсуждения": 51206275 } \ No newline at end of file diff --git a/docs/ru/data/VK/НаписатьВОбсуждение.json b/docs/ru/data/VK/НаписатьВОбсуждение.json index bdb0ec9c4..d5a421e45 100644 --- a/docs/ru/data/VK/НаписатьВОбсуждение.json +++ b/docs/ru/data/VK/НаписатьВОбсуждение.json @@ -1,5 +1,3 @@ { -"Параметры": "ПолучитьПараметрыВК()", -"ИДОбсуждения": "51206275", -"Сообщение": "Мне больше нравится желтый" +"ИДОбсуждения": 51206275 } \ No newline at end of file diff --git a/docs/ru/data/VK/ОткрытьОбсуждение.json b/docs/ru/data/VK/ОткрытьОбсуждение.json index 8880d71fd..d5a421e45 100644 --- a/docs/ru/data/VK/ОткрытьОбсуждение.json +++ b/docs/ru/data/VK/ОткрытьОбсуждение.json @@ -1,4 +1,3 @@ { -"Параметры": "ПолучитьПараметрыВК()", -"ИДОбсуждения": "51206275" +"ИДОбсуждения": 51206275 } \ No newline at end of file diff --git a/docs/ru/data/VK/СоздатьИсторию.json b/docs/ru/data/VK/СоздатьИсторию.json index b7ef4013f..01b414bbe 100644 --- a/docs/ru/data/VK/СоздатьИсторию.json +++ b/docs/ru/data/VK/СоздатьИсторию.json @@ -1,6 +1,3 @@ { -"Параметры": "ПолучитьПараметрыВК()", -"URL": "https://github.com/Bayselonarrend/OpenIntegrations", -"Картинка": "https://openintegrations.dev/test_data/picture.jpg // URL, Путь к файлу или Двоичные данные", -"ИВФ": "ПолучитьИмяВременногоФайла(png)" +"Картинка": "https://openintegrations.dev/test_data/picture.jpg" } \ No newline at end of file diff --git a/docs/ru/data/VK/СоздатьПост.json b/docs/ru/data/VK/СоздатьПост.json index cfa678d92..5348694a2 100644 --- a/docs/ru/data/VK/СоздатьПост.json +++ b/docs/ru/data/VK/СоздатьПост.json @@ -1,8 +1,4 @@ { -"Параметры": "ПолучитьПараметрыВК()", -"Текст": "Пост из автотеста", -"URL": "https://github.com/Bayselonarrend/OpenIntegrations", -"Картинка": "https://openintegrations.dev/test_data/picture.jpg // URL, Путь или Двоичные данные", -"Картинка2": "https://openintegrations.dev/test_data/picture2.jpg // URL, Путь или Двоичные данные", -"ИВФ": "ПолучитьИмяВременногоФайла(png)" +"Картинка": "https://openintegrations.dev/test_data/picture.jpg", +"Картинка2": "https://openintegrations.dev/test_data/picture2.jpg" } \ No newline at end of file diff --git a/docs/ru/data/VK/СоздатьСоставнойПост.json b/docs/ru/data/VK/СоздатьСоставнойПост.json index e57e02a94..c5534d99c 100644 --- a/docs/ru/data/VK/СоздатьСоставнойПост.json +++ b/docs/ru/data/VK/СоздатьСоставнойПост.json @@ -1,8 +1,4 @@ { -"Параметры": "ПолучитьПараметрыВК()", -"Текст": "Пост из автотеста", -"URL": "https://github.com/Bayselonarrend/OpenIntegrations", -"Картинка": "https://openintegrations.dev/test_data/picture.jpg // URL, Путь или Двоичные данные", -"Видео": "https://openintegrations.dev/test_data/video.mp4 // URL, Путь или Двоичные данные", -"ИВФ": "ПолучитьИмяВременногоФайла(png)" +"Картинка": "https://openintegrations.dev/test_data/picture.jpg", +"Видео": "https://openintegrations.dev/test_data/video.mp4" } \ No newline at end of file diff --git a/docs/ru/data/VK/СохранитьКартинкуВАльбом.json b/docs/ru/data/VK/СохранитьКартинкуВАльбом.json index 964d675bb..b01083ea2 100644 --- a/docs/ru/data/VK/СохранитьКартинкуВАльбом.json +++ b/docs/ru/data/VK/СохранитьКартинкуВАльбом.json @@ -1,7 +1,4 @@ { -"Параметры": "ПолучитьПараметрыВК()", -"ОписаниеКартинки": "Картинка автотест", -"ИДАльбома": "304549394", -"Картинка": "https://openintegrations.dev/test_data/picture.jpg // URL, Путь к файлу или Двоичные данные", -"ИВФ": "ПолучитьИмяВременногоФайла(png)" +"ИДАльбома": 304549394, +"Картинка": "https://openintegrations.dev/test_data/picture.jpg" } \ No newline at end of file diff --git a/docs/ru/data/VK/УдалитьАльбом.json b/docs/ru/data/VK/УдалитьАльбом.json index e98495b26..7e267cfa3 100644 --- a/docs/ru/data/VK/УдалитьАльбом.json +++ b/docs/ru/data/VK/УдалитьАльбом.json @@ -1,4 +1,3 @@ { -"Параметры": "ПолучитьПараметрыВК()", -"ИДАльбома": "304549394" +"ИДАльбома": 304549394 } \ No newline at end of file diff --git a/docs/ru/data/VK/УдалитьКартинку.json b/docs/ru/data/VK/УдалитьКартинку.json index 3e42b710f..1752f2bc6 100644 --- a/docs/ru/data/VK/УдалитьКартинку.json +++ b/docs/ru/data/VK/УдалитьКартинку.json @@ -1,4 +1,3 @@ { -"Параметры": "ПолучитьПараметрыВК()", -"ИДКартинки": "457244340" +"ИДКартинки": 457244340 } \ No newline at end of file diff --git a/docs/ru/data/VK/УдалитьПост.json b/docs/ru/data/VK/УдалитьПост.json index b1ad4234a..8f19bdd75 100644 --- a/docs/ru/data/VK/УдалитьПост.json +++ b/docs/ru/data/VK/УдалитьПост.json @@ -1,4 +1,3 @@ { -"Параметры": "ПолучитьПараметрыВК()", "ИДПоста": "2304" } \ No newline at end of file diff --git a/docs/ru/md/Airtable/Airtable.md b/docs/ru/md/Airtable/Airtable.md new file mode 100644 index 000000000..962257fae --- /dev/null +++ b/docs/ru/md/Airtable/Airtable.md @@ -0,0 +1,24 @@ +--- +id: Airtable +sidebar_class_name: Airtable +--- + + + +# Airtable + +Этот раздел посвящен библиотеке для работы с Airtable API. На данной странице описаны все действия, необходимые для полноценного начала работы + +## Начало работы + +1. Авторизуйтесь в Airtable и перейдите **[на страницу создания персональных токенов](https://airtable.com/create/tokens)**, нажмите **Create new token** + +![BF](../../static/img/Docs/Airtable/1.png) + +2. Введите название для нового токена, выберите из перечня необходимые **Scopes** (разрешения) и **Acess** (базы и рабочие пространства, к которым у токена будет доступ) + +![BF](../../static/img/Docs/Airtable/2.png) + +3. Скопируйте новый **токен** + +![BF](../../static/img/Docs/Airtable/3.png) diff --git a/docs/ru/md/Airtable/_category_.json b/docs/ru/md/Airtable/_category_.json new file mode 100644 index 000000000..8975594d6 --- /dev/null +++ b/docs/ru/md/Airtable/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Airtable", + "position": 11, + "link": { + "type": "doc", + "id": "Airtable" + } +} diff --git a/docs/ru/md/Dropbox/File-and-directory-management/Delete-object.md b/docs/ru/md/Dropbox/File-and-directory-management/Delete-object.md index c08061d95..3cb911705 100644 --- a/docs/ru/md/Dropbox/File-and-directory-management/Delete-object.md +++ b/docs/ru/md/Dropbox/File-and-directory-management/Delete-object.md @@ -29,7 +29,7 @@ sidebar_position: 7 ```sh title="Пример команды CLI" - oint dropbox УдалитьОбъект --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/pic.png" --permanently %permanently% + oint dropbox УдалитьОбъект --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --permanently %permanently% ``` diff --git a/docs/ru/md/Dropbox/File-and-directory-management/Download-file.md b/docs/ru/md/Dropbox/File-and-directory-management/Download-file.md index bbf146b5d..2075e2369 100644 --- a/docs/ru/md/Dropbox/File-and-directory-management/Download-file.md +++ b/docs/ru/md/Dropbox/File-and-directory-management/Download-file.md @@ -28,7 +28,7 @@ sidebar_position: 11 ```sh title="Пример команды CLI" - oint dropbox СкачатьФайл --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/pic.png" + oint dropbox СкачатьФайл --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% ``` diff --git a/docs/ru/md/Dropbox/File-and-directory-management/Download-folder.md b/docs/ru/md/Dropbox/File-and-directory-management/Download-folder.md index 9082faddb..598e56f0d 100644 --- a/docs/ru/md/Dropbox/File-and-directory-management/Download-folder.md +++ b/docs/ru/md/Dropbox/File-and-directory-management/Download-folder.md @@ -28,7 +28,7 @@ sidebar_position: 12 ```sh title="Пример команды CLI" - oint dropbox СкачатьПапку --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New" + oint dropbox СкачатьПапку --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% ``` diff --git a/docs/ru/md/Dropbox/File-and-directory-management/Get-list-of-folder-files.md b/docs/ru/md/Dropbox/File-and-directory-management/Get-list-of-folder-files.md index df7933fca..94613f359 100644 --- a/docs/ru/md/Dropbox/File-and-directory-management/Get-list-of-folder-files.md +++ b/docs/ru/md/Dropbox/File-and-directory-management/Get-list-of-folder-files.md @@ -30,7 +30,7 @@ sidebar_position: 2 ```sh title="Пример команды CLI" - oint dropbox ПолучитьСписокФайловПапки --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New" --detail %detail% --cursor %cursor% + oint dropbox ПолучитьСписокФайловПапки --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --detail %detail% --cursor %cursor% ``` diff --git a/docs/ru/md/Dropbox/File-and-directory-management/Get-object-information.md b/docs/ru/md/Dropbox/File-and-directory-management/Get-object-information.md index 1ea998df8..9ae17c545 100644 --- a/docs/ru/md/Dropbox/File-and-directory-management/Get-object-information.md +++ b/docs/ru/md/Dropbox/File-and-directory-management/Get-object-information.md @@ -29,7 +29,7 @@ sidebar_position: 1 ```sh title="Пример команды CLI" - oint dropbox ПолучитьИнформациюОбОбъекте --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/pic.png" --detail %detail% + oint dropbox ПолучитьИнформациюОбОбъекте --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --detail %detail% ``` diff --git a/docs/ru/md/Dropbox/File-and-directory-management/Get-object-version-list.md b/docs/ru/md/Dropbox/File-and-directory-management/Get-object-version-list.md index ecccfcf66..3a97faced 100644 --- a/docs/ru/md/Dropbox/File-and-directory-management/Get-object-version-list.md +++ b/docs/ru/md/Dropbox/File-and-directory-management/Get-object-version-list.md @@ -29,7 +29,7 @@ sidebar_position: 13 ```sh title="Пример команды CLI" - oint dropbox ПолучитьСписокВерсийОбъекта --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/pic.png" --amount %amount% + oint dropbox ПолучитьСписокВерсийОбъекта --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --amount %amount% ``` diff --git a/docs/ru/md/Dropbox/File-and-directory-management/Get-preview.md b/docs/ru/md/Dropbox/File-and-directory-management/Get-preview.md index f78045593..387c82647 100644 --- a/docs/ru/md/Dropbox/File-and-directory-management/Get-preview.md +++ b/docs/ru/md/Dropbox/File-and-directory-management/Get-preview.md @@ -28,7 +28,7 @@ sidebar_position: 3 ```sh title="Пример команды CLI" - oint dropbox ПолучитьПревью --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/mydoc.docx" + oint dropbox ПолучитьПревью --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% ``` diff --git a/docs/ru/md/Dropbox/File-and-directory-management/Restore-object-to-version.md b/docs/ru/md/Dropbox/File-and-directory-management/Restore-object-to-version.md index 3a1b0f231..df694eeb0 100644 --- a/docs/ru/md/Dropbox/File-and-directory-management/Restore-object-to-version.md +++ b/docs/ru/md/Dropbox/File-and-directory-management/Restore-object-to-version.md @@ -30,7 +30,7 @@ sidebar_position: 14 ```sh title="Пример команды CLI" - oint dropbox ВосстановитьОбъектКВерсии --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/pic.png" --rev "61a0b76320a6fbd841553" + oint dropbox ВосстановитьОбъектКВерсии --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --rev "61a0b76320a6fbd841553" ``` diff --git a/docs/ru/md/Dropbox/File-and-directory-management/Upload-file-by-url.md b/docs/ru/md/Dropbox/File-and-directory-management/Upload-file-by-url.md index c1b93c532..7b0267b0a 100644 --- a/docs/ru/md/Dropbox/File-and-directory-management/Upload-file-by-url.md +++ b/docs/ru/md/Dropbox/File-and-directory-management/Upload-file-by-url.md @@ -30,7 +30,7 @@ sidebar_position: 5 ```sh title="Пример команды CLI" - oint dropbox ЗагрузитьФайлПоURL --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --url %url% --path "/New/url_doc.docx" + oint dropbox ЗагрузитьФайлПоURL --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --url %url% --path %path% ``` diff --git a/docs/ru/md/Dropbox/File-and-directory-management/Upload-file.md b/docs/ru/md/Dropbox/File-and-directory-management/Upload-file.md index b89de7c1d..55bfa6b7f 100644 --- a/docs/ru/md/Dropbox/File-and-directory-management/Upload-file.md +++ b/docs/ru/md/Dropbox/File-and-directory-management/Upload-file.md @@ -34,7 +34,7 @@ sidebar_position: 4 ```sh title="Пример команды CLI" - oint dropbox ЗагрузитьФайл --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --file %file% --path "/New/pic.png" --overwrite %overwrite% + oint dropbox ЗагрузитьФайл --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --file %file% --path %path% --overwrite %overwrite% ``` diff --git a/docs/ru/md/Dropbox/Shared-access-settings/Publish-folder.md b/docs/ru/md/Dropbox/Shared-access-settings/Publish-folder.md index 8e01dd9bd..1f5d8472e 100644 --- a/docs/ru/md/Dropbox/Shared-access-settings/Publish-folder.md +++ b/docs/ru/md/Dropbox/Shared-access-settings/Publish-folder.md @@ -28,7 +28,7 @@ sidebar_position: 1 ```sh title="Пример команды CLI" - oint dropbox ОпубликоватьПапку --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New" + oint dropbox ОпубликоватьПапку --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% ``` diff --git a/docs/ru/md/Dropbox/Tag-work/Add-tag.md b/docs/ru/md/Dropbox/Tag-work/Add-tag.md index d1a3e3ae4..31919a0c7 100644 --- a/docs/ru/md/Dropbox/Tag-work/Add-tag.md +++ b/docs/ru/md/Dropbox/Tag-work/Add-tag.md @@ -30,7 +30,7 @@ sidebar_position: 2 ```sh title="Пример команды CLI" - oint dropbox ДобавитьТег --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/mydoc.docx" --tag "Важное" + oint dropbox ДобавитьТег --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --tag %tag% ``` diff --git a/docs/ru/md/Dropbox/Tag-work/Delete-tag.md b/docs/ru/md/Dropbox/Tag-work/Delete-tag.md index 61a9a07c8..b0719c94f 100644 --- a/docs/ru/md/Dropbox/Tag-work/Delete-tag.md +++ b/docs/ru/md/Dropbox/Tag-work/Delete-tag.md @@ -30,7 +30,7 @@ sidebar_position: 3 ```sh title="Пример команды CLI" - oint dropbox УдалитьТег --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path "/New/mydoc.docx" --tag "Важное" + oint dropbox УдалитьТег --token "sl.B2ieEHcB9I9BTwJFjbf_MQtoZMKjGYgkpBqzQkvBfuSz41Qpy5r3d7a4ax22I5ILWhd9KLbN5L..." --path %path% --tag %tag% ``` diff --git a/docs/ru/md/Google_Calendar/Google_Calendar.md b/docs/ru/md/Google_Calendar/Google_Calendar.md new file mode 100644 index 000000000..3db2d5669 --- /dev/null +++ b/docs/ru/md/Google_Calendar/Google_Calendar.md @@ -0,0 +1,98 @@ +--- +id: GoogleCalendar +sidebar_class_name: GoogleCalendar +--- + + + +# Google Календарь + +Этот раздел посвящен библиотеке для работы с API Google Календаря. На данной странице описаны все действия, необходимые для полноценного начала работы + +:::important +Если вы уже используете ОПИ для работы с другими сервисами Google Workspase и выполняли стартовую настройку, то пункты **Создание проекта** и **Настройка OAuth** можно пропустить. Необходимо лишь **включить сервис Google Drive** в своем проекте и **заново получить токен** (последние два пункта инструкции). +::: + +## Начало работы + +
+ +### Создание проекта + +1. Перейдите на [главную страницу Google Cloud](https://console.cloud.google.com) и создайте проект + +![BF](../../static/img/Docs/GoogleCalendar/1.png) + +2. Выберите созданный проект и в боковом меню перейдите APIs and Services -> OAuth consent screen + +![BF](../../static/img/Docs/GoogleCalendar/2.png) + +3. Выберите пункт External + +![BF](../../static/img/Docs/GoogleCalendar/3.png) + +4. Заполните поля App name, User support email и Email addresses (все поля со звездочками) + +![BF](../../static/img/Docs/GoogleCalendar/4.png) + +5. Нажимайте далее и Save and continue на последней вкладке + +![BF](../../static/img/Docs/GoogleCalendar/5.png) + +6. Нажмите Publish App + +![BF](../../static/img/Docs/GoogleCalendar/6.png) + +
+ +### Настройка OAuth + +1. В боковом меню выберите пункт Credentials -> Create Credentials -> OAuth client ID + +![BF](../../static/img/Docs/GoogleCalendar/7.png) + +2. Введите имя и выберите Application type - Desktop app + +![BF](../../static/img/Docs/GoogleCalendar/8.png) + +3. Сохраните ClientID и Client Secret + +![BF](../../static/img/Docs/GoogleCalendar/9.png) + +
+ +### Включение сервиса 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.СформироватьСсылкуПолученияКода() с булево параметрами используемых вами сервисов. Результатом функции будет URL, который необходимо открыть в браузере. Авторизуйтесь при помощи своего аккаунта Google + +![BF](../../static/img/Docs/GoogleCalendar/10.png) + +2. Скопируйте код из URL после авторизации + +![BF](../../static/img/Docs/GoogleCalendar/11.png) + +3. Используйте полученный код, ClientID и Client Secret для вызова функции OPI_GoogleWorkspace.ПолучитьТокенПоКоду(ClientID, ClientSecret, Code) + +```json title="Результат функции ПолучитьТокенПоКоду(), если перевести его в JSON" + +{ + "token_type": "Bearer", + "refresh_token": "1//09au6OES3JN9oCgYIARAAGAkSNwF-L9Ir1B7uawfwafT1wE0FKO519Xj6JxawfawfyjMyJ_QlUZYLHZqw", + "scope": "https://www.googleapis.com/auth/calendar", + "expires_in": 3599, + "access_token": "ya29.a0AfB_byA344tXkIawdawdwadadhyZQV8bSZn_snNXtY2HLb7l71awdawdawdad-ASgpzyOSWIvEmPruhUa_1yCCq6jvoD0r_q-fNEsARrH8zpJ3c6LNGWvwdg8CXsSxYaCgYKAWkSawfwafawfrCK0EP5kZY_A0171" +} + +``` + +4. Используйте **access_token** для передачи в качестве параметра Токен при вызове функций библиотеки, а refresh_token - для получения нового access_token (функция OPI_GoogleWorkspace.ОбновитьТокен(ClientID, ClientSecret, RefreshToken)), когда время жизни старого истечет. При обновлении токена refresh_token не обновляется - вы можете использовать его один и тот же для получения нового access_token каждый раз. diff --git a/docs/ru/md/Google_Calendar/_category_.json b/docs/ru/md/Google_Calendar/_category_.json new file mode 100644 index 000000000..dc31538b5 --- /dev/null +++ b/docs/ru/md/Google_Calendar/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Google Calendar", + "position": 7, + "link": { + "type": "doc", + "id": "GoogleCalendar" + } +} diff --git a/docs/ru/md/Google_Drive/Google_Drive.md b/docs/ru/md/Google_Drive/Google_Drive.md new file mode 100644 index 000000000..8d897ad8b --- /dev/null +++ b/docs/ru/md/Google_Drive/Google_Drive.md @@ -0,0 +1,98 @@ +--- +id: GoogleDrive +sidebar_class_name: GoogleDrive +--- + + + +# Google Drive + +Этот раздел посвящен библиотеке для работы с API Google Drive. На данной странице описаны все действия, необходимые для полноценного начала работы + +:::important +Если вы уже используете ОПИ для работы с другими сервисами Google Workspase и выполняли стартовую настройку, то пункты **Создание проекта** и **Настройка OAuth** можно пропустить. Необходимо лишь **включить сервис Google Drive** в своем проекте и **заново получить токен** (последние два пункта инструкции). +::: + +## Начало работы + +
+ +### Создание проекта + +1. Перейдите на [главную страницу Google Cloud](https://console.cloud.google.com) и создайте проект + +![BF](../../static/img/Docs/GoogleCalendar/1.png) + +2. Выберите созданный проект и в боковом меню перейдите APIs and Services -> OAuth consent screen + +![BF](../../static/img/Docs/GoogleCalendar/2.png) + +3. Выберите пункт External + +![BF](../../static/img/Docs/GoogleCalendar/3.png) + +4. Заполните поля App name, User support email и Email addresses (все поля со звездочками) + +![BF](../../static/img/Docs/GoogleCalendar/4.png) + +5. Нажимайте далее и Save and continue на последней вкладке + +![BF](../../static/img/Docs/GoogleCalendar/5.png) + +6. Нажмите Publish App + +![BF](../../static/img/Docs/GoogleCalendar/6.png) + +
+ +### Настройка OAuth + +1. В боковом меню выберите пункт Credentials -> Create Credentials -> OAuth client ID + +![BF](../../static/img/Docs/GoogleCalendar/7.png) + +2. Введите имя и выберите Application type - Desktop app + +![BF](../../static/img/Docs/GoogleCalendar/8.png) + +3. Сохраните ClientID и Client Secret + +![BF](../../static/img/Docs/GoogleCalendar/9.png) + +
+ +### Включение сервиса Google Drive + +1. Перейдите на [страницу Drive в Marketplace](https://console.cloud.google.com/marketplace/product/google/drive.googleapis.com) + +2. Нажмите Enable + +![BF](../../static/img/Docs/GoogleDrive/1.png) + +
+ +### Получение Токена + +1. Передайте ClientID в функцию OPI_GoogleWorkspace.СформироватьСсылкуПолученияКода() с булево параметрами используемых вами сервисов. Результатом функции будет URL, который необходимо открыть в браузере. Авторизуйтесь при помощи своего аккаунта Google + +![BF](../../static/img/Docs/GoogleCalendar/10.png) + +2. Скопируйте код из URL после авторизации + +![BF](../../static/img/Docs/GoogleCalendar/11.png) + +3. Используйте полученный код, ClientID и Client Secret для вызова функции OPI_GoogleWorkspace.ПолучитьТокенПоКоду(ClientID, ClientSecret, Code) + +```json title="Результат функции ПолучитьТокенПоКоду(), если перевести его в JSON" + +{ + "token_type": "Bearer", + "refresh_token": "1//09au6OES3JN9oCgYIARAAGAkSNwF-L9Ir1B7uawfwafT1wE0FKO519Xj6JxawfawfyjMyJ_QlUZYLHZqw", + "scope": "https://www.googleapis.com/auth/...", + "expires_in": 3599, + "access_token": "ya29.a0AfB_byA344tXkIawdawdwadadhyZQV8bSZn_snNXtY2HLb7l71awdawdawdad-ASgpzyOSWIvEmPruhUa_1yCCq6jvoD0r_q-fNEsARrH8zpJ3c6LNGWvwdg8CXsSxYaCgYKAWkSawfwafawfrCK0EP5kZY_A0171" +} + +``` + +4. Используйте **access_token** для передачи в качестве параметра Токен при вызове функций библиотеки, а refresh_token - для получения нового access_token (функция OPI_GoogleWorkspace.ОбновитьТокен(ClientID, ClientSecret, RefreshToken)), когда время жизни старого истечет. При обновлении токена refresh_token не обновляется - вы можете использовать его один и тот же для получения нового access_token каждый раз. diff --git a/docs/ru/md/Google_Drive/_category_.json b/docs/ru/md/Google_Drive/_category_.json new file mode 100644 index 000000000..b08b67577 --- /dev/null +++ b/docs/ru/md/Google_Drive/_category_.json @@ -0,0 +1,10 @@ + +{ + "label": "Google Drive", + "position": 8, + "link": { + "type": "doc", + "id": "GoogleDrive" + } +} + diff --git a/docs/ru/md/Google_Sheets/Google_Sheets.md b/docs/ru/md/Google_Sheets/Google_Sheets.md new file mode 100644 index 000000000..28c96aa9d --- /dev/null +++ b/docs/ru/md/Google_Sheets/Google_Sheets.md @@ -0,0 +1,98 @@ +--- +id: GoogleSheets +sidebar_class_name: GoogleSheets +--- + + + +# Google Sheets + +Этот раздел посвящен библиотеке для работы с API Google Sheets. На данной странице описаны все действия, необходимые для полноценного начала работы + +:::important +Если вы уже используете ОПИ для работы с другими сервисами Google Workspase и выполняли стартовую настройку, то пункты **Создание проекта** и **Настройка OAuth** можно пропустить. Необходимо лишь **включить сервис Google Sheets** в своем проекте и **заново получить токен** (последние два пункта инструкции). +::: + +## Начало работы + +
+ +### Создание проекта + +1. Перейдите на [главную страницу Google Cloud](https://console.cloud.google.com) и создайте проект + +![BF](../../static/img/Docs/GoogleCalendar/1.png) + +2. Выберите созданный проект и в боковом меню перейдите APIs and Services -> OAuth consent screen + +![BF](../../static/img/Docs/GoogleCalendar/2.png) + +3. Выберите пункт External + +![BF](../../static/img/Docs/GoogleCalendar/3.png) + +4. Заполните поля App name, User support email и Email addresses (все поля со звездочками) + +![BF](../../static/img/Docs/GoogleCalendar/4.png) + +5. Нажимайте далее и Save and continue на последней вкладке + +![BF](../../static/img/Docs/GoogleCalendar/5.png) + +6. Нажмите Publish App + +![BF](../../static/img/Docs/GoogleCalendar/6.png) + +
+ +### Настройка OAuth + +1. В боковом меню выберите пункт Credentials -> Create Credentials -> OAuth client ID + +![BF](../../static/img/Docs/GoogleCalendar/7.png) + +2. Введите имя и выберите Application type - Desktop app + +![BF](../../static/img/Docs/GoogleCalendar/8.png) + +3. Сохраните ClientID и Client Secret + +![BF](../../static/img/Docs/GoogleCalendar/9.png) + +
+ +### Включение сервиса Google Sheets + +1. Перейдите на [страницу Sheets в Marketplace](https://console.cloud.google.com/marketplace/product/google/sheets.googleapis.com) + +2. Нажмите Enable + +![BF](../../static/img/Docs/GoogleSheets/1.png) + +
+ +### Получение Токена + +1. Передайте ClientID в функцию OPI_GoogleWorkspace.СформироватьСсылкуПолученияКода() с булево параметрами используемых вами сервисов. Результатом функции будет URL, который необходимо открыть в браузере. Авторизуйтесь при помощи своего аккаунта Google + +![BF](../../static/img/Docs/GoogleCalendar/10.png) + +2. Скопируйте код из URL после авторизации + +![BF](../../static/img/Docs/GoogleCalendar/11.png) + +3. Используйте полученный код, ClientID и Client Secret для вызова функции OPI_GoogleWorkspace.ПолучитьТокенПоКоду(ClientID, ClientSecret, Code) + +```json title="Результат функции ПолучитьТокенПоКоду(), если перевести его в JSON" + +{ + "token_type": "Bearer", + "refresh_token": "1//09au6OES3JN9oCgYIARAAGAkSNwF-L9Ir1B7uawfwafT1wE0FKO519Xj6JxawfawfyjMyJ_QlUZYLHZqw", + "scope": "https://www.googleapis.com/auth/...", + "expires_in": 3599, + "access_token": "ya29.a0AfB_byA344tXkIawdawdwadadhyZQV8bSZn_snNXtY2HLb7l71awdawdawdad-ASgpzyOSWIvEmPruhUa_1yCCq6jvoD0r_q-fNEsARrH8zpJ3c6LNGWvwdg8CXsSxYaCgYKAWkSawfwafawfrCK0EP5kZY_A0171" +} + +``` + +4. Используйте **access_token** для передачи в качестве параметра Токен при вызове функций библиотеки, а refresh_token - для получения нового access_token (функция OPI_GoogleWorkspace.ОбновитьТокен(ClientID, ClientSecret, RefreshToken)), когда время жизни старого истечет. При обновлении токена refresh_token не обновляется - вы можете использовать его один и тот же для получения нового access_token каждый раз. diff --git a/docs/ru/md/Google_Sheets/_category_.json b/docs/ru/md/Google_Sheets/_category_.json new file mode 100644 index 000000000..bdd5fb082 --- /dev/null +++ b/docs/ru/md/Google_Sheets/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Google Sheets", + "position": 9, + "link": { + "type": "doc", + "id": "GoogleSheets" + } +} \ No newline at end of file diff --git a/docs/ru/md/Google_Workspace/Public/Form-code-retrieval-link.md b/docs/ru/md/Google_Workspace/Public/Form-code-retrieval-link.md deleted file mode 100644 index a4f67c216..000000000 --- a/docs/ru/md/Google_Workspace/Public/Form-code-retrieval-link.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -sidebar_position: 1 ---- - -# Сформировать ссылку получения кода - Возвращает URL для авторизации в браузере - - -*Функция СформироватьСсылкуПолученияКода(Знач ClientID, Знач Calendar = Истина, Знач Drive = Истина, Знач Sheets = Истина) Экспорт* - - | Параметр | CLI опция | Тип | Назначение | - |-|-|-|-| - | ClientID | --id | Строка | Client ID | - | Calendar | --calendar | Булево | разрешение на методы Calendar | - | Drive | --drive | Булево | разрешение на методы Drive | - | Sheets | --sheets | Булево | разрешение на методы Sheets | - - - Возвращаемое значение: Строка - Ссылка получения кода - -```bsl title="Пример кода" - - - -``` - -```sh title="Пример команды CLI" - - oint google СформироватьСсылкуПолученияКода --id %id% --calendar %calendar% --drive %drive% --sheets %sheets% - -``` - - -```json title="Результат" - - - -``` diff --git a/docs/ru/md/Google_Workspace/Public/Get-token-by-code.md b/docs/ru/md/Google_Workspace/Public/Get-token-by-code.md deleted file mode 100644 index 742dbca50..000000000 --- a/docs/ru/md/Google_Workspace/Public/Get-token-by-code.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Получить токен по коду - Получает токен по коду из авторизации в бразуере - - -*Функция ПолучитьТокенПоКоду(Знач ClientID, Знач ClientSecret, Знач Code) Экспорт* - - | Параметр | CLI опция | Тип | Назначение | - |-|-|-|-| - | ClientID | --id | Строка | Client ID | - | ClientSecret | --secret | Строка | Client secret | - | Code | --code | Строка | Code из браузера | - - - Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Google - -```bsl title="Пример кода" - - - -``` - -```sh title="Пример команды CLI" - - oint google ПолучитьТокенПоКоду --id %id% --secret %secret% --code %code% - -``` - - -```json title="Результат" - - - -``` diff --git a/docs/ru/md/Google_Workspace/Public/Refresh-token.md b/docs/ru/md/Google_Workspace/Public/Refresh-token.md deleted file mode 100644 index b21563cb9..000000000 --- a/docs/ru/md/Google_Workspace/Public/Refresh-token.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -sidebar_position: 3 ---- - -# Обновить токен - Обновляет токен по Refresh token - - -*Функция ОбновитьТокен(Знач ClientID, Знач ClientSecret, Знач RefreshToken) Экспорт* - - | Параметр | CLI опция | Тип | Назначение | - |-|-|-|-| - | ClientID | --id | Строка | Client ID | - | ClientSecret | --secret | Строка | Client secret | - | RefreshToken | --refresh | Строка | Refresh token | - - - Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Google - -```bsl title="Пример кода" - - - -``` - -```sh title="Пример команды CLI" - - oint google ОбновитьТокен --id %id% --secret %secret% --refresh %refresh% - -``` - - -```json title="Результат" - - - -``` diff --git a/docs/ru/md/Google_Workspace/Public/_category_.json b/docs/ru/md/Google_Workspace/Public/_category_.json deleted file mode 100644 index c360265da..000000000 --- a/docs/ru/md/Google_Workspace/Public/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ -"label": "Public", -"position": "2" -} \ No newline at end of file diff --git a/docs/ru/md/Notion/Notion.md b/docs/ru/md/Notion/Notion.md new file mode 100644 index 000000000..e650775fb --- /dev/null +++ b/docs/ru/md/Notion/Notion.md @@ -0,0 +1,38 @@ +--- +id: Notion +sidebar_class_name: Notion +--- + + + +# Notion + +Этот раздел посвящен библиотеке для работы с Notion API. На данной странице описаны все действия, необходимые для полноценного начала работы + +## Начало работы + +1. Перейдите **[в раздел интеграций портала для разработчиков](https://www.notion.so/my-integrations)** + +![BF](../../static/img/Docs/Notion/1.png) + +2. Введите название вашей интеграции + +![BF](../../static/img/Docs/Notion/2.png) + +3. После завершения создания интеграции, нажмите *Show* и скопируйте **Токен (Secret)** + +![BF](../../static/img/Docs/Notion/3.png) + +4. Перейдите в **[основной интерфейс Notion](https://notion.so)** и создайте новую страницу. Эта страница будет родительской для всех остальных объектов, создаваемых через API + +![BF](../../static/img/Docs/Notion/4.png) + +5. Нажмите три точки в правом верхнем углу и в самом низу найдите пункт *Add connections*. Выберите там свою интеграцию из пунктов 1-3 + +![BF](../../static/img/Docs/Notion/5.png) + +6. Получите ID это страинцы. Это можно сделать нажав Share -> Copy link или просто скопировав из URL + +![BF](../../static/img/Docs/Notion/6.png) + +**Токен** и **ID страницы** - два параметра, необходимые для работы через API \ No newline at end of file diff --git a/docs/ru/md/Notion/_category_.json b/docs/ru/md/Notion/_category_.json new file mode 100644 index 000000000..84df29463 --- /dev/null +++ b/docs/ru/md/Notion/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Notion", + "position": 6, + "link": { + "type": "doc", + "id": "Notion" + } +} diff --git a/docs/ru/md/Slack/Slack.md b/docs/ru/md/Slack/Slack.md new file mode 100644 index 000000000..308614fac --- /dev/null +++ b/docs/ru/md/Slack/Slack.md @@ -0,0 +1,64 @@ +--- +id: Slack +sidebar_class_name: Slack +--- + + + +# Slack + +Этот раздел посвящен библиотеке для работы со Slack Web API. На данной странице описаны все действия, необходимые для полноценного начала работы + +## Начало работы + +1. Войдите в свой аккаунт и перейдите на страницу **Your Apps** на сайте [Slack API](https://api.slack.com) + +![BF](../../static/img/Docs/Slack/1.png) + +
+ +2. Нажмите **Create App** и выберите пункт **From scratch** + +![BF](../../static/img/Docs/Slack/2.png) + +3. Выберите название и рабочую область, в которой необходимо создать приложение + +![BF](../../static/img/Docs/Slack/3.png) + +
+ +4. Создайте новый токен, нажав **Generate Token and Scopes** ниже на странице приложения + +![BF](../../static/img/Docs/Slack/4.png) + +
+ +5. Выберите имя и добавьте разрешения + +![BF](../../static/img/Docs/Slack/5.png) + +
+ +6. Перейдите в раздел **Premission scope** из пункта установки приложения + +![BF](../../static/img/Docs/Slack/6.png) + +
+ +7. Добавьте необходимые для ваших целей разрешения + +![BF](../../static/img/Docs/Slack/7.png) + +
+ +8. Установите приложение + +![BF](../../static/img/Docs/Slack/8.png) + +
+ +9. Сохраните сгенерированный токен + +![BF](../../static/img/Docs/Slack/9.png) + +
\ No newline at end of file diff --git a/docs/ru/md/Slack/_category_.json b/docs/ru/md/Slack/_category_.json new file mode 100644 index 000000000..beb5d69a1 --- /dev/null +++ b/docs/ru/md/Slack/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Slack", + "position": 9, + "link": { + "type": "doc", + "id": "Slack" + } +} diff --git a/docs/ru/md/Telegram/Administration/Create-invitation-link.md b/docs/ru/md/Telegram/Administration/Create-invitation-link.md index 378dd1547..bcafe8c62 100644 --- a/docs/ru/md/Telegram/Administration/Create-invitation-link.md +++ b/docs/ru/md/Telegram/Administration/Create-invitation-link.md @@ -37,7 +37,7 @@ sidebar_position: 3 ```sh title="Пример команды CLI" - oint telegram СоздатьСсылкуПриглашение --token "6129457865:AAFyzNYOAFbu..." --chat %chat% --title "Ссылка + Строка(ТекущаяДата)" --expire %expire% --limit %limit% + oint telegram СоздатьСсылкуПриглашение --token "6129457865:AAFyzNYOAFbu..." --chat %chat% --title %title% --expire %expire% --limit %limit% ``` diff --git a/docs/ru/md/Telegram/Data-sending/Send-poll.md b/docs/ru/md/Telegram/Data-sending/Send-poll.md index 182957b00..e454c4374 100644 --- a/docs/ru/md/Telegram/Data-sending/Send-poll.md +++ b/docs/ru/md/Telegram/Data-sending/Send-poll.md @@ -46,7 +46,7 @@ sidebar_position: 10 ```sh title="Пример команды CLI" - oint telegram ОтправитьОпрос --token "6129457865:AAFyzNYOAFbu..." --chat "461699897" --question "Какой ваш любимый цвет?" --options %options% --anonymous %anonymous% + oint telegram ОтправитьОпрос --token "6129457865:AAFyzNYOAFbu..." --chat "461699897" --question %question% --options %options% --anonymous %anonymous% ``` diff --git a/docs/ru/md/Telegram/Telegram.md b/docs/ru/md/Telegram/Telegram.md new file mode 100644 index 000000000..80edeebb6 --- /dev/null +++ b/docs/ru/md/Telegram/Telegram.md @@ -0,0 +1,41 @@ +--- +id: Telegram +sidebar_class_name: Telegram +--- + + + +# Telegram + +Этот раздел посвящен библиотеке для работы с Telegram API. На данной странице описаны все действия, необходимые для полноценного начала работы + +## Начало работы + +- Создайте бота Telegram + + 1. Все действия при работе с Telegram API осуществляются посредством ботов. Для создания нового бота необходимо в мессенджере начать диалог с [@BotFather](https://t.me/BotFather) + + ![BF](../../static/img/Docs/Telegram/2.png) + + 2. Выбрать в меню команду */newbot* + + ![BF](../../static/img/Docs/Telegram/3.png) + + 3. BotFather предложит вам выбрать имя и никнейм бота, после чего процедура создания будет завершена + +- Сохраните **токен**, который вам прислал BotFather после завершения создания бота + + ![BF](../../static/img/Docs/Telegram/1.png) + +- (Дополнительно) Определитесь с целью взаимодействия + + Созданного вами бота теперь можно применить двумя способами + + - В качестве чат-бота + - Для автоматизации ведения канала + + В зависимости от выбранного способа примения будет отличаться способ получения **ID чата** - параметра, отвечающего за определение объекта взаимодействия. + + В случае с чат-ботом, ID чата будет являться ID пользователя, с которым бот осуществляет диалог. Если же бота необходимо использовать для ведения канала, то, после добавления его в качестве администратора, вместо ID чата можно использовать имя канала через @ (@MyChannel) + + Токен и ID чата являются основными параметрами всех методов работы с Telegram API \ No newline at end of file diff --git a/docs/ru/md/Telegram/_category_.json b/docs/ru/md/Telegram/_category_.json new file mode 100644 index 000000000..a2917ded7 --- /dev/null +++ b/docs/ru/md/Telegram/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Telegram", + "position": 2, + "link": { + "type": "doc", + "id": "Telegram" + } +} diff --git a/docs/ru/md/Twitter/Twitter.md b/docs/ru/md/Twitter/Twitter.md new file mode 100644 index 000000000..2c2f41599 --- /dev/null +++ b/docs/ru/md/Twitter/Twitter.md @@ -0,0 +1,125 @@ +--- +id: Twitter +sidebar_class_name: Twitter +--- + + + +# Twitter | X + +Этот раздел посвящен библиотеке для работы с Twitter API. На данной странице описаны все действия, необходимые для полноценного начала работы. Данная библиотека позволяет работать с функционалом бесплатного плана, т.е. создавать твиты. Однако, если у вас есть платная подписка более высокого уровня и вам нужны более продвинутые функции, то добавить их по примеру не составит никакого труда, так как общая база тут уже реализована: + - Авторизация OAuth 1.0a User Context для API версии 1 - Функция СоздатьЗаголовокАвторизацииV1() + - Авторизация OAuth 2.0 для API версии 2 - Функция СоздатьЗаголовокАвторизацииV2() + - Загрузка файлов: как одним запросом, так и чанками - Функция ЗагрузитьМедиафайл() + + Далее будет описан принци работы с авторизацией и двумя версиями API, а примеры работы с API можно взять из функций ЗагрузитьМедиафайл() (для v1) и СоздатьПроизвольныйТвит() (для v2) + +## Начало работы + + +Работа с Twitter подразумевает работу с двумя API - v1 (1.1) и v2, которые, при этом, не относятся к разным видам действий, но просто являются версиями друг друга. Несмотря на то, что Twitter настаивает на использовании v2, вышло так, что некоторые механизмы (в частности механизм загрузки файлов) в ней так и не появилися. Поэтому, даже для создания обычного твита с картинкой необходима работа с обеими версиями API, а, как следствие, двойной набор авторизационных данны. Этот набор описан в функции *ПолучитьСтандартныеПараметры()* + + +```bsl + + Параметры_.Вставить("redirect_uri" , ""); + Параметры_.Вставить("scope" , ""); + Параметры_.Вставить("client_id" , ""); + Параметры_.Вставить("client_secret" , ""); + Параметры_.Вставить("access_token" , ""); + Параметры_.Вставить("refresh_token" , ""); + Параметры_.Вставить("oauth_token" , ""); + Параметры_.Вставить("oauth_token_secret" , ""); + Параметры_.Вставить("oauth_consumer_key" , ""); + Параметры_.Вставить("oauth_consumer_secret", ""); + +``` + +Вы можете определить эти параметры прямо в структуре внутри данной функции или передавать непосредственно при вызове функций уже для работы с API - каждая из них принимает параметры последним необязательным параметром. При такой передаче стандартные параметры будут перезаписаны по ключам. Рассмотрим создание приложения и получение каждого поля + + + ### Создание приложения + Для работы с Twitter API необходимо перейти по адресу [https://developer.twitter.com/](https://developer.twitter.com/), зарегистрироваться и создать новое приложение + + ![BF](../../static/img/Docs/Twitter/1.png) + ![BF](../../static/img/Docs/Twitter/2.png) + ![BF](../../static/img/Docs/Twitter/3.png) + ![BF](../../static/img/Docs/Twitter/4.png) + ![BF](../../static/img/Docs/Twitter/5.png) + + ### Определение полей + После создания приложения можно заполнить необходимые данные в 1С + + + - **redirect_uri** + + redirect_uri - адрес обработчика http-запросов, указанный при регистрации. Авторизация API v2 требует подтверждения входа через браузер, после которого запрос со специальным кодом на данный обработчик должен будет прийти. Далее об этом будет в пункте access_token и refresh_token. + + + - **scope** + + scope определяет доступные для работы функции. В *ПолучитьСтандартныеПараметры()* список scope определен по умолчанию. + + - **client_id** + + ![BF](../../static/img/Docs/Twitter/6.png) + + - **client_secret** + + ![BF](../../static/img/Docs/Twitter/7.png) + + - **access_token** и **refresh_token** + + Эти токены необходимо получить http запросом с указанием кода, который приходит при авторизации на http-сервис redirect_uri. Порядок действий + 1. Создать ссылку для авторизации в браузере при помощи функции *ПолучитьСсылкуАвторизации* + 2. Добавить в модуль http-сервиса (GET) вызов функции *ОбработкаВходящегоЗапросаПослеАвторизации*, передавая HTTPСервисЗапрос как параметр. + 3. Авторизоваться в браузере по ссылке из п.1. + 3. Сохранить access_token и refresh_token, полученный из функции *ОбработкаВходящегоЗапросаПослеАвторизации* п. 2, в константы или другое хранилище + + + ```bsl title="Получение" + + Функция Twitterget(Запрос) + + Код = Запрос.ПараметрыЗапроса["code"]; + ОтветТокен = OPI_Twitter.ПолучитьТокен(Код, Параметры); + + Константы.TwitterRefresh.Установить(ОтветТокен["refresh_token"]); + Константы.TwitterToken.Установить(ОтветТокен["access_token"]); + + Ответ = Новый HTTPСервисОтвет(200); + Возврат Ответ; + + КонецФункции + + ``` + + ```bsl title="Обновление" + + Процедура ОбновлятьТокенКаждыеДваЧаса(Знач Параметры) + + Ответ = OPI_Twitter.ОбновитьТокен(Параметры); + Константы.TwitterToken.Установить(Ответ["access_token"]); + Константы.TwitterRefresh.Установить(Ответ["refresh_token"]); + + КонецПроцедуры + ``` + + Хардкодить данные токены нельзя, так как acess_token действует всего 2 часа. По истечении этого времени, токен необходимо обновить функцией *ОбновитьТокен*. При этом обновляется как access_token, так и refresh_token. Т.е. при следующем обновлении сгоревшего acess_token токена, refresh_token должен быть из предыдущего запроса. + + ![BF](../../static/img/Docs/Twitter/8.png) + + + - **oauth_token** и **oauth_token_secret** + + ![BF](../../static/img/Docs/Twitter/9.png) + + - **oauth_consumer_key** и **oauth_consumer_secret** + + ![BF](../../static/img/Docs/Twitter/10.png) + + + После заполнения данных полей можно приступать к работе с методами API + + + \ No newline at end of file diff --git a/docs/ru/md/Twitter/_category_.json b/docs/ru/md/Twitter/_category_.json new file mode 100644 index 000000000..ec287980a --- /dev/null +++ b/docs/ru/md/Twitter/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Twitter", + "position": 4, + "link": { + "type": "doc", + "id": "Twitter" + } +} diff --git a/docs/ru/md/VK/Discussion-management/Close-discussion.md b/docs/ru/md/VK/Discussion-management/Close-discussion.md index db4f294b9..74996d849 100644 --- a/docs/ru/md/VK/Discussion-management/Close-discussion.md +++ b/docs/ru/md/VK/Discussion-management/Close-discussion.md @@ -28,7 +28,7 @@ sidebar_position: 2 ```sh title="Пример команды CLI" - oint vk ЗакрытьОбсуждение --topic %topic% --remove %remove% --auth "ПолучитьПараметрыВК()" + oint vk ЗакрытьОбсуждение --topic %topic% --remove %remove% --auth %auth% ``` diff --git a/docs/ru/md/VK/Discussion-management/Open-discussion.md b/docs/ru/md/VK/Discussion-management/Open-discussion.md index 86ef94838..70edc1849 100644 --- a/docs/ru/md/VK/Discussion-management/Open-discussion.md +++ b/docs/ru/md/VK/Discussion-management/Open-discussion.md @@ -27,7 +27,7 @@ sidebar_position: 3 ```sh title="Пример команды CLI" - oint vk ОткрытьОбсуждение --topic %topic% --auth "ПолучитьПараметрыВК()" + oint vk ОткрытьОбсуждение --topic %topic% --auth %auth% ``` diff --git a/docs/ru/md/VK/Discussion-management/Write-in-discussion.md b/docs/ru/md/VK/Discussion-management/Write-in-discussion.md index 9164c3dbb..8b4fe03f5 100644 --- a/docs/ru/md/VK/Discussion-management/Write-in-discussion.md +++ b/docs/ru/md/VK/Discussion-management/Write-in-discussion.md @@ -30,7 +30,7 @@ sidebar_position: 4 ```sh title="Пример команды CLI" - oint vk НаписатьВОбсуждение --topic %topic% --text %text% --auth "ПолучитьПараметрыВК()" + oint vk НаписатьВОбсуждение --topic %topic% --text %text% --auth %auth% ``` diff --git a/docs/ru/md/VK/Group-work/Create-composite-post.md b/docs/ru/md/VK/Group-work/Create-composite-post.md index a8bf09bcb..b757d9278 100644 --- a/docs/ru/md/VK/Group-work/Create-composite-post.md +++ b/docs/ru/md/VK/Group-work/Create-composite-post.md @@ -51,7 +51,7 @@ sidebar_position: 2 ```sh title="Пример команды CLI" - oint vk СоздатьСоставнойПост --text "Пост из автотеста" --objects %objects% --ad %ad% --url %url% --auth "ПолучитьПараметрыВК()" + oint vk СоздатьСоставнойПост --text %text% --objects %objects% --ad %ad% --url %url% --auth %auth% ``` diff --git a/docs/ru/md/VK/Group-work/Create-post.md b/docs/ru/md/VK/Group-work/Create-post.md index 427d64686..258cccbc1 100644 --- a/docs/ru/md/VK/Group-work/Create-post.md +++ b/docs/ru/md/VK/Group-work/Create-post.md @@ -47,7 +47,7 @@ sidebar_position: 1 ```sh title="Пример команды CLI" - oint vk СоздатьПост --text "Пост из автотеста" --pictures %pictures% --ad %ad% --url %url% --auth "ПолучитьПараметрыВК()" + oint vk СоздатьПост --text %text% --pictures %pictures% --ad %ad% --url %url% --auth %auth% ``` diff --git a/docs/ru/md/VK/Group-work/Create-story.md b/docs/ru/md/VK/Group-work/Create-story.md index 57847aae3..bccca9a98 100644 --- a/docs/ru/md/VK/Group-work/Create-story.md +++ b/docs/ru/md/VK/Group-work/Create-story.md @@ -39,7 +39,7 @@ sidebar_position: 7 ```sh title="Пример команды CLI" - oint vk СоздатьИсторию --picture "https://openintegrations.dev/test_data/picture.jpg // URL, Путь к файлу или Двоичные данные" --url "https://github.com/Bayselonarrend/OpenIntegrations" --auth "ПолучитьПараметрыВК()" + oint vk СоздатьИсторию --picture "https://openintegrations.dev/test_data/picture.jpg" --url %url% --auth %auth% ``` diff --git a/docs/ru/md/VK/Group-work/Delete-album.md b/docs/ru/md/VK/Group-work/Delete-album.md index 85830ff55..d982ebc49 100644 --- a/docs/ru/md/VK/Group-work/Delete-album.md +++ b/docs/ru/md/VK/Group-work/Delete-album.md @@ -28,7 +28,7 @@ sidebar_position: 6 ```sh title="Пример команды CLI" - oint vk УдалитьАльбом --album %album% --auth "ПолучитьПараметрыВК()" + oint vk УдалитьАльбом --album %album% --auth %auth% ``` diff --git a/docs/ru/md/VK/Group-work/Delete-image.md b/docs/ru/md/VK/Group-work/Delete-image.md index d5ae2e703..86b7afe0f 100644 --- a/docs/ru/md/VK/Group-work/Delete-image.md +++ b/docs/ru/md/VK/Group-work/Delete-image.md @@ -28,7 +28,7 @@ sidebar_position: 9 ```sh title="Пример команды CLI" - oint vk УдалитьКартинку --pictureid %pictureid% --auth "ПолучитьПараметрыВК()" + oint vk УдалитьКартинку --pictureid %pictureid% --auth %auth% ``` diff --git a/docs/ru/md/VK/Group-work/Delete-post.md b/docs/ru/md/VK/Group-work/Delete-post.md index 69fb31ce8..39f4915b9 100644 --- a/docs/ru/md/VK/Group-work/Delete-post.md +++ b/docs/ru/md/VK/Group-work/Delete-post.md @@ -28,7 +28,7 @@ sidebar_position: 3 ```sh title="Пример команды CLI" - oint vk УдалитьПост --post %post% --auth "ПолучитьПараметрыВК()" + oint vk УдалитьПост --post %post% --auth %auth% ``` diff --git a/docs/ru/md/VK/Group-work/Save-image-to-album.md b/docs/ru/md/VK/Group-work/Save-image-to-album.md index 0dbee1b38..e3580777c 100644 --- a/docs/ru/md/VK/Group-work/Save-image-to-album.md +++ b/docs/ru/md/VK/Group-work/Save-image-to-album.md @@ -43,7 +43,7 @@ sidebar_position: 8 ```sh title="Пример команды CLI" - oint vk СохранитьКартинкуВАльбом --album %album% --picture "https://openintegrations.dev/test_data/picture.jpg // URL, Путь к файлу или Двоичные данные" --description %description% --auth "ПолучитьПараметрыВК()" + oint vk СохранитьКартинкуВАльбом --album %album% --picture "https://openintegrations.dev/test_data/picture.jpg" --description %description% --auth %auth% ``` diff --git a/docs/ru/md/VK/VK.md b/docs/ru/md/VK/VK.md new file mode 100644 index 000000000..2ffbf6e4e --- /dev/null +++ b/docs/ru/md/VK/VK.md @@ -0,0 +1,94 @@ +--- +id: VK +sidebar_class_name: VK +--- + + + +# ВКонтакте + +Этот раздел посвящен библиотеке для работы с VK API. Она заточена для работы с сообществами и выполнением действий от их имени. На данной странице описаны все действия, необходимые для полноценного начала работы + +## Начало работы + +Для начала работы необходимо получить некоторые параметры для VK API. + +

+Перечень необходимых данных в виде структуры содержится в функции *ПолучитьСтандартныеПараметры()*. Вы можете указывать значения параметров прямо в ней или же передавать их структурой при вызове любых других методов библиотеки в качестве необязательного параметра *Параметры* (последний во всех методах билиотеки). В последнем случае стандартные параметры будут перезаписаны по ключам теми, которые переданы при вызове метода. Перезаписаны будут только совпадающие по ключам данные. Если какой то параметр есть в наборе стандартных, но не был передан при вызове метода, то он сохранит стандартное значение. +

+ + ```bsl + _Параметры = Новый Структура; + + _Параметры.Вставить("v" , "5.131"); + _Параметры.Вставить("from_group" , "1"); + _Параметры.Вставить("group_id" , "123456789"); + _Параметры.Вставить("owner_id" , "-123456789"); + _Параметры.Вставить("app_id" , "87654321"); + _Параметры.Вставить("access_token" , "vk1.a.E-byuFeG1qcN7..."); + + ``` + +Рассмотрим получение каждого значения: + +**1. v** + + Параметр v означает версию VK API. Тестирование проводилось на 5.131, рекомендуется его таким и оставить + +**2. from_group** + + От лица группы. Должен быть 1 + +**3. group_id и owner_id** + + ID группы. Если у вас стандартный адрес группы, то id можно найти в URL. В противном случае он будет на вкладке "Управление" в группе, под полем Адрес. owner_id - тоже самое, но со знаком '-' впереди + + ![BF](../../static/img/Docs/VK/1.png) + +**4. app_id** + + app_id - ID приложения. Для создания приложения необходимо: + + * Перейти по адресу https://id.vk.com/about/business/go, авторизоваться и ввести свои данные физ. или юр. лица + + ![BF](../../static/img/Docs/VK/2.png) + + * Ввести название приложения и выбрать пункт **Web** + + ![BF](../../static/img/Docs/VK/3.png) + + * Ввести домееное имя и URL обработчика перенаправлений. Тут нужно отметить, что данный механизм создания приложений - новый. Еще недавно приложения VK создавались иначе и иметь redirect_url для них было не нужно. На данный момент не совсем понятно, зачем он нужен нам для серверного приложения - просто такого понятия как серверное приложение у VK теперь нет. Теоретически, туда можно вписать что угодно - для работы с библиотекой в получении обратных данных нет необходимости. Однако, с течением времени, это может измениться. + + ![BF](../../static/img/Docs/VK/4.png) + + * Ввести паспортные данные или данные об организации, включить доступ к сообществам (короче, если у вас уже было приложение до этого, то вам крупно повезло, а если нет российского паспорта - придется писать в поддержку) + + ![BF](../../static/img/Docs/VK/8.png) + + * Получить app_id на странице приложения + + ![BF](../../static/img/Docs/VK/5.png) + +**5. access_token** + + Ссылку на получение acess_token можно получить при помощи функции *СоздатьСсылкуПолученияТокена* или склеить вручную: + + https://oauth.vk.com/authorize?client_id= + *app_id* + &scope=offline,wall,groups,photos,stats,stories,ads&v=5.131&response_type=token&redirect_uri=https://api.vk.com/blank.html + + * По этой ссылке необходимо перейти в браузере + * Авторизоваться через ВК и подтвердить доступ + * Забрать токен из параметра URL в адресной строке + + ![BF](../../static/img/Docs/VK/6.png) + +**(Дополнительно) communitytoken** + + Некоторые методы, например для работы с чат-ботом сообщества, принимают в качестве параметра communitytoken - в этих методах он заменяет access_token. Для его получения необходимо: + + * Зайти в раздел "Управление" в группе ВК + * Найти вкладку "Работа с API" + * Нажать "Создать ключ" и забрать его + + ![BF](../../static/img/Docs/VK/7.png) + + Пока вам не нужно использовать такие методы, получать communitytoken не обязательно \ No newline at end of file diff --git a/docs/ru/md/VK/_category_.json b/docs/ru/md/VK/_category_.json new file mode 100644 index 000000000..13bb94861 --- /dev/null +++ b/docs/ru/md/VK/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "VK", + "position": 3, + "link": { + "type": "doc", + "id": "VK" + } +} diff --git a/docs/ru/md/Viber/Viber.md b/docs/ru/md/Viber/Viber.md new file mode 100644 index 000000000..a8cc06244 --- /dev/null +++ b/docs/ru/md/Viber/Viber.md @@ -0,0 +1,69 @@ +--- +id: Viber +sidebar_class_name: Viber +--- + + + +# Viber + +Этот раздел посвящен библиотеке для работы с Viber API. На данной странице описаны все действия, необходимые для полноценного начала работы + +## Начало работы + +:::note + +Особенности работы с Viber API + +1. Нельзя использовать бота и управлять каналом через API, если не установлен Webhook + + В отличии от Telegram, которые позволяют самому забирать обновления с серверов, а писать и вовсе независимо от этого, Viber требует обязательного использования Webhook, т.е у вас должен быть сервер с внешним IP и действительный SSL сертификат. Если верить документации, Viber периодически будет стучать по адресу, указанному как WH и если он не получит ответ 200, то все перестанет работать(**UPD:** Уже месяц нет http-сервиса, но ничего не поломалось). Запросы от Viber могут обрабатываться http-сервисом или любым другим обработчиком для запросов типа POST, при условии наличия SSL и доступности адреса извне. Если у вас есть такой адрес, то установить Webhook можно при помощий функции *УстановитьWebhook()* данной библиотеки (см. далее). После установки, у чат бота в приложении Viber появится кнопка "Сообщение" для начала диалога, а в канал станет можно отправлять сообщения через REST Api. + +2. У Viber отсутствуют механизмы загрузки внешних файлов на их сервера + + Картинки, файлы и документы могут отправляться в Viber только в виде URL. Т.е. для этого тоже нужен сервер или, как минимум, сторонний сервис для публикации файлов. Но так как сервер уже в любом случае необходим для Webhook, отправляемые файлы можно временно сохранять в папку веб-сервера. У IIS это папка wwwroot + +::: + +У Viber есть два REST API: один для работы с каналами, а второй - для чат-ботов. В обоих случаях основными параметрами служат **Токен** и **IDПользователя** + +- Если вам необходимо управлять каналом: + 1. Зайдите в приложение Viber и создайте новый канал + + ![BF](../../static/img/Docs/Viber/1.png) + + 2. После создания, перейдите в настройки канала -> "Для разработчиков", и скопируйте **Токен** + + ![BF](../../static/img/Docs/Viber/2.png) + + 3. Установите Webhook. См. Установить Webhook + 4. **IDПользователя** - ваш ID (администратора канала). См. Получить информацию о канале + +
+ +- Если вам необходим чат-бот: + 1. Перейдите по ссылке [https://partners.viber.com/account/create-bot-account](https://partners.viber.com/account/create-bot-account) и авторизуйтесь с вашим номером телефона, который привязан к Viber + + ![BF](../../static/img/Docs/Viber/3.png) + + 2. Выберите пункт создания нового бота + + ![BF](../../static/img/Docs/Viber/4.png) + + 3. В меню создания бота заполните все необходимые поля + + ![BF](../../static/img/Docs/Viber/5.png) + + 4. Скопируйте **Токен** + + ![BF](../../static/img/Docs/Viber/6.png) + + 4. Найти своего нового бота вы можете отсканировав QR на странице создания или в настройках (пункт чат-боты) в приложении Viber. + + ![BF](../../static/img/Docs/Viber/7.png) + + 5. Сейчас вы не можете начать диалог с ботом, сначала необходимо установить Webhook. См. Установить Webhook + 6. После запуска **IDПользователя** будет ID конкретного человека, ведущего диалог с ботом. Получить можно из обработыки входящих сообщения по Webhook + + + **Важно:** ID одного и того же пользователя у чата и канала - это разные значения. Нельзя использовать ID, полученный из сообщения боту для вызова методов управления каналом и наоборот. \ No newline at end of file diff --git a/docs/ru/md/Viber/_category_.json b/docs/ru/md/Viber/_category_.json new file mode 100644 index 000000000..302de2e37 --- /dev/null +++ b/docs/ru/md/Viber/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Viber", + "position": 3, + "link": { + "type": "doc", + "id": "Viber" + } +} diff --git a/docs/ru/md/Yandex_Disk/Yandex_Disk.md b/docs/ru/md/Yandex_Disk/Yandex_Disk.md new file mode 100644 index 000000000..4b90df814 --- /dev/null +++ b/docs/ru/md/Yandex_Disk/Yandex_Disk.md @@ -0,0 +1,62 @@ +--- +id: YandexDisk +sidebar_class_name: YandexDisk +--- + + + +# Яндекс Диск + +Этот раздел посвящен библиотеке для работы с Яндекс Диск API. На данной странице описаны все действия, необходимые для полноценного начала работы + +## Начало работы + +Для начала работы необходимо получить токен доступа к диску: + +1. Перейдите на [страницу создания приложения](https://oauth.yandex.ru/client/new/) + +![BF](../../static/img/Docs/YandexDisk/1.png) + +2. Введите название сервиса, выберите *Веб-сервисы* в качестве платформы. Redirect URI можно указать любой или выбрать пункт *Подставить URL для отладки* - для работы с библиотекой он не понадобится. + +![BF](../../static/img/Docs/YandexDisk/3.png) + +3. В поле *Доступ к данным* добавьте разрешения как на скриншоте ниже, после чего нажмите *Создать приложение* + +![BF](../../static/img/Docs/YandexDisk/2.png) + +4. Сохраните **ClientID** и **Client secret** со страницы приложения + +![BF](../../static/img/Docs/YandexDisk/4.png) + +5. Вызовите функцию *OPI_YandexID.ПолучитьКодПодтверждения()*, передав ClientID в качестве параметра. Она вернет ответ сервера Yandex, где будут поля + - **user_code** - необходимо будет ввести в браузере + - **device_code** - необходимо будет передать в другую функцию + - **verification_url** - URL, который нужно открыть в браузере +
+ ```json title="Результат функции ПолучитьКодПодтверждения(), если перевести его в JSON" + { + "verification_url": "https://ya.ru/device", + "user_code": "gjehyruw", + "interval": 5, + "expires_in": 300, + "device_code": "12207cafec1b40ad8d0052af3faf0d12" + } + ``` + +6. Откройте URL из **verification_url** в барузере. Скорее всего это будет https://ya.ru/device. В появившееся поле введите **user_code** из пункта 5 + +![BF](../../static/img/Docs/YandexDisk/5.png) + +7. После ввода кода в пункте 6, вызовите функцию *OPI_YandexID.ПреобразоватьКодВТокен()*, передав туда **ClientID** и **ClientSecret** из пункта 4, а также **device_code** из пункта 5. Сохраните полученные **acess_token** и **refresh_token** + +```json title="Результат функции ПреобразоватьКодВТокен(), если перевести его в JSON" +{ + "token_type": "bearer", + "refresh_token": "1:Tj6nD2vgE2L8jwSm:YgWjQXPv6_y3e07GW70ig2AOyEXoRVsKKpApGHq2EOg7pfx0MKrXiCrfLBFtzgQawdawdwadad3Sasa9z2H0vSeZKNmZmA", + "expires_in": 31535956, + "access_token": "y0_AgAAAABWxxdkAAs0QgAAAAD59cawdawdwadadVKIiwGK__crw" +} +``` + +**acess_token** используется во всех остальных функциях библиотеки, а при помощи **refresh_token** его можно обновить, когда срок жизни будет подходить к концу (при помощи функции *ОбновитьТокен()*) \ No newline at end of file diff --git a/docs/ru/md/Yandex_Disk/_category_.json b/docs/ru/md/Yandex_Disk/_category_.json new file mode 100644 index 000000000..e4a627327 --- /dev/null +++ b/docs/ru/md/Yandex_Disk/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Yandex Disk", + "position": 13, + "link": { + "type": "doc", + "id": "YandexDisk" + } +} diff --git a/docs/ru/md/Yandex_ID/Public/Convert-code-to-token.md b/docs/ru/md/Yandex_ID/Public/Convert-code-to-token.md deleted file mode 100644 index 97b72b4f2..000000000 --- a/docs/ru/md/Yandex_ID/Public/Convert-code-to-token.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Преобразовать код в токен - Преобразовывает код в токен после ввода кода при выполнении ПолучитьКодПодтверждения - - -*Функция ПреобразоватьКодВТокен(Знач ClientId, Знач ClientSecret, Знач КодУстройства) Экспорт* - - | Параметр | CLI опция | Тип | Назначение | - |-|-|-|-| - | ClientId | --id | Строка | Client id | - | ClientSecret | --secret | Строка | Client secret | - | КодУстройства | --device | Строка | device_code из ПолучитьКодПодтверждения() | - - - Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Yandex - -```bsl title="Пример кода" - - - -``` - -```sh title="Пример команды CLI" - - oint yandex ПреобразоватьКодВТокен --id %id% --secret %secret% --device %device% - -``` - - -```json title="Результат" - - - -``` diff --git a/docs/ru/md/Yandex_ID/Public/Get-confirmation-code.md b/docs/ru/md/Yandex_ID/Public/Get-confirmation-code.md deleted file mode 100644 index c4c6f33a4..000000000 --- a/docs/ru/md/Yandex_ID/Public/Get-confirmation-code.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -sidebar_position: 1 ---- - -# Получить код подтверждения - Получает код подтверждения и адрес страницы, на которой его необходимо ввести - - -*Функция ПолучитьКодПодтверждения(Знач ClientId) Экспорт* - - | Параметр | CLI опция | Тип | Назначение | - |-|-|-|-| - | ClientId | --id | Строка | Client id | - - - Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Yandex - -```bsl title="Пример кода" - - - -``` - -```sh title="Пример команды CLI" - - oint yandex ПолучитьКодПодтверждения --id %id% - -``` - - -```json title="Результат" - - - -``` diff --git a/docs/ru/md/Yandex_ID/Public/Refresh-token.md b/docs/ru/md/Yandex_ID/Public/Refresh-token.md deleted file mode 100644 index 93129a4a4..000000000 --- a/docs/ru/md/Yandex_ID/Public/Refresh-token.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -sidebar_position: 3 ---- - -# Обновить токен - Обновляет токен по Refresh token - - -*Функция ОбновитьТокен(Знач ClientId, Знач ClientSecret, Знач RefreshToken) Экспорт* - - | Параметр | CLI опция | Тип | Назначение | - |-|-|-|-| - | ClientId | --id | Строка | Client id | - | ClientSecret | --secret | Строка | Client secret | - | RefreshToken | --refresh | Строка | Refresh token | - - - Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Yandex - -```bsl title="Пример кода" - - - -``` - -```sh title="Пример команды CLI" - - oint yandex ОбновитьТокен --id %id% --secret %secret% --refresh %refresh% - -``` - - -```json title="Результат" - - - -``` diff --git a/docs/ru/md/Yandex_ID/Public/_category_.json b/docs/ru/md/Yandex_ID/Public/_category_.json deleted file mode 100644 index c360265da..000000000 --- a/docs/ru/md/Yandex_ID/Public/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ -"label": "Public", -"position": "2" -} \ No newline at end of file