Яндекс Диск

Доступные операции

Папки и навигация:
  • Создать папку по указанному пути на Яндекс Диске пользователя.

  • Показать файлы и папки по указанному пути на Яндекс Диске пользователя.

  • Показать плоский список файлов Диска с пагинацией и фильтром по типу медиа.

  • Показать последние файлы, загруженные пользователем на Яндекс Диск.

Чтение и скачивание файлов:
  • Скачать файл любого типа в файлы текущей сессии по временной ссылке.

  • Скачать и декодировать небольшой текстовый документ с Яндекс Диска.

  • Получить временную ссылку для скачивания файла с Яндекс Диска.

  • Получить квоту хранилища и общие сведения об авторизованном Яндекс Диске.

Загрузка файлов:
  • Потоково загрузить файл текущей session на Яндекс Диск.

  • Начать импорт по URL; проверять возвращённый href через операцию статуса.

  • Закодировать и загрузить небольшой текстовый документ на Яндекс Диск.

  • Получить временную ссылку для загрузки файла без передачи байтов через инструмент.

Изменение ресурсов:
  • Скопировать файл или папку в другой путь на Яндекс Диске пользователя.

  • Переместить или переименовать файл либо папку на Яндекс Диске пользователя.

  • Удалить ресурс Диска; недоступно, пока разрушающие операции отключены.

Публикация:
  • Опубликовать ресурс Диска после явного подтверждения пользователя.

  • Закрыть публичный доступ к ранее опубликованному ресурсу Яндекс Диска.

  • Показать файлы и папки, опубликованные текущим пользователем Яндекс Диска.

  • Получить временную ссылку для скачивания опубликованного файла.

  • Получить метаданные или содержимое опубликованного ресурса Яндекс Диска.

  • Сохранить опубликованный ресурс на мой Диск и вернуть ссылку на операцию.

Корзина:
  • Показать файлы и папки по указанному пути в Корзине Яндекс Диска.

  • Восстановить ресурс из Корзины после явного подтверждения пользователя.

Документы:
  • Показать офисные, PDF-, Markdown- и текстовые документы на странице Диска.

  • Прочитать небольшой документ .txt или .md с Яндекс Диска.

  • Создать или заменить небольшой документ .txt или .md на Яндекс Диске.

Асинхронные операции:
  • Получить статус операции по её ID или официальному href Яндекс Диска.

Настройки и возможности интеграции:
  • Показать состояние конфигурации без раскрытия токенов и секретов клиентов.

  • Показать доступные интеграции с сервисами Яндекса и их ограничения.

Подготовка и добавление из витрины

Подготовка выполняется администратором GigaCowork.
В витрине интеграций доступны два шаблона для работы с Яндекс Диском:
  • Яндекс Диск — личный. Для личных аккаунтов Яндекс (доступна только индивидуальная авторизация).

  • Яндекс Диск — корпоративный. Для корпоративных аккаунтов Яндекс.

Для работы требуется созданное OAuth-приложение яндекса.

Для создания приложения:
  1. Перейдите по адресу https://oauth.yandex.ru и авторизуйтесь в учетной записи Яндекс.

  2. Выберите Ваши приложения → Создать и выберите Для авторизации пользователей.

    connector yandex calendar 0
  3. Если аккаунт не верифицирован на Госуслугах, будет предложено его верифицировать. Шаг опциональный.

  4. Укажите название для сервиса, почту и иконку приложения.

    connector yandex calendar 1
  5. Выберите Веб-сервисы и вставьте Redirect URl.

    connector yandex calendar 2
    Где взять Redirect URl:
    1. В разделе button settings Администрирование → button blocks Интеграции нажмите Добавить интеграцию.

    2. В витрине интеграций откройте подключаемую интеграцию.

    3. Нажмите Далее и скопируйте значение из поля Callback URL.

  6. Предоставьте доступ к данным: Доступ к адресу электронной почты и Доступ к логину, имени и фамилии, полу. Также выберите дополнительные доступы для диска, которые будут разрешены в интеграции (начинаются со слова disk):

    • yadisk:disk — Доступ к Яндекс.Диску для приложений.

    • cloud_api:disk.app_folder — Доступ к папке приложения на Диске.

    • cloud_api:disk.read — Чтение всего Диска.

    • cloud_api:disk.write — Запись в любом месте на Диске.

    • cloud_api:disk.info — Доступ к информации о Диске.

    connector yandex calendar 3
  7. Убедитесь, что все данные указаны верно и нажмите Создать приложение.

  8. Если добавляете интеграцию с корпоративным диском, дополнительно активируйте функцию сервисных приложений с помощью запроса:
    POST https://api360.yandex.net/security/v1/org/<org_id>/service_applications/activate.
    Где org_id — ID организации, который можно взять на странице организации, в нижней части меню.

    connector yandex calendar 5
  9. Скопируйте в созданном приложении ClientID и Client secret.

    connector yandex calendar 4
  10. Вставьте полученные ClientID и Client secret в поля ClientID OAuth-приложения и Client secret OAuth-приложения соответственно, в окне добавления интеграции из витрины.

  11. Нажмите Далее, а затем Добавить.

Авторизация в интеграции

Для работы с интеграцией:
  1. Проверьте, что интеграция находится в разделе button grid 2x2 Каталоги → button blocks Интеграции. Если ее нет, попросите администратора GigaCowork ее включить.

  2. Откройте интеграцию и нажмите Войти в аккаунт. Интеграция уже может быть авторизована администратором, а кнопка входа и выхода из аккаунта недоступна. Это означает, что с ней уже можно работать.

  3. Укажите учетные данные вашего аккаунта Яндекс.