Поделиться через

X

X, ранее известный как Twitter, — это интернет-служба социальных сетей, которая позволяет пользователям отправлять и получать короткие записи. Подключитесь к X для управления записями. Вы можете выполнять различные действия, такие как отправка записей, поиск, просмотр подписчиков и т. д.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Стандарт Все регионы Power Automate , кроме следующих:
     — Облако Китая, управляемое 21Vianet
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Стандарт Все регионы Power Apps , кроме следующих:
     — Облако Китая, управляемое 21Vianet
Power Automate Стандарт Все регионы Power Automate , кроме следующих:
     — Облако Китая, управляемое 21Vianet
Контакт
Имя Microsoft
URL Поддержка Microsoft LogicApps
Поддержка Microsoft Power Automate
Поддержка Microsoft Power Apps
Метаданные соединителя
Publisher Microsoft
Веб-сайт https://x.com/
Политика конфиденциальности https://x.com/privacy

Проверка подлинности и создание собственного приложения

Это важно

Общее приложение по умолчанию (клиентское приложение Twitter, поддерживаемое корпорацией Майкрософт), больше не доступно. Соединитель теперь поддерживает только один тип проверки подлинности. Введите собственное приложение. По состоянию на июнь 2023 года требуется платное приложение уровня Enterprise. Однако политика ценообразования Twitter может продолжать меняться.

С помощью параметра "Принести собственное приложение" вы можете использовать собственное клиентское приложение OAuth Twitter. Это позволяет управлять разрешениями и включать определенные ограничения на использование соединителя.

Чтобы использовать собственное клиентское приложение Twitter OAuth с соединителем Twitter, вам потребуется выполнить следующие действия:

  1. Создание клиентского приложения OAuth с помощью страницы разработчика Twitter (https://developer.twitter.com)
  2. Использование приложения в соединителе Twitter

Создание клиентского приложения OAuth в Twitter

Чтобы создать собственное клиентское приложение Twitter OAuth, необходимо сначала войти в https://developer.twitter.comсистему. Перейдите в раздел "Проекты и приложения", где можно управлять приложениями twitter и создавать их. Этот процесс описан в руководстве разработчика Twitter в Twitter. После создания приложения Twitter на странице разработчика необходимо выполнить следующие действия для правильной настройки:

  • Выбор приложения Twitter
  • Изменение разрешений приложения для включения чтения и записи.
  • Изменение параметров проверки подлинности
    • Включение 3-сторонней проверки подлинности
    • Добавьте https://global.consent.azure-apim.net/redirect URL-адреса обратного вызова (ПРИМЕЧАНИЕ. Если вы используете подписку Fairfax или среду GCC, ознакомьтесь с разделом "Fairfax и GCC callbacks")
    • Задайте "URL-адрес веб-сайта" (обязательное поле, но это значение не влияет на поток)

Обратные вызовы Fairfax и GCC

Если вы используете подписку Fairfax или среду GCC, добавьте следующие URL-адреса для URL-адресов обратного вызова приложения Twitter:

  • Для Fairfax:
    • https://logic-apis-usgovvirginia.consent.azure-apihub.us/redirect
    • https://logic-apis-usgovtexas.consent.azure-apihub.us/redirect
    • https://logic-apis-usgovarizona.consent.azure-apihub.us/redirect
  • Для GCC:
    • https://power-apis-usgov001-public.consent.azure-apihub.us/redirect

После завершения выберите свое приложение twitter и перейдите на страницу "Ключи и маркеры". В разделе "Ключи потребителей" нажмите кнопку "Просмотреть ключи", чтобы получить ключ API и секрет ключа API приложения. Теперь эти значения можно использовать в подключении Twitter.

Использование собственного приложения в соединителе Twitter

После создания клиентского приложения OAuth Twitter его можно использовать при создании подключения к Twitter.

  • Выберите "Принести собственное приложение".
  • Укажите значения идентификатора клиента и секрета клиента из приложения. (Используйте ключ API и секрет ключа API приложения Twitter)

Нажмите кнопку "Войти" , чтобы войти в учетную запись Twitter. Это предложит вам войти в учетную запись Twitter, а затем авторизовать доступ к созданному выше приложению Twitter.

ОГРАНИЧЕНИЯ

Ниже приведены некоторые ограничения и ограничения.

  1. Максимальное количество подключений на пользователя: 2
  2. Ограничение частоты вызовов API для операции POST: 12 в час
  3. Ограничение частоты вызовов API для других операций: 600 в час
  4. Частота опросов триггеров: 1 час
  5. Максимальный размер отправки изображения: 5 МБ
  6. Максимальный размер отправки видео: 15 МБ
  7. Максимальное количество результатов поиска: 100
  8. Максимальное количество новых твитов, отслеживаемых в пределах одного интервала опроса: 5
  9. Максимальная допустимая длина параметра "Поиск текста" составляет 470

Ограничения API Twitter

  1. Поиск API выполняет поиск по выборке последних твитов, опубликованных за последние 7 дней
  2. API стандартного поиска ориентирован на релевантность и не полноту. Это означает, что некоторые твиты и пользователи могут быть отсутствуют в результатах поиска

Дополнительные ограничения для операции POST

@user Упоминание о публикации твита не поддерживается. В частности, символы "@" будут лишены во время публикации твита.

Общие ограничения

Имя Ценность
Подключения для каждой учетной записи 2

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:
Принесите собственное приложение Войдите с помощью собственного приложения Twitter. Дополнительные сведения см. в разделе "Проверка подлинности и создание собственного приложения" на этой странице. Все регионы Недоступен для совместного использования
По умолчанию [не рекомендуется] Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости. Все регионы Недоступен для совместного использования

Создание собственного приложения

Идентификатор auth: byoa

Применимо: все регионы

Войдите с помощью собственного приложения Twitter. Дополнительные сведения см. в разделе "Проверка подлинности и создание собственного приложения" на этой странице.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Description Обязательно
Ключ потребителя струна Ключ потребителя приложения Twitter True
Секрет потребителя securestring Секрет клиента приложения Twitter True

По умолчанию [не рекомендуется]

Применимо: все регионы

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

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Действия

Retweet

Эта операция повторяет твит.
Поиск твитов

Эта операция получает список соответствующих твитов, соответствующих поисковому запросу.
Получение временной шкалы пользователя

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

Эта операция получает самые последние твиты и повторно твиты, опубликованные мной и моими последователями.
Получение моих последователей

Эта операция получает список пользователей, которые следуют за мной.
Получение подписчиков

Эта операция получает список пользователей, следующих за заданным пользователем.
Получение пользователя

Эта операция получает сведения о профиле для данного пользователя, например имя пользователя, описание, число подписчиков и многое другое.
Получите мое следующее

Эта операция получает список пользователей, которые я использую.
Получите следующее

Операция получает список пользователей, которые пользователь следует.
Публикация твита

Эта операция публикует новый твит.

Retweet

Идентификатор операции:
Retweet

Эта операция повторяет твит.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор твита
 tweetId True string

Твит, чтобы быть retweeted.
Обрезка пользователя
 trimUser boolean

Логическое значение, указывающее, следует ли обрезать сведения о пользователе.

Возвращаемое значение

Представляет ответ записи твита.

Тело
TweetResponseModel

Поиск твитов

Идентификатор операции:
SearchTweet

Эта операция получает список соответствующих твитов, соответствующих поисковому запросу.

Параметры

Имя Ключ Обязательно Тип Описание
Поиск текста
 searchQuery True string

Поисковый термин, например "счастливый час", #haiku, от:@username, любовь ИЛИ ненависть.
Максимальные результаты
 maxResults integer

Максимальное количество твитов для возврата.
sinceId
 sinceId string

Возвращает твиты после указанного идентификатора твита.

Возвращаемое значение

response
array of TweetModel

Получение временной шкалы пользователя

Идентификатор операции:
UserTimeline

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

Параметры

Имя Ключ Обязательно Тип Описание
Имя пользователя
 userName True string

Дескриптор X для пользователя.
Максимальные результаты
 maxResults integer

Максимальное количество твитов для возврата.

Возвращаемое значение

response
array of TweetModel

Получение домашней временной шкалы

Идентификатор операции:
HomeTimeline

Эта операция получает самые последние твиты и повторно твиты, опубликованные мной и моими последователями.

Параметры

Имя Ключ Обязательно Тип Описание
Максимальные результаты
 maxResults integer

Максимальное количество твитов для возврата.

Возвращаемое значение

response
array of TweetModel

Получение моих последователей

Идентификатор операции:
MyFollowers

Эта операция получает список пользователей, которые следуют за мной.

Параметры

Имя Ключ Обязательно Тип Описание
Максимальные результаты
 maxResults integer

Максимальное число пользователей для получения.

Возвращаемое значение

response
array of UserDetailsModel

Получение подписчиков

Идентификатор операции:
Followers

Эта операция получает список пользователей, следующих за заданным пользователем.

Параметры

Имя Ключ Обязательно Тип Описание
Имя пользователя
 userName True string

Дескриптор X для пользователя.
Максимальные результаты
 maxResults integer

Максимальное количество возвращаемых пользователей.

Возвращаемое значение

response
array of UserDetailsModel

Получение пользователя

Идентификатор операции:
User

Эта операция получает сведения о профиле для данного пользователя, например имя пользователя, описание, число подписчиков и многое другое.

Параметры

Имя Ключ Обязательно Тип Описание
Имя пользователя
 userName True string

Дескриптор X для пользователя.

Возвращаемое значение

Представляет пользователя.

Тело
UserDetailsModel

Получите мое следующее

Идентификатор операции:
MyFollowing

Эта операция получает список пользователей, которые я использую.

Параметры

Имя Ключ Обязательно Тип Описание
Максимальные результаты
 maxResults integer

Максимальное количество возвращаемых пользователей.

Возвращаемое значение

response
array of UserDetailsModel

Получите следующее

Идентификатор операции:
Following

Операция получает список пользователей, которые пользователь следует.

Параметры

Имя Ключ Обязательно Тип Описание
Имя пользователя
 userName True string

Дескриптор X для пользователя.
Максимальные результаты
 maxResults integer

Максимальное количество возвращаемых пользователей.

Возвращаемое значение

response
array of UserDetailsModel

Публикация твита

Идентификатор операции:
Tweet

Эта операция публикует новый твит.

Параметры

Имя Ключ Обязательно Тип Описание
Текст твита
 tweetText string

Текст для публикации.
Средства массовой информации
 body binary

Носитель для публикации.

Возвращаемое значение

Представляет ответ записи твита.

Тело
TweetResponseModel

Триггеры

При публикации нового твита

Эта операция активирует поток при публикации нового твита, соответствующего заданному поисковому запросу.

При публикации нового твита

Идентификатор операции:
OnNewTweet

Эта операция активирует поток при публикации нового твита, соответствующего заданному поисковому запросу.

Параметры

Имя Ключ Обязательно Тип Описание
Поиск текста
 searchQuery True string

Поисковый термин, например "счастливый час", #haiku, от:@username, любовь ИЛИ ненависть.

Возвращаемое значение

Представляет объект-оболочку для ответа пакетного триггера

Тело
TriggerBatchResponse[TweetModel]

Определения

TweetModel

Представляет запись твита.

Имя Путь Тип Описание
Текст твита
 TweetText string

Текстовое содержимое твита
Идентификатор твита
 TweetId string

Идентификатор твита
Время создания
 CreatedAtIso string

Время публикации твита
Retweet count
 RetweetCount integer

Общее количество повторных твитов для твита
Чирикал
 TweetedBy string

Имя пользователя, который опубликовал твит
URL-адреса мультимедиа
 MediaUrls array of string

URL-адрес средств массовой информации, опубликованных вместе с твитом
Язык твита
 TweetLanguageCode string

Языковой код твита
in_reply_to_user_id
 TweetInReplyToUserId string

Идентификатор пользователя автора твита, на который текущий твит является ответом
Избранное
 Favorited boolean

Указывает, помечен ли твит как избранное или нет
Упоминания пользователей
 UserMentions array of UserMentionsModel

Список пользователей, упомянутых в твиттере
OriginalTweet
 OriginalTweet OriginalTweetModel

Представляет исходную запись твита.
Сведения о пользователе
 UserDetails UserDetailsModel

Представляет пользователя.

UserMentionsModel

Представляет пользователя, упоминаемого в твиттере.

Имя Путь Тип Описание
Указанный идентификатор пользователя
 Id integer

Идентификатор X (дескриптор) пользователя
Указанное имя пользователя
 FullName string

Полное имя пользователя
Указанное имя пользователя
 UserName string

Имя экрана пользователя

OriginalTweetModel

Представляет исходную запись твита.

Имя Путь Тип Описание
Исходный текст твита
 TweetText string

Текстовое содержимое исходного полученного твита
Исходный идентификатор твита
 TweetId string

Идентификатор исходного твита
Исходный твит, созданный в
 CreatedAtIso string

Время публикации исходного твита
Исходное число retweet твита
 RetweetCount integer

Общее количество повторных твитов для этого исходного твита
Оригинальный твит, чирикал
 TweetedBy string

Имя пользователя, который опубликовал исходный твит
Исходные URL-адреса мультимедиа твита
 MediaUrls array of string

URL-адрес носителя, размещенного вместе с исходным твитом
Исходный язык твита
 TweetLanguageCode string

Языковой код для исходного твита
Исходный твит in_reply_to_user_id
 TweetInReplyToUserId string

Идентификатор пользователя автора твита, что текущий исходный твит является ответом на
Исходный твит избранное
 Favorited boolean

Указывает, помечен ли исходный твит как избранное
Исходные упоминания пользователя твита
 UserMentions array of OriginalTweetUserMentionsModel

Список пользователей, упомянутых в твиттере
Сведения о пользователе
 UserDetails OriginalTweetUserDetailsModel

Представляет пользователя, который опубликовал исходный твит

UserDetailsModel

Представляет пользователя.

Имя Путь Тип Описание
Имя
 FullName string

Имя пользователя
Местоположение
 Location string

Расположение пользователя
Идентификатор пользователя
 Id integer

Идентификатор X (дескриптор) пользователя
Имя пользователя
 UserName string

Имя экрана пользователя
Число подписчиков
 FollowersCount integer

Число последователей
Description
 Description string

Описание пользователя
Количество состояний
 StatusesCount integer

Число состояний пользователя
Количество друзей
 FriendsCount integer

Количество друзей
Количество фаворитов
 FavouritesCount integer

Количество твитов, избранных пользователем
URL-адрес изображения профиля
 ProfileImageUrl string

URL-адрес изображения профиля

OriginalTweetUserMentionsModel

Представляет пользователя, упоминаемого в исходном твите.

Имя Путь Тип Описание
Исходный твит упомянул идентификатор пользователя
 Id integer

Идентификатор X (дескриптор) пользователя
Исходное твит о полном имени пользователя
 FullName string

Полное имя пользователя
Исходное имя пользователя, указанное в твиттере
 UserName string

Имя экрана пользователя

OriginalTweetUserDetailsModel

Представляет пользователя, который опубликовал исходный твит

Имя Путь Тип Описание
Полное имя пользователя твита
 FullName string

Имя пользователя
Исходное расположение пользователя твита
 Location string

Расположение пользователя
Исходный идентификатор пользователя твита
 Id integer

Идентификатор X (дескриптор) пользователя
Исходное имя пользователя твита
 UserName string

Имя экрана пользователя
Число подписчиков пользователей в твиттере
 FollowersCount integer

Число последователей
Исходное описание пользователя твита
 Description string

Описание пользователя
Число исходных состояний пользователя твита
 StatusesCount integer

Число состояний пользователя
Исходное число друзей пользователей твита
 FriendsCount integer

Количество друзей
Исходное число избранных пользователей твита
 FavouritesCount integer

Количество твитов, избранных пользователем
Исходный URL-адрес профиля пользователя твита
 ProfileImageUrl string

URL-адрес изображения профиля

TweetResponseModel

Представляет ответ записи твита.

Имя Путь Тип Описание
Идентификатор твита
 TweetId string

Идентификатор размещенного твита

TriggerBatchResponse[TweetModel]

Представляет объект-оболочку для ответа пакетного триггера

Имя Путь Тип Описание
value
 value array of TweetModel

Список объектов ответа