1
0
mirror of https://github.com/Bayselonarrend/OpenIntegrations.git synced 2024-12-25 02:42:28 +02:00

Документация Google Drive

This commit is contained in:
Anton 2024-03-17 13:45:03 +03:00
parent 174fa6372d
commit 5759358cd5
15 changed files with 542 additions and 1 deletions

View File

@ -0,0 +1,41 @@
---
sidebar_position: 6
---
# Обновить файл
Обновляет двоичные данные существующего файла
*Функция ОбновитьФайл(Знач Токен, Знач Идентификатор, Знач Файл, Знач НовоеИмя = "") Экспорт*
| Параметр | Тип | Назначение |
|-|-|-|
| Токен | Строка | Токен доступа |
| Идентификатор | Строка | ID копируемого объекта |
| Файл | ДвоичныеДанные,Строка | Двоичные данные или путь к новым данным |
| НовоеИмя | Строка (необяз.) | Новое имя файла |
Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Google
```bsl title="Пример кода"
НовоеИмя = "Обновленный файл.jpeg";
КартинкаЗамены = "C:\OPI\image2.jpg";
Идентификатор = "1V0oaZh3qQZ7-wbARC8-vrErAFllsBGSJ";
Ответ = OPI_GoogleDrive.ОбновитьФайл(Токен, Идентификатор, КартинкаЗамены, НовоеИмя) //Соответствие
Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка
```
![Результат](img/3.png)
```json title="Результат"
{
"mimeType": "image/jpeg",
"name": "Обновленный файл.jpg",
"id": "1V0oaZh3qQZ7-wbARC8-vrErAFllsBGSJ",
"kind": "drive#file"
}
```

View File

@ -12,7 +12,7 @@ sidebar_position: 1
| Токен | Строка | Токен доступа |
| Идентификатор | Строка | Идентификатор объекта |
Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Yandex
Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Google
```bsl title="Пример кода"

View File

@ -0,0 +1,21 @@
---
sidebar_position: 10
---
# Получить описание файла
Получает макет-заготовку описания файла для загрузки
*Функция ПолучитьОписаниеФайла() Экспорт*
Вовзращаемое значение: Соответствие - соответствие макета
```bsl title="Содержимое функции"
Описание = Новый Соответствие;
Описание.Вставить("MIME" , "image/jpeg"); // MIME-тип загружаемого файла
Описание.Вставить("Имя" , "Новый файл.jpg"); // Имя файла с расширением
Описание.Вставить("Описание" , "Это новый файл"); // Описание файла
Описание.Вставить("Родитель" , "root"); // ID каталога загрузки или "root" для загрузки в корень
Возврат Описание;
```

View File

@ -0,0 +1,165 @@
---
sidebar_position: 3
---
# Получить список файлов
Получает список файлов
*Функция ПолучитьСписокФайлов(Знач Токен, Знач ИмяСодержит = "", Знач Каталог = "") Экспорт*
| Параметр | Тип | Назначение |
|-|-|-|
| Токен | Строка | Токен доступа |
| ИмяСодержит | Строка (необяз.) | Отбор по нахождению строки в имени файла |
| Каталог | Строка (необяз.) | ID каталога для отбора файлов |
Вовзращаемое значение: Массив из Соответствие - массив описаний файлов
```bsl title="Пример кода"
Каталог = "1VWoLK5w0uPVSjK3oyIXeiMtINN4jDOz4";
Ответ = OPI_GoogleDrive.ПолучитьСписокФайлов(Токен, , Каталог); //Соответствие
Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка
```
```json title="Результат"
[
{
"sha256Checksum": "1a03612de72929ef42a272cb17123871bf9b7723c89f9659765a49f744b6162b",
"linkShareMetadata": {
"securityUpdateEnabled": true,
"securityUpdateEligible": false
},
"imageMediaMetadata": {
"exposureBias": 0,
"focalLength": 5.2,
"exposureTime": 0.00125,
"cameraMake": "SONY",
"isoSpeed": 100,
"time": "2012:08:03 08:21:50",
"width": 3264,
"cameraModel": "DSC-H7",
"whiteBalance": "Auto",
"colorSpace": "sRGB",
"aperture": 5.6,
"exposureMode": "Auto",
"rotation": 0,
"height": 2448,
"meteringMode": "Pattern",
"maxApertureValue": 2.875,
"flashUsed": true
},
"modifiedByMe": true,
"thumbnailVersion": "1",
"fullFileExtension": "jpg",
"quotaBytesUsed": "2114025",
"viewedByMeTime": "2024-03-17T08:09:01.753Z",
"permissionIds": [
"07468399490707249352"
],
"modifiedByMeTime": "2024-03-17T08:05:59.327Z",
"explicitlyTrashed": false,
"trashed": false,
"description": "Это новый файл",
"createdTime": "2024-03-17T08:05:59.327Z",
"id": "1_3QPKWfAhAT0pl0QA1QSC6mRKZndwUrD",
"starred": false,
"spaces": [
"drive"
],
"name": "Новый файл.jpg",
"permissions": [
{
"pendingOwner": false,
"role": "owner",
"emailAddress": "bayselonarrend@gmail.com",
"photoLink": "https://lh3.googleusercontent.com/a/ACg8ocLx8JGurt0UjXFwwTiB6ZoDPWslW1EnfCTahrwrIllM6Q=s64",
"kind": "drive#permission",
"type": "user",
"deleted": false,
"displayName": "Антон Титовец",
"id": "07468399490707249352"
}
],
"webContentLink": "https://drive.google.com/uc?id=1_3QPKWfAhAT0pl0QA1QSC6mRKZndwUrD&export=download",
"isAppAuthorized": true,
"webViewLink": "https://drive.google.com/file/d/1_3QPKWfAhAT0pl0QA1QSC6mRKZndwUrD/view?usp=drivesdk",
"version": "4",
"owners": [
{
"photoLink": "https://lh3.googleusercontent.com/a/ACg8ocLx8JGurt0UjXFwwTiB6ZoDPWslW1EnfCTahrwrIllM6Q=s64",
"emailAddress": "bayselonarrend@gmail.com",
"permissionId": "07468399490707249352",
"me": true,
"kind": "drive#user",
"displayName": "Антон Титовец"
}
],
"lastModifyingUser": {
"photoLink": "https://lh3.googleusercontent.com/a/ACg8ocLx8JGurt0UjXFwwTiB6ZoDPWslW1EnfCTahrwrIllM6Q=s64",
"emailAddress": "bayselonarrend@gmail.com",
"permissionId": "07468399490707249352",
"me": true,
"kind": "drive#user",
"displayName": "Антон Титовец"
},
"hasThumbnail": true,
"shared": false,
"ownedByMe": true,
"parents": [
"1VWoLK5w0uPVSjK3oyIXeiMtINN4jDOz4"
],
"sha1Checksum": "ebdbaf8ed7fe21f6562fde438a2bb12ba49750f2",
"viewedByMe": true,
"headRevisionId": "0B92vrbrhqfJrN1VxL1Nib01LOVV1V3ArN3pGRytVMUNKQWs4PQ",
"writersCanShare": true,
"thumbnailLink": "https://lh3.googleusercontent.com/drive-storage/AJQWtBNcYDmfZOJX84IFS9WFTZXNjlIFg8qaIfYni7xr0ILGZ2rGr_-R2ixRuP9zBMHCp6bpROqLp3WtddBL1p1mwc7Zv8je0Ru2dVbDTKLryg=s220",
"modifiedTime": "2024-03-17T08:05:59.327Z",
"capabilities": {
"canRemoveContentRestriction": false,
"canModifyOwnerContentRestriction": true,
"canModifyLabels": false,
"canAcceptOwnership": false,
"canChangeSecurityUpdateEnabled": false,
"canMoveItemWithinDrive": true,
"canRemoveMyDriveParent": true,
"canReadLabels": false,
"canAddMyDriveParent": false,
"canShare": true,
"canModifyContent": true,
"canUntrash": true,
"canMoveItemOutOfDrive": true,
"canMoveItemIntoTeamDrive": true,
"canModifyContentRestriction": true,
"canReadRevisions": true,
"canTrash": true,
"canRemoveChildren": false,
"canListChildren": false,
"canDownload": true,
"canDelete": true,
"canRename": true,
"canChangeCopyRequiresWriterPermission": true,
"canAddChildren": false,
"canComment": true,
"canModifyEditorContentRestriction": true,
"canMoveChildrenWithinDrive": false,
"canCopy": true,
"canChangeViewersCanCopyContent": true,
"canEdit": true
},
"md5Checksum": "85b6518b95b58536480354d9d5fc3d8b",
"copyRequiresWriterPermission": false,
"fileExtension": "jpg",
"originalFilename": "Новый файл.jpg",
"iconLink": "https://drive-thirdparty.googleusercontent.com/16/type/image/jpeg",
"viewersCanCopyContent": true,
"mimeType": "image/jpeg",
"kind": "drive#file",
"size": "2114025"
}
]
```

View File

@ -0,0 +1,136 @@
---
sidebar_position: 2
---
# Получить список каталогов
Получает список каталогов диска
*Функция ПолучитьСписокКаталогов(Знач Токен, Знач ИмяСодержит = "", Знач Подробно = Ложь) Экспорт*
| Параметр | Тип | Назначение |
|-|-|-|
| Токен | Строка | Токен доступа |
| ИмяСодержит | Строка (необяз.) | Отбор по нахождению строки в имени каталога |
| Подробно | Булево (необяз.) | Истина - добавляет к описанию каталога массив содержащихся в нем файлов (поле files - массив) |
Вовзращаемое значение: Массив из Соответствие - массив описаний каталогов
```bsl title="Пример кода"
Имя = "Описание";
Ответ = OPI_GoogleDrive.ПолучитьСписокКаталогов(Токен, Имя, Ложь); //Соответствие
Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка
```
```json title="Результат"
[
{
"linkShareMetadata": {
"securityUpdateEnabled": true,
"securityUpdateEligible": false
},
"modifiedByMe": true,
"quotaBytesUsed": "0",
"viewedByMeTime": "2024-03-13T06:02:50.470Z",
"createdTime": "2024-03-13T06:02:50.470Z",
"permissionIds": [
"07468399490707249352"
],
"modifiedByMeTime": "2024-03-13T06:02:50.470Z",
"explicitlyTrashed": false,
"trashed": true,
"id": "1VWoLK5w0uPVSjK3oyIXeiMtINN4jDOz4",
"starred": false,
"name": "ОписаниеДвижений",
"permissions": [
{
"pendingOwner": false,
"role": "owner",
"emailAddress": "bayselonarrend@gmail.com",
"photoLink": "https://lh3.googleusercontent.com/a/ACg8ocLx8JGurt0UjXFwwTiB6ZoDPWslW1EnfCTahrwrIllM6Q=s64",
"kind": "drive#permission",
"type": "user",
"deleted": false,
"displayName": "Антон Титовец",
"id": "07468399490707249352"
}
],
"spaces": [
"drive"
],
"webViewLink": "https://drive.google.com/drive/folders/1VWoLK5w0uPVSjK3oyIXeiMtINN4jDOz4",
"isAppAuthorized": false,
"owners": [
{
"photoLink": "https://lh3.googleusercontent.com/a/ACg8ocLx8JGurt0UjXFwwTiB6ZoDPWslW1EnfCTahrwrIllM6Q=s64",
"emailAddress": "bayselonarrend@gmail.com",
"permissionId": "07468399490707249352",
"me": true,
"kind": "drive#user",
"displayName": "Антон Титовец"
}
],
"version": "2",
"lastModifyingUser": {
"photoLink": "https://lh3.googleusercontent.com/a/ACg8ocLx8JGurt0UjXFwwTiB6ZoDPWslW1EnfCTahrwrIllM6Q=s64",
"emailAddress": "bayselonarrend@gmail.com",
"permissionId": "07468399490707249352",
"me": true,
"kind": "drive#user",
"displayName": "Антон Титовец"
},
"shared": false,
"hasThumbnail": false,
"parents": [
"1PAFI1-rThB46uix012xmLQ01h-JARjaz"
],
"ownedByMe": true,
"mimeType": "application/vnd.google-apps.folder",
"viewersCanCopyContent": true,
"iconLink": "https://drive-thirdparty.googleusercontent.com/16/type/application/vnd.google-apps.folder",
"viewedByMe": true,
"writersCanShare": true,
"folderColorRgb": "#8f8f8f",
"copyRequiresWriterPermission": false,
"capabilities": {
"canRemoveContentRestriction": false,
"canModifyOwnerContentRestriction": false,
"canModifyLabels": false,
"canAcceptOwnership": false,
"canChangeSecurityUpdateEnabled": false,
"canMoveItemWithinDrive": true,
"canRemoveMyDriveParent": true,
"canReadLabels": false,
"canAddMyDriveParent": false,
"canShare": true,
"canModifyContent": true,
"canUntrash": true,
"canMoveItemOutOfDrive": false,
"canMoveItemIntoTeamDrive": false,
"canModifyContentRestriction": false,
"canReadRevisions": false,
"canTrash": true,
"canRemoveChildren": true,
"canListChildren": true,
"canDownload": true,
"canDelete": true,
"canRename": true,
"canChangeCopyRequiresWriterPermission": false,
"canAddChildren": true,
"canComment": true,
"canModifyEditorContentRestriction": false,
"canMoveChildrenWithinDrive": true,
"canCopy": false,
"canChangeViewersCanCopyContent": false,
"canEdit": true
},
"modifiedTime": "2024-03-13T06:02:50.470Z",
"thumbnailVersion": "0",
"kind": "drive#file"
}
]
```

View File

@ -0,0 +1,24 @@
---
sidebar_position: 7
---
# Скачать файл
Возвращает двоичные данные файла по ID
*Функция СкачатьФайл(Знач Токен, Знач Идентификатор) Экспорт*
| Параметр | Тип | Назначение |
|-|-|-|
| Токен | Строка | Токен доступа |
| Идентификатор | Строка | Идентификатор файла |
Вовзращаемое значение: ДвоичныеДанные - двоичные данные файла
```bsl title="Пример кода"
Идентификатор = "1dg_MwwwPSPYT0p3y-8dvGWoapbwaaaaa";
Ответ = OPI_GoogleDrive.СкачатьФайл(Токен, Идентификатор); //Соответствие
Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка
```

View File

@ -0,0 +1,41 @@
---
sidebar_position: 5
---
# Скопировать объект
Копирует существующий файл или каталог Google Drive
*Функция СкопироватьОбъект(Знач Токен, Знач Идентификатор, Знач НовоеИмя = "", Знач НовыйРодитель = "") Экспорт*
| Параметр | Тип | Назначение |
|-|-|-|
| Токен | Строка | Токен доступа |
| Идентификатор | Строка | ID копируемого объекта |
| НовоеИмя | Строка (необяз.) | Новое имя файла |
| НовыйРодитель | Строка (необяз.) | Новое расположение (каталог) файла |
Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Google
```bsl title="Пример кода"
НовоеИмя = "Скопированный файл.jpeg";
НовоеРасположение = "1603PU_Hrkvj4HeFJKYSVxZJDRoGvd3SJ";
Идентификатор = "1F8pfXPgltiOG2fPv88uStwegYj1tRoFk";
Ответ = OPI_GoogleDrive.СкопироватьОбъект(Токен, Идентификатор, НовоеИмя, НовоеРасположение) //Соответствие
Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка
```
![Результат](img/2.png)
```json title="Результат"
{
"mimeType": "image/jpeg",
"name": "Скопированный файл.jpeg",
"id": "1uxsMaxL1W5Y7z6-HhjE6QpyDxFPgW4Fy",
"kind": "drive#file"
}
```

View File

@ -0,0 +1,38 @@
---
sidebar_position: 8
---
# Создать папку
Создает пустой каталог
*Функция СоздатьПапку(Знач Токен, Знач Имя, Знач Родитель = "") Экспорт*
| Параметр | Тип | Назначение |
|-|-|-|
| Токен | Строка | Токен доступа |
| Имя | Строка | Имя нового каталога |
| Родитель | Строка | ID родительского каталога (по умолчанию - корень) |
Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Google
```bsl title="Пример кода"
Имя = "Тестовая папка";
Ответ = OPI_GoogleDrive.СоздатьПапку(Токен, Имя); //Соответствие
Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка
```
![Результат](img/4.png)
```json title="Результат"
{
"mimeType": "application/vnd.google-apps.folder",
"name": "Тестовая папка",
"id": "1fIqr5pJV3QybT5sPeZhBD_0TIvtL5Ovc",
"kind": "drive#file"
}
```

View File

@ -0,0 +1,30 @@
---
sidebar_position: 9
---
# Удалить объект
Удаляет файл или каталог
*Функция УдалитьОбъект(Знач Токен, Знач Идентификатор) Экспорт*
| Параметр | Тип | Назначение |
|-|-|-|
| Токен | Строка | Токен доступа |
| Идентификатор | Строка | Идентификатор объекта |
Вовзращаемое значение: Пустой ответ
```bsl title="Пример кода"
Идентификатор = "1dg_MwwwPSPYT0p3y-8dvGWoapbwaaaaa";
Ответ = OPI_GoogleDrive.УдалитьОбъект(Токен, Идентификатор); //Соответствие
```
```json title="Результат"
''
```

View File

@ -0,0 +1,44 @@
---
sidebar_position: 4
---
# Загрузить файл
Загружает двоичные данные файла на Google Drive
*Функция ЗагрузитьФайл(Знач Токен, Знач Файл, Знач Описание) Экспорт*
| Параметр | Тип | Назначение |
|-|-|-|
| Токен | Строка | Токен доступа |
| Файл | ДвоичныеДанные,Строка | Двоичные данные или путь к файлу |
| Описание | Соответствие | Описание файла. См. [ПолучитьОписаниеФайла](./Poluchit-opisanye-fayla) |
Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Google
```bsl title="Пример кода"
Описание = Новый Соответствие;
Описание.Вставить("MIME" , "image/jpeg");
Описание.Вставить("Имя" , "Новый файл.jpg");
Описание.Вставить("Описание" , "Это новый файл");
Описание.Вставить("Родитель" , "root");
Картинка = "C:\OPI\image.jpg";
Ответ = OPI_GoogleDrive.ЗагрузитьФайл(Токен, Картинка, Описание); //Соответствие
Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //Строка
```
![Результат](img/1.png)
```json title="Результат"
{
"mimeType": "image/jpeg",
"name": "Новый файл.jpg",
"id": "16hPGNTMmbnXhz_g0vjGbrLP19h56RwIg",
"kind": "drive#file"
}
```

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.0 KiB

View File

@ -19,6 +19,7 @@ sidebar_position: 1
<a href="/docs/Notion/"><img src={require('../static/img/APIs/Notion.png').default} width='32px'/> </a>
<a href="/docs/Yandex_Disk/"><img src={require('../static/img/APIs/YandexDisk.png').default} width='32px'/> </a>
<a href="/docs/Google_Calendar/"><img src={require('../static/img/APIs/GoogleCalendar.png').default} width='32px'/> </a>
<a href="/docs/Google_Drive/"><img src={require('../static/img/APIs/GoogleDrive.png').default} width='32px'/> </a>
## Начало работы