Twitter

O Twitter permite que você publique tweets e receba tweets, linha do tempo, amigos e seguidores de sua conta do Twitter.

Você pode exibir essas informações em um rótulo do aplicativo. Por exemplo, você pode adicionar uma caixa de texto de entrada, pedir ao usuário para inserir algum Tweet de texto e, em seguida, adicionar um botão que "envia" tweets. É possível usar métodos semelhantes para obter um tweet ou pesquisar por um tweet e, em seguida, exibir o texto em um controle de rótulo ou de galeria em seu aplicativo.

Este tópico mostra como criar a conexão com o Twitter e usar a conexão do Twitter em um aplicativo e lista as funções disponíveis.

 

O que você precisa para começar

Conectar ao Twitter

  1. Abra o PowerApps, selecione Novo e, em seguida, crie um aplicativo em branco. Escolha o layout de telefone ou tablet. O layout de tablet oferece mais espaço de trabalho:

    Abrir um aplicativo em branco

  2. No painel direito, clique ou toque na guia Dados e, em seguida, clique ou toque em Adicionar fonte de dados.

  3. Selecione Nova conexão e, em seguida, selecione Twitter:

    Conectar ao Twitter

    Conectar ao Twitter

  4. Selecione Conectar, insira suas credenciais de entrada do Twitter e, em seguida, selecione Autorizar aplicativo.

  5. Selecione Adicionar fonte de dados. Sua conexão aparece em Fontes de dados:
    Fechar o painel Opções

A conexão do Twitter foi criada e adicionada ao seu aplicativo. Agora, ele está pronto para ser usado.

Usar a conexão do Twitter em seu aplicativo

Mostrar uma linha do tempo

  1. No menu Inserir, selecione Galeria e adicione todas as galerias Com texto.
  2. Vamos mostrar algumas linhas do tempo:

    • Para mostrar a linha do tempo do usuário atual, defina a propriedade Itens da galeria como a fórmula a seguir:

      Twitter.HomeTimeline().TweetText
      Twitter.HomeTimeline({maxResults:3}).TweetText

    • Para mostrar a linha do tempo de outro usuário, defina a propriedade Itens da galeria como a fórmula a seguir:

      Twitter.UserTimeline( *TwitterHandle* ).TweetText

      Insira um manipulador do Twitter em aspas duplas ou um valor equivalente. Por exemplo, digite "satyanadella" ou "powerapps" diretamente na expressão da fórmula.

    • Adicione um controle de entrada de texto chamado Tweep e defina sua propriedade Default como Tweep.Text. Na caixa de texto Tweep, digite um manipulador do Twitter, como satyanadella (sem as aspas e sem o símbolo @).

      No controle da galeria, defina a propriedade Itens como a fórmula a seguir:

      Twitter.UserTimeline(Tweep.Text, {maxResults:5}).TweetText

      O controle da galeria mostrará automaticamente os tweets do manipulador de Twitter que você digitar.

    Dica algumas dessas fórmulas usam o argumento maxResults para mostrar a quantidade x de tweets mais recentes em uma linha do tempo.

  3. Defina a propriedade Itens da galeria como Twitter.HomeTimeline().

    Com a galeria selecionada, o painel direito mostra opções para essa galeria.

  4. Selecione TweetText na primeira lista, selecione TweetedBy na segunda lista e selecione CreatedAt na terceira lista.

    A Galeria agora mostra os valores das propriedades que você escolher.

Exibir seguidores

  1. Usando uma galeria Com texto, vamos mostrar alguns seguidores:

    • Para mostrar os seguidores do usuário atual, defina a propriedade Itens da galeria como a fórmula a seguir:

      Twitter.MyFollowers()
      Twitter.MyFollowers({maxResults:3})

    • Para mostrar os seguidores de outro usuário, defina a propriedade Itens da galeria como a fórmula a seguir:

      Twitter.Followers( *TwitterHandle* )

      Insira um manipulador do Twitter em aspas duplas ou um valor equivalente. Por exemplo, digite "satyanadella" ou "powerapps" diretamente na expressão da fórmula.

    • Adicione um controle de entrada de texto chamado Tweep e defina sua propriedade Default como Tweep.Text. Na caixa de texto Tweep, digite um manipulador do Twitter, como satyanadella (sem as aspas e sem o símbolo @).

      No controle da galeria, defina a propriedade Itens como a fórmula a seguir:

      Twitter.Followers(Tweep.Text, {maxResults:5})

      O controle da galeria mostrará automaticamente quem está seguindo o manipulador de Twitter no qual você digita.

    Dica algumas dessas fórmulas usam o argumento maxResults para mostrar a quantidade x de tweets mais recentes em uma linha do tempo.

  2. Defina a propriedade Itens da galeria como Twitter.MyFollowers().

    Com a galeria selecionada, o painel direito mostra opções para essa galeria.

  3. Selecione UserName na segunda lista e selecione FullName na terceira lista.

    A Galeria agora mostra os valores das propriedades que você escolher.

Exibir usuários seguidos

  1. Usando uma galeria Com texto, vamos mostrar alguns usuários seguidos:

    • Para exibir quais usuários o usuário atual está seguindo, defina a propriedade Itens da galeria como a fórmula a seguir:

      Twitter.MyFollowing()
      Twitter.MyFollowing({maxResults:3})

    • Para exibir quais usuários outro usuário está seguindo, defina a propriedade Itens da galeria como a fórmula a seguir:

      Twitter.Following( *TwitterHandle* )

      Insira um manipulador do Twitter em aspas duplas ou um valor equivalente. Por exemplo, digite "satyanadella" ou "powerapps" diretamente na expressão da fórmula.

    • Adicione um controle de entrada de texto chamado Tweep e defina sua propriedade Default como Tweep.Text. Na caixa de texto Tweep, digite um manipulador do Twitter, como satyanadella (sem as aspas e sem o símbolo @).

      No controle da galeria, defina a propriedade Itens como a fórmula a seguir:

      Twitter.Following(Tweep.Text, {maxResults:5})

      O controle da galeria mostra automaticamente os outros manipuladores que você estiver seguindo.

    Com a galeria selecionada, o painel direito mostra opções para essa galeria.

  2. Selecione Descrição na lista Body1, UserName na lista Heading1 e FullName na lista Subtitle1.

    A Galeria agora mostra os valores das propriedades que você escolher.

Mostrar informações sobre um usuário

Adicione um rótulo e, em seguida, defina sua propriedade Text com uma destas fórmulas:

  • 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

Insira um manipulador do Twitter em aspas duplas ou um valor equivalente. Por exemplo, digite "satyanadella" ou "powerapps" diretamente na expressão da fórmula.

Ou, use um controle de texto de entrada para digitar um manipulador do Twitter, exatamente como temos feito ao longo deste tópico.

Pesquisar tweets

  1. Usando uma galeria Com texto, defina sua propriedade Itens como a fórmula a seguir:

    Twitter.SearchTweet( *SearchTerm* ).TweetText

    Insira um SearchTerm entre aspas duplas ou fazendo referência a um valor equivalente. Por exemplo, insira "PowerApps" ou "microsoft" diretamente na fórmula.

    Ou, use um controle de Entrada de texto para especificar um termo de pesquisa, exatamente como temos feito ao longo deste tópico.

    Dica Exiba os cinco primeiros resultados usando maxResults:

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

  2. Defina a propriedade Itens da galeria como Twitter.SearchTweet(SearchTerm.Text, {maxResults:5}).

    Com a galeria selecionada, o painel direito mostra opções para essa galeria.

  3. Selecione TweetText na primeira lista, TweetedBy na segunda lista e CreatedAt na terceira lista.

    A Galeria agora mostra os valores das propriedades que você escolher.

Enviar um tweet

  1. Adicione um controle de entrada de texto e renomeie-o como MyTweet.

  2. Adicione um botão e depois defina sua propriedade OnSelect como a fórmula a seguir:
    Twitter.Tweet({tweetText: MyTweet.Text})

  3. Pressione F5 ou selecione o botão Visualizar ( ). Digite algum texto em MyTweet e, em seguida, selecione o botão para enviar um tweet do texto que você inseriu.

  4. Pressione Esc para retornar ao espaço de trabalho padrão.

Exibir as funções disponíveis

Essa conexão inclui as seguintes funções:

Nome da Função Descrição
UserTimeline Recupera uma coleção de tweets mais recentes postados pelo usuário especificado
HomeTimeline Recupera os tweets mais recentes e envia novamente os tweets postados por mim e meus seguidores
SearchTweet Recupera uma coleção de tweets relevantes que correspondem a uma consulta especificada
Seguidores Recupera os usuários que seguem o usuário especificado
MyFollowers Recupera os usuários que estão me seguindo
Seguindo Recupera os usuários que o usuário especificado está seguindo
MyFollowing Recupera os usuários que estou seguindo
Usuário Recupera os detalhes sobre o usuário especificado (exemplo: nome de usuário, descrição, contagem de seguidores etc.)
Tweet Tweet
OnNewTweet Aciona um fluxo de trabalho quando um novo tweet que corresponde à sua consulta de pesquisa é postado

UserTimeline

Receber linha de tempo do usuário: recupera uma coleção de tweets mais recentes postados pelo usuário especificado

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
userName cadeia de caracteres sim Manipulador do Twitter
maxResults inteiro não Número máximo de tweets para recuperar, por exemplo, {maxResults:5}

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
TweetText cadeia de caracteres Sim
TweetId cadeia de caracteres Não
CreatedAt cadeia de caracteres Não
RetweetCount inteiro Sim
TweetedBy cadeia de caracteres Sim
MediaUrls matriz Não

HomeTimeline

Receber linha do tempo inicial: recupera os tweets mais recentes e envia novamente os tweets postados por mim e meus seguidores

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
maxResults inteiro não Número máximo de tweets para recuperar, por exemplo, {maxResults:5}

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
TweetText cadeia de caracteres Sim
TweetId cadeia de caracteres Não
CreatedAt cadeia de caracteres Não
RetweetCount inteiro Sim
TweetedBy cadeia de caracteres Sim
MediaUrls matriz Não

SearchTweet

Pesquisar tweet: recupera uma coleção de tweets relevantes que correspondem a uma consulta especificada

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
searchQuery cadeia de caracteres sim Texto da consulta (você pode usar os operadores de consulta com suporte do Twitter: http://www.twitter.com/search)
maxResults inteiro não Número máximo de tweets para recuperar, por exemplo, {maxResults:5}

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
TweetText cadeia de caracteres Sim
TweetId cadeia de caracteres Não
CreatedAt cadeia de caracteres Não
RetweetCount inteiro Sim
TweetedBy cadeia de caracteres Sim
MediaUrls matriz Não

Seguidores

Receber seguidores: recupera os usuários que seguem o usuário especificado

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
userName cadeia de caracteres sim Manipulador do Twitter do usuário
maxResults inteiro não Número máximo de usuários para recuperar, por exemplo, {maxResults:5}

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
Nome Completo cadeia de caracteres Sim
Local cadeia de caracteres Sim
ID inteiro Não
UserName cadeia de caracteres Sim
FollowersCount inteiro Não
Descrição cadeia de caracteres Sim
StatusesCount inteiro Não
FriendsCount inteiro Não

MyFollowers

Receber meus seguidores: recupera os usuários que estão me seguindo

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
maxResults inteiro não Número máximo de usuários para recuperar, por exemplo, {maxResults:5}

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
Nome Completo cadeia de caracteres Sim
Local cadeia de caracteres Sim
ID inteiro Não
UserName cadeia de caracteres Sim
FollowersCount inteiro Não
Descrição cadeia de caracteres Sim
StatusesCount inteiro Não
FriendsCount inteiro Não

Seguindo

Receber seguindo: recupera os usuários que o usuário especificado está seguindo

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
userName cadeia de caracteres sim Manipulador do Twitter do usuário
maxResults inteiro não Número máximo de usuários para recuperar, por exemplo, {maxResults:5}

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
Nome Completo cadeia de caracteres Sim
Local cadeia de caracteres Sim
ID inteiro Não
UserName cadeia de caracteres Sim
FollowersCount inteiro Não
Descrição cadeia de caracteres Sim
StatusesCount inteiro Não
FriendsCount inteiro Não

MyFollowing

Receber que estou seguindo: recupera os usuários que estou seguindo

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
maxResults inteiro não Número máximo de usuários para recuperar, por exemplo, {maxResults:5}

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
Nome Completo cadeia de caracteres Sim
Local cadeia de caracteres Sim
ID inteiro Não
UserName cadeia de caracteres Sim
FollowersCount inteiro Não
Descrição cadeia de caracteres Sim
StatusesCount inteiro Não
FriendsCount inteiro Não

Usuário

Receber usuário: recupera os detalhes sobre o usuário especificado (exemplo: nome de usuário, descrição, contagem de seguidores etc.)

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
userName cadeia de caracteres sim Manipulador do Twitter do usuário

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
Nome Completo cadeia de caracteres Sim
Local cadeia de caracteres Sim
ID inteiro Não
UserName cadeia de caracteres Sim
FollowersCount inteiro Não
Descrição cadeia de caracteres Sim
StatusesCount inteiro Não
FriendsCount inteiro Não

Tweet

Postar um novo tweet: Tweet

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
tweetText cadeia de caracteres não Texto a ser postado, por exemplo, {tweetText: "hello"}
corpo cadeia de caracteres não Mídia a ser postada

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
TweetId cadeia de caracteres Sim

OnNewTweet

Quando um novo tweet aparece: aciona um fluxo de trabalho quando um novo tweet que corresponde à sua consulta de pesquisa é postado

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
searchQuery cadeia de caracteres sim Texto da consulta (você pode usar os operadores de consulta com suporte do Twitter: http://www.twitter.com/search)

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
valor matriz Não

Links Úteis

Veja todas as conexões disponíveis.
Saiba como adicionar conexões a seus aplicativos.