Подключение к Twitter из Power Apps

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

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

В этой статье показано, как создать и использовать подключение Twitter в приложении, а также перечислены доступные функции.

Предварительные условия

• Доступ к Power Apps
• Добавление подключения
• Создание приложения с помощью шаблона, на основе данных или с нуля

Подключение к Twitter

1. Начните с создания пустого приложения на основе холста.

2. На левой панели выберите Данные > Добавить данные.

3. Нажмите кнопку Добавить подключение, а затем выберите Twitter:

   

4. Выберите из общего приложения по умолчанию или выберите собственное приложение (вместе с ключом потребителя/секретом потребителя).

5. Нажмите Подключиться.

6. Выберите, введите учетные данные для входа в Twitter, а затем выберите Авторизовать приложение.

7. Выберите Добавить источник данных. Ваше подключение появится в разделе Источники данных.
   

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

Использование подключения Twitter в приложении

Отображение временной шкалы

1. В меню Вставка выберите Коллекция и добавьте любую из коллекций текстов в поле С текстом.

2. Рассмотрим некоторые временные шкалы.

   • Чтобы отобразить временную шкалу текущего пользователя, задайте для свойства 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.

3. Присвойте свойству Items коллекции значение Twitter.HomeTimeline().

   Если выбрать коллекцию, в правой области отобразятся ее параметры.

4. В первом списке выберите TweetText, во втором — TweetedBy, а в третьем — CreatedAt.

   Теперь в коллекции отображаются значения выбранных свойств.

Отображение подписчиков

1. Отобразим некоторых подписчиков с помощью коллекции С текстом:

   • Чтобы отобразить подписчиков текущего пользователя, задайте для свойства 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.

2. Присвойте свойству Items коллекции значение Twitter.MyFollowers().

   Если выбрать коллекцию, в правой области отобразятся ее параметры.

3. Во втором списке выберите UserName, а в третьем — FullName.

   Теперь в коллекции отображаются значения выбранных свойств.

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

1. Рассмотрим некоторых пользователей, на которых подписаны, с помощью коллекции С текстом:

   • Чтобы отобразить пользователей, на которых подписан текущий пользователь, задайте для свойства 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})

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

     Если выбрать коллекцию, в правой области отобразятся ее параметры.

2. В списке 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 так же, как мы делали это ранее в этой статье.

Поиск твитов

1. Используйте коллекцию С текстом и задайте для свойства Items следующую формулу:

   Twitter.SearchTweet( *SearchTerm* ).TweetText

   Введите условие поиска, заключенное в двойные кавычки, или используйте другое эквивалентное значение. Например, непосредственно в формуле введите "PowerApps" или "microsoft".

   Чтобы указать условие поиска, можно использовать элемент управления Ввод текста так же, как мы делали это ранее в этой статье.

   Совет

   Отобразите первые пять результатов с помощью аргумента maxResults:

   Twitter.SearchTweet(SearchTerm.Text, {maxResults:5}).TweetText

2. Присвойте свойству Items коллекции значение Twitter.SearchTweet(SearchTerm.Text, {maxResults:5}).

   Если выбрать коллекцию, в правой области отобразятся ее параметры.

3. В первом списке выберите TweetText, во втором — TweetedBy, а в третьем — CreatedAt.

   Теперь в коллекции отображаются значения выбранных свойств.

Отправка твита

1. Добавьте элемент управления для ввода текста и переименуйте его на MyTweet.
2. Добавьте кнопку и задайте в качестве значения свойства OnSelect следующую формулу:
   Twitter.Tweet("",{tweetText: MyTweet.Text})
   Пример: Twitter.Tweet("",{tweetText:"Sample tweet!"})
3. Нажмите клавишу F5 или кнопку предварительного просмотра (). Введите текст в MyTweet, а затем нажмите кнопку, чтобы опубликовать введенный текст.
4. Нажмите клавишу 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	Нет

Полезные ссылки

Сведения о всех доступных подключениях см. здесь.
Узнайте, как добавлять подключения в приложения.

Примечание

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

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).