Подключение к Twitter из Power Apps
Twitter позволяет публиковать и получать твиты, временную шкалу, друзей и подписчиков из учетной записи Twitter.
Эти сведения можно отобразить в метке приложения. Например, можно добавить текстовое поле ввода, попросить пользователя ввести текст твита, а затем добавить кнопку, с помощью которой можно опубликовать твит. Используйте аналогичные методы для получения или поиска твитов, а затем отобразите текст в метке или в коллекции вашего приложения.
В этой статье показано, как создать и использовать подключение Twitter в приложении, а также перечислены доступные функции.
Предварительные условия
- Доступ к Power Apps
- Добавление подключения
- Создание приложения с помощью шаблона, на основе данных или с нуля
Подключение к Twitter
Начните с создания пустого приложения на основе холста.
На левой панели выберите Данные > Добавить данные.
Нажмите кнопку Добавить подключение, а затем выберите Twitter:
Выберите из общего приложения по умолчанию или выберите собственное приложение (вместе с ключом потребителя/секретом потребителя).
Нажмите Подключиться.
Выберите, введите учетные данные для входа в Twitter, а затем выберите Авторизовать приложение.
Выберите Добавить источник данных. Ваше подключение появится в разделе Источники данных.
Подключение Twitter создано и добавлено в приложение. Теперь оно готово к использованию.
Использование подключения Twitter в приложении
Отображение временной шкалы
В меню Вставка выберите Коллекция и добавьте любую из коллекций текстов в поле С текстом.
Рассмотрим некоторые временные шкалы.
Чтобы отобразить временную шкалу текущего пользователя, задайте для свойства Items коллекции следующие формулы:
Twitter.HomeTimeline().TweetText
Twitter.HomeTimeline({maxResults:3}).TweetText
Чтобы отобразить временную шкалу другого пользователя, задайте для свойства Items коллекции следующую формулу:
Twitter.UserTimeline( *TwitterHandle* ).TweetText
Введите имя пользователя Twitter, заключенное в двойные кавычки, или другое эквивалентное значение. Например, введите
"satyanadella"
или"powerapps"
непосредственно в выражении формулы.Добавьте элемент управления для ввода текста с именем Tweep, а для свойства по умолчанию задайте значение
Tweep.Text
. В текстовом поле Tweep введите имя пользователя Twitter, напримерsatyanadella
(без кавычек и символа @).В коллекции задайте для свойства Items следующую формулу:
Twitter.UserTimeline(Tweep.Text, {maxResults:5}).TweetText
В коллекции автоматически отображаются твиты указанного пользователя Twitter.
Совет
Чтобы отобразить последние х твитов на временной шкале, некоторые из этих формул используют аргумент maxResults.
Присвойте свойству Items коллекции значение
Twitter.HomeTimeline()
.Если выбрать коллекцию, в правой области отобразятся ее параметры.
В первом списке выберите TweetText, во втором — TweetedBy, а в третьем — CreatedAt.
Теперь в коллекции отображаются значения выбранных свойств.
Отображение подписчиков
Отобразим некоторых подписчиков с помощью коллекции С текстом:
Чтобы отобразить подписчиков текущего пользователя, задайте для свойства Items коллекции следующую формулу:
Twitter.MyFollowers()
Twitter.MyFollowers({maxResults:3})
Чтобы отобразить подписчиков другого пользователя, задайте для свойства Items коллекции следующую формулу:
Twitter.Followers( *TwitterHandle* )
Введите имя пользователя Twitter, заключенное в двойные кавычки, или другое эквивалентное значение. Например, введите
"satyanadella"
или"powerapps"
непосредственно в выражении формулы.Добавьте элемент управления для ввода текста с именем Tweep, а для свойства по умолчанию задайте значение
Tweep.Text
. В текстовом поле Tweep введите имя пользователя Twitter, напримерsatyanadella
(без кавычек и символа @).В коллекции задайте для свойства Items следующую формулу:
Twitter.Followers(Tweep.Text, {maxResults:5})
В коллекции автоматически отображаются подписчики указанного пользователя Twitter.
Совет
Чтобы отобразить последние х твитов на временной шкале, некоторые из этих формул используют аргумент maxResults.
Присвойте свойству Items коллекции значение
Twitter.MyFollowers()
.Если выбрать коллекцию, в правой области отобразятся ее параметры.
Во втором списке выберите UserName, а в третьем — FullName.
Теперь в коллекции отображаются значения выбранных свойств.
Отображение пользователей, на которых подписаны
Рассмотрим некоторых пользователей, на которых подписаны, с помощью коллекции С текстом:
Чтобы отобразить пользователей, на которых подписан текущий пользователь, задайте для свойства Items коллекции следующую формулу:
Twitter.MyFollowing()
Twitter.MyFollowing({maxResults:3})
Чтобы отобразить пользователей, на которых подписан другой пользователь, задайте для свойства Items коллекции следующую формулу:
Twitter.Following( *TwitterHandle* )
Введите имя пользователя Twitter, заключенное в двойные кавычки, или другое эквивалентное значение. Например, введите
"satyanadella"
или"powerapps"
непосредственно в выражении формулы.Добавьте элемент управления для ввода текста с именем Tweep, а для свойства по умолчанию задайте значение
Tweep.Text
. В текстовом поле Tweep введите имя пользователя Twitter, напримерsatyanadella
(без кавычек и символа @).В коллекции задайте для свойства Items следующую формулу:
Twitter.Following(Tweep.Text, {maxResults:5})
В коллекции автоматически отображаются имена других пользователей, на которых вы подписаны.
Если выбрать коллекцию, в правой области отобразятся ее параметры.
В списке Body1 выберите Description, в списке Heading1 — UserName, а в списке Subtitle1 — FullName.
Теперь в коллекции отображаются значения выбранных свойств.
Отображение сведений о пользователе
Добавьте метку и задайте для ее свойства Text одну из этих формул:
twitter.User( *TwitterHandle* ).Description
twitter.User( *TwitterHandle* ).FullName
twitter.User( *TwitterHandle* ).Location
twitter.User( *TwitterHandle* ).UserName
twitter.User( *TwitterHandle* ).FollowersCount
twitter.User( *TwitterHandle* ).FriendsCount
twitter.User( *TwitterHandle* ).Id
twitter.User( *TwitterHandle* ).StatusesCount
Введите имя пользователя Twitter, заключенное в двойные кавычки, или другое эквивалентное значение. Например, введите "satyanadella"
или "powerapps"
непосредственно в выражении формулы.
Вы также можете использовать элемент управления для ввода текста, чтобы ввести имя пользователя Twitter так же, как мы делали это ранее в этой статье.
Поиск твитов
Используйте коллекцию С текстом и задайте для свойства Items следующую формулу:
Twitter.SearchTweet( *SearchTerm* ).TweetText
Введите условие поиска, заключенное в двойные кавычки, или используйте другое эквивалентное значение. Например, непосредственно в формуле введите
"PowerApps"
или"microsoft"
.Чтобы указать условие поиска, можно использовать элемент управления Ввод текста так же, как мы делали это ранее в этой статье.
Совет
Отобразите первые пять результатов с помощью аргумента maxResults:
Twitter.SearchTweet(SearchTerm.Text, {maxResults:5}).TweetText
Присвойте свойству Items коллекции значение
Twitter.SearchTweet(SearchTerm.Text, {maxResults:5})
.Если выбрать коллекцию, в правой области отобразятся ее параметры.
В первом списке выберите TweetText, во втором — TweetedBy, а в третьем — CreatedAt.
Теперь в коллекции отображаются значения выбранных свойств.
Отправка твита
- Добавьте элемент управления для ввода текста и переименуйте его на MyTweet.
- Добавьте кнопку и задайте в качестве значения свойства OnSelect следующую формулу:
Twitter.Tweet("",{tweetText: MyTweet.Text})
Пример:Twitter.Tweet("",{tweetText:"Sample tweet!"})
- Нажмите клавишу F5 или кнопку предварительного просмотра (). Введите текст в MyTweet, а затем нажмите кнопку, чтобы опубликовать введенный текст.
- Нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.
Просмотр доступных функций
Это подключение включает следующие функции:
Имя функции | Описание |
---|---|
UserTimeline | Извлекает коллекцию последних твитов, опубликованную указанным пользователем |
HomeTimeline | Извлекает последние твиты и ретвиты пользователя и его подписчиков |
SearchTweet | Извлекает коллекцию актуальных твитов, соответствующих указанному запросу |
Followers | Извлекает данные о пользователях, подписавшихся на указанного пользователя |
MyFollowers | Извлекает данные о подписчиках пользователя |
Отслеживание | Извлекает данные о пользователях, на которых подписан указанный пользователь |
MyFollowing | Извлекает данные о пользователях, на которых подписан пользователь |
Пользователь | Извлекает подробные сведения об указанном пользователе (например, имя пользователя, описание, число подписчиков и т. д.) |
Tweet | Твит |
OnNewTweet | Запускает рабочий процесс при публикации нового твита, который соответствует условиям поиска |
UserTimeline
"Получить временную шкалу пользователя": извлекает коллекцию последних твитов, опубликованных указанным пользователем.
Входные свойства
Имя (название) | Тип данных | Обязательные | Описание |
---|---|---|---|
userName | string | да | Имя пользователя Twitter |
maxResults | integer | нет | Максимальное число возвращаемых твитов, например {maxResults:5} |
Выходные свойства
Имя свойства | Тип данных | Обязательные | Описание |
---|---|---|---|
TweetText | string | Да | |
TweetId | string | Нет | |
CreatedAt | string | Нет | |
RetweetCount | integer | Да | |
TweetedBy | string | Да | |
MediaUrls | array | Нет |
HomeTimeline
"Получить домашнюю временную шкалу": извлекает последние твиты и ретвиты пользователя и его подписчиков.
Входные свойства
Имя (название) | Тип данных | Обязательные | Описание |
---|---|---|---|
maxResults | integer | нет | Максимальное число возвращаемых твитов, например {maxResults:5} |
Выходные свойства
Имя свойства | Тип данных | Обязательные | Описание |
---|---|---|---|
TweetText | string | Да | |
TweetId | string | Нет | |
CreatedAt | string | Нет | |
RetweetCount | integer | Да | |
TweetedBy | string | Да | |
MediaUrls | array | Нет |
SearchTweet
Поиск твитов: извлекает коллекцию актуальных твитов, соответствующих указанному запросу.
Входные свойства
Имя (название) | Тип данных | Обязательные | Описание |
---|---|---|---|
searchQuery | string | да | Текст запроса (вы можете использовать любые операторы запросов, поддерживаемые в Twitter: https://www.twitter.com/search) |
maxResults | integer | нет | Максимальное число возвращаемых твитов, например {maxResults:5} |
Выходные свойства
Имя свойства | Тип данных | Обязательные | Описание |
---|---|---|---|
TweetText | string | Да | |
TweetId | string | Нет | |
CreatedAt | string | Нет | |
RetweetCount | integer | Да | |
TweetedBy | string | Да | |
MediaUrls | array | Нет |
Followers
Получение подписчиков: извлекает данные о пользователях, подписавшихся на указанного пользователя.
Входные свойства
Имя (название) | Тип данных | Обязательные | Описание |
---|---|---|---|
userName | string | да | Обработчик Twitter пользователя |
maxResults | integer | нет | Максимальное число возвращаемых пользователей, например {maxResults:5} |
Выходные свойства
Имя свойства | Тип данных | Обязательные | Описание |
---|---|---|---|
FullName | string | Да | |
Местоположение | string | Да | |
Артикул | integer | Нет | |
UserName | string | Да | |
FollowersCount | integer | Нет | |
Описание | string | Да | |
StatusesCount | integer | Нет | |
FriendsCount | integer | Нет |
MyFollowers
Получить моих читателей: извлекает данные о подписчиках пользователя.
Входные свойства
Имя (название) | Тип данных | Обязательные | Описание |
---|---|---|---|
maxResults | integer | нет | Максимальное число возвращаемых пользователей, например {maxResults:5} |
Выходные свойства
Имя свойства | Тип данных | Обязательные | Описание |
---|---|---|---|
FullName | string | Да | |
Местоположение | string | Да | |
Артикул | integer | Нет | |
UserName | string | Да | |
FollowersCount | integer | Нет | |
Описание | string | Да | |
StatusesCount | integer | Нет | |
FriendsCount | integer | Нет |
Отслеживание
Получить читаемых пользователей: извлекает данные о пользователях, на которых подписан указанный пользователь.
Входные свойства
Имя (название) | Тип данных | Обязательные | Описание |
---|---|---|---|
userName | string | да | Обработчик Twitter пользователя |
maxResults | integer | нет | Максимальное число возвращаемых пользователей, например {maxResults:5} |
Выходные свойства
Имя свойства | Тип данных | Обязательные | Описание |
---|---|---|---|
FullName | string | Да | |
Местоположение | string | Да | |
Артикул | integer | Нет | |
UserName | string | Да | |
FollowersCount | integer | Нет | |
Описание | string | Да | |
StatusesCount | integer | Нет | |
FriendsCount | integer | Нет |
MyFollowing
Получить читаемых мною пользователей: извлекает данные о пользователях, на которых подписан пользователь.
Входные свойства
Имя (название) | Тип данных | Обязательные | Описание |
---|---|---|---|
maxResults | integer | нет | Максимальное число возвращаемых пользователей, например {maxResults:5} |
Выходные свойства
Имя свойства | Тип данных | Обязательные | Описание |
---|---|---|---|
FullName | string | Да | |
Местоположение | string | Да | |
Артикул | integer | Нет | |
UserName | string | Да | |
FollowersCount | integer | Нет | |
Описание | string | Да | |
StatusesCount | integer | Нет | |
FriendsCount | integer | Нет |
User
Получить пользователя: извлекает подробные сведения об указанном пользователе (например, имя пользователя, описание, число подписчиков и т. д.).
Входные свойства
Имя (название) | Тип данных | Обязательные | Описание |
---|---|---|---|
userName | string | да | Обработчик Twitter пользователя |
Выходные свойства
Имя свойства | Тип данных | Обязательные | Описание |
---|---|---|---|
FullName | string | Да | |
Местоположение | string | Да | |
Артикул | integer | Нет | |
UserName | string | Да | |
FollowersCount | integer | Нет | |
Описание | string | Да | |
StatusesCount | integer | Нет | |
FriendsCount | integer | Нет |
Tweet
Опубликовать новый твит: твит
Входные свойства
Имя (название) | Тип данных | Обязательные | Описание |
---|---|---|---|
tweetText | string | нет | Публикуемый текст, например {tweetText:"hello"} |
текст | string | нет | Публикуемый файл мультимедиа |
Выходные свойства
Имя свойства | Тип данных | Обязательные | Описание |
---|---|---|---|
TweetId | string | Да |
OnNewTweet
При появлении нового твита: запускает рабочий процесс при публикации нового твита, который соответствует условиям поиска.
Входные свойства
Имя (название) | Тип данных | Обязательные | Описание |
---|---|---|---|
searchQuery | string | да | Текст запроса (вы можете использовать любые операторы запросов, поддерживаемые в Twitter: https://www.twitter.com/search) |
Выходные свойства
Имя свойства | Тип данных | Обязательные | Описание |
---|---|---|---|
значение | array | Нет |
Полезные ссылки
Сведения о всех доступных подключениях см. здесь.
Узнайте, как добавлять подключения в приложения.
Примечание
Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).
Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).