Меню Закрыть

Создание интеграций с помощью Notion API

Последнее изменение: 11.08.2023
Вы здесь:
Расчетное время чтения: 1 мин
Создание интеграций с помощью Notion API

С помощью API Notion вы сможете создавать собственные внутренние интеграции. Некоторые из наших партнеров могут потребовать токен внутренней интеграции, чтобы связать свою платформу с вашим рабочим пространством Notion. Ниже мы расскажем, как это сделать 🏗️.

Посетите наш центр разработчика для получения документации, ресурсов и средств управления интеграцией.

Создание внутренней интеграции

  • На левой боковой панели перейдите в раздел Настройки и участники, а затем на вкладку Интеграции.
  • Доступ к вкладке “Интеграции” и создание интеграций могут иметь только владельцы рабочих пространств. Если вы не являетесь администратором, обратитесь к администратору рабочей области или используйте другую рабочую область.
  • Щелкните на ссылке Разработка собственных интеграций в нижней части страницы.
  • Мои интеграции откроются в браузере по умолчанию. Нажмите кнопку + Новая интеграция.
Создание интеграций с помощью Notion API
Примечание: Убедитесь, что вы вошли в систему Notion в веб-сессии под той же учетной записью, что и на настольном компьютере. В противном случае вы не увидите правильную учетную запись и рабочие пространства!
  • Укажите название вашей интеграции. По желанию можно также загрузить изображение для использования в качестве логотипа.
  • С помощью выпадающего меню укажите, с каким рабочим пространством Associated вы хотите использовать эту интеграцию.
Создание интеграций с помощью Notion API
Примечание: Внутренние интеграции зависят от рабочего пространства, поэтому для изменения связанного с ними рабочего пространства необходимо создать новую интеграцию.
  • Ваша внутренняя интеграция успешно добавлена! Теперь вы сможете увидеть ее в своем рабочем пространстве, в меню Settings & members → My integrations.
Создание интеграций с помощью Notion API
  • Нажмите кнопку ••• рядом с внутренней интеграцией, чтобы получить маркер внутренней интеграции. Этот маркер понадобится для автоматизации и создания рабочих процессов на основе API, а также для связи рабочей области с некоторыми партнерскими платформами.

Создание общественной интеграции

Все вновь добавляемые интеграции изначально являются внутренними. Если вы являетесь разработчиком, работающим над публичной интеграцией, сначала воспользуйтесь приведенными выше инструкциями для создания внутренней интеграции.

Затем, следуя инструкциям в нашем руководстве для разработчиков, преобразуйте ее в публичную интеграцию.

Гранулярные разрешения на интеграцию

В процессе настройки приложения разработчики смогут выбрать необходимый уровень доступа для пользователя.

  • Контентные возможности:
    • Только чтение контента
    • Только запись контента
    • Вставка контента
  • Возможности пользователя
    • Нет информации о пользователе
    • Считывание информации о пользователе (без учета адреса электронной почты пользователя)
    • Чтение информации о пользователе (включая адрес электронной почты)

Когда пользователи устанавливают интеграции, этот уровень доступа будет отображаться. Он также будет отображаться в меню Share всех страниц, на которые была добавлена интеграция. Подробнее об установке интеграций в рабочую область →

Была ли эта статья полезной?
Нет 0
Просмотров: 265

Читать далее

Предыдущий: Добавление и управление подключениями к API
Следующий: Экспорт контента