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

Twitter.

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

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

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

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

Подключение к 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 Нет

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

Примечание

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

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