# Интеграция с Vimeo


Интеграция с Vimeo переносит вашу медиатеку в Kinescope по API-ключу и позволяет догружать новые видео без повторных выгрузок и ручного скачивания файлов. Видео сохраняются в выбранную папку каталога в оригинальном качестве.

## Что даёт интеграция

Карточка Vimeo в разделе «Интеграции» открывается на вкладке **«Описание»** — там перечислены основные возможности:

1. **Выбор места сохранения.** Укажите проект или папку в Kinescope, куда будут перенесены видео из Vimeo — подробнее в статье [«Организация медиатеки»](https://docs.kinescope.ru/katalog-i-upravlenie-video/organizatsiya-mediateki-v-kinescope/).
2. **Защита и доступ.** Настройте конфиденциальность: [разрешённые домены и безопасные ссылки](https://docs.kinescope.ru/zashita-kontenta/ogranichenie-dostupa-k-video/), защиту паролем, а при необходимости — [DRM-шифрование](https://docs.kinescope.ru/zashita-kontenta/drm-shifrovanie-faylov/) и [динамические водяные знаки](https://docs.kinescope.ru/zashita-kontenta/dinamicheskie-i-staticheskie-vodyanye-znaki/).
3. **Аналитика и маркетинг.** Отслеживайте просмотры, географию и действия зрителей — [аналитика](https://docs.kinescope.ru/katalog-i-upravlenie-video/analitika/) пригодится для ретаргетинга и оптимизации контента.
4. **Внешний вид плеера.** Загрузите логотип, настройте цветовую схему и элементы управления под ваш бренд — см. [«Кастомизация плеера»](https://docs.kinescope.ru/videopleer-nastrojka-i-vstraivanie/kastomizatsiya-pleera/).

## Кому подходит эта статья

* **Владельцам медиатек на Vimeo** — нужно перенести видео в Kinescope и работать в одном пространстве
* **Администраторам платформ** — требуется регулярно подтягивать новые видео из аккаунта Vimeo
* **Создателям курсов** — нужно перенести обучающие материалы без потери доступа к видео на сайте
* **Разработчикам** — требуется таблица соответствия ID для замены ссылок на сайте или в приложении

> **Информация:**

Интеграция работает с аккаунтами Vimeo, у которых есть доступ к API — это тарифный план Pro и выше. Текущий план можно посмотреть [в разделе редактирования профиля Vimeo](https://vimeo.com/settings/profile/general). Если у вас другой тариф, перенос возможен через [поддержку](https://t.me/kinescope_bot) — подробности в статье [«Миграция с других платформ на Kinescope»](https://docs.kinescope.ru/nachalo-raboty/migratsiya-s-drugih-platform-na-kinescope/).



## Что понадобится

* Аккаунт Vimeo с доступом к API (Pro и выше)
* Токен доступа Vimeo с правом на чтение видео
* Проект или папка в каталоге Kinescope, куда сохранять видео

## Шаг 1. Создайте токен доступа в Vimeo

1. Войдите в [кабинет разработчика Vimeo](https://developer.vimeo.com/).
2. Создайте приложение и сгенерируйте персональный токен доступа (access token).
3. В правах токена оставьте как минимум разрешение на чтение видео — **Public** и **Private** для scope **Videos**.
4. Скопируйте токен — Vimeo показывает его только один раз.

> **Внимание:**

**Важно:** структура в Vimeo может быть организована папками или альбомами. По умолчанию используется структура папок. Если у вас альбомы, в правах токена дополнительно выберите разрешение **Edit**. Переносятся материалы, загруженные в Team Library.



![Настройка прав API-токена Vimeo: разрешение Edit для миграции из альбомов](images/int-vimeo-token-scopes.png)

## Шаг 2. Подключите интеграцию в Kinescope

1. Откройте раздел **«Интеграции»** в [панели управления Kinescope](https://app.kinescope.io/integrations) и выберите **Vimeo** — интеграция находится в категории «Социальные сети».
2. Нажмите **«Подключить»** или перейдите на вкладку **«Настройки»** — в блоке **«Подключение»** находятся все нужные поля.
3. В поле **«API-ключ Vimeo»** вставьте токен доступа из настроек приложения Vimeo.
4. В блоке **«Куда сохранять видео в Kinescope?»** нажмите **«Выбрать»** и укажите проект или папку для загруженных файлов.
5. Нажмите **«Сохранить»**.

Кнопка **«Сохранить»** становится активной, только когда заполнены оба поля — ключ и папка. После сохранения Kinescope проверяет ключ и его права: если ключ валиден, вы увидите, сколько видео будет скачано, и начнётся выгрузка медиатеки. Если ключ отозван, истёк или прав недостаточно — интеграция сообщит о невалидном токене, и его нужно перевыпустить в Vimeo и сохранить заново.

> **Информация:**

Количество видео в интеграции может отличаться от того, что вы видите в интерфейсе Vimeo: через API отдаются и видео с ошибками обработки.



## Шаг 3. Синхронизируйте новые видео

Кнопка **«Синхронизировать»** подгружает только те видео, которые появились в аккаунте Vimeo после последней синхронизации. Видео, удалённые в Vimeo, остаются в Kinescope — синхронизация не удаляет контент.

1. Откройте настройки интеграции Vimeo в разделе «Интеграции».
2. Нажмите **«Синхронизировать»**. Кнопка доступна только при валидном сохранённом ключе.
3. Следите за прогрессом: рядом с кнопкой отображается счётчик вида `5 из 1005`, где `5` — сколько новых видео уже загружено, а `1005` — сколько всего новых видео найдено в Vimeo.

### Статусы синхронизации

| Статус | Что означает |
| --- | --- |
| Синхронизация не запущена | Интеграция настроена, кнопка «Синхронизировать» активна |
| Идёт синхронизация, `{N} из {Total}` | Загружено `N` новых видео из `Total` найденных |
| Успешно | Синхронизация завершена, все новые видео загружены |
| Синхронизировано `{N} из {Total}` | Синхронизация завершена, часть видео не догрузилась |
| Ошибка | Проблема с ключом, доступом или Vimeo API — текст ошибки в подсказке |

Если часть видео не загрузилась (например, из-за сетевых ошибок, ограничений Vimeo API или проблем с конкретным файлом), нажмите **«Синхронизировать»** ещё раз — недозагруженные видео подтянутся при следующем запуске. Дубликаты не создаются: видео сверяются по идентификатору из Vimeo.

## Что происходит с видео после переноса

* Видео сохраняются в выбранную папку каталога и загружаются в оригинальном качестве.
* У видео указан источник — **Vimeo**.
* Переносятся метаданные видео по аналогии с другими интеграциями.
* После завершения загрузки можно скачать таблицу соответствия ID (Vimeo ID ↔ Kinescope ID) — с её помощью удобно автоматически заменить ссылки на видео на сайте или в приложении без потери доступа.

## Частые вопросы

{{< faq >}}
{{< faq-item id="vimeo-key-stopped" q="Ключ перестал работать — что делать?" >}}
Выпустите новый токен в [кабинете разработчика Vimeo](https://developer.vimeo.com/), вставьте его в поле «API-ключ Vimeo» и нажмите «Сохранить», затем запустите синхронизацию.
{{< /faq-item >}}

{{< faq-item id="vimeo-existing-videos" q="Загрузятся ли видео, которые были в Vimeo до подключения?" >}}
Да. При первом сохранении ключа Kinescope выгружает медиатеку аккаунта, а дальше кнопка «Синхронизировать» подтягивает только новые видео.
{{< /faq-item >}}

{{< faq-item id="vimeo-sync-twice" q="Что будет, если запустить синхронизацию дважды?" >}}
Ничего лишнего: видео сверяются по идентификатору из Vimeo, повторных копий не создаётся.
{{< /faq-item >}}

{{< faq-item id="vimeo-plan-below-pro" q="Что делать, если у меня тариф Vimeo ниже Pro?" >}}
Напишите в [поддержку](https://t.me/kinescope_bot) — перенос сделают вручную по списку ссылок для скачивания. Подробнее — в статье [«Миграция с других платформ на Kinescope»](https://docs.kinescope.ru/nachalo-raboty/migratsiya-s-drugih-platform-na-kinescope/).
{{< /faq-item >}}

{{< faq-item id="vimeo-delete-sync" q="Удалятся ли видео в Kinescope, если удалить их в Vimeo?" >}}
Нет. Синхронизация только добавляет новые видео — удаление в Vimeo на каталог Kinescope не влияет.
{{< /faq-item >}}
{{< /faq >}}

## Что дальше?

После переноса видео из Vimeo рекомендуем:

1. **[Организовать медиатеку](https://docs.kinescope.ru/katalog-i-upravlenie-video/organizatsiya-mediateki-v-kinescope/)** — разложите перенесённые видео по проектам и папкам
2. **[Настроить защиту контента](https://docs.kinescope.ru/zashita-kontenta/)** — включите DRM-шифрование, водяные знаки и ограничения по доменам
3. **[Настроить аналитику](https://docs.kinescope.ru/katalog-i-upravlenie-video/analitika/)** — отслеживайте просмотры и вовлечённость зрителей
4. **[Кастомизировать плеер](https://docs.kinescope.ru/videopleer-nastrojka-i-vstraivanie/kastomizatsiya-pleera/)** — настройте внешний вид плеера под ваш бренд
5. **[Миграция с других платформ](https://docs.kinescope.ru/nachalo-raboty/migratsiya-s-drugih-platform-na-kinescope/)** — если кроме Vimeo нужно перенести видео с YouTube, Wistia и других сервисов

Если остались вопросы, напишите в [чат поддержки](https://t.me/kinescope_bot) — специалисты помогут!