Ligar ao Twitter a partir do Power Apps

Twitter

O Twitter permite-lhe publicar tweets e receber tweets, a linha cronológica, amigos e seguidores a partir da sua conta do Twitter.

Pode apresentar estas informações numa etiqueta na sua aplicação. Por exemplo, pode adicionar uma caixa de texto de entrada, pedir ao utilizador para introduzir algum texto de Tweet e, em seguida, adicionar um botão que "publica" o tweet. Pode utilizar métodos semelhantes para receber um tweet ou procurar um tweet e, em seguida, apresentar o texto numa etiqueta ou controlo da galeria na sua aplicação.

Este tópico mostra como criar a ligação do Twitter, utilizar a ligação do Twitter numa aplicação e apresenta uma lista das funções disponíveis.

Pré-requisitos

Ligar ao Twitter

  1. Abrir o Power Apps, selecionar Novo e, em seguida, criar uma Aplicação em branco. Escolha o esquema de telemóvel ou tablet. O Esquema de Tablet oferece mais espaço de trabalho:

    Abrir uma aplicação em branco

  2. No painel da direita, clique ou toque no separador Dados e, em seguida, clique ou toque em Adicionar origem de dados.

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

    Ligar ao Twitter

    Ligar ao Twitter

  4. Selecione Ligar, introduza as suas credenciais de início de sessão no Twitter e, em seguida, selecione Autorizar aplicação.

  5. Selecione Adicionar Origem de Dados. A ligação é apresentado em Origens de dados:
    Fechar o painel de Opções

A ligação do Twitter foi criada e adicionada à sua aplicação. Agora está pronta a ser utilizada.

Utilizar a ligação do Twitter na sua aplicação

Mostrar uma linha cronológica

  1. No menu Inserir, selecione Galeria e adicione qualquer uma das galerias Com texto.

  2. Vamos mostrar algumas linhas cronológicas:

    • Para mostrar a linha cronológica do utilizador atual, defina a propriedade Itens da galeria como as seguintes fórmulas:

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

    • Para mostrar a linha cronológica de outro utilizador, defina a propriedade Itens da galeria como a seguinte fórmula:

      Twitter.UserTimeline( *TwitterHandle* ).TweetText

      Introduza um identificador do Twitter entre aspas ou um valor equivalente. Por exemplo, introduza "satyanadella" ou "powerapps" diretamente na expressão de fórmula.

    • Adicione um controlo de entrada de texto com o nome Tweep e defina a respetiva propriedade Default como Tweep.Text. Na caixa de texto Tweep, introduza um identificador do Twitter, tal como satyanadella (sem aspas e sem o símbolo @).

      No controlo da galeria, defina a propriedade Itens como a seguinte fórmula:

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

      O controlo da galeria mostra automaticamente os tweets do processador de Twitter que escrever.

      Dica

      Algumas destas fórmulas utilizam o argumento maxResults para mostrar o número x de tweets mais recentes numa linha cronológica.

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

    Com a galeria selecionada, o painel do lado direito apresenta opções para essa galeria.

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

    A galeria mostra agora os valores das propriedades que escolheu.

Mostrar seguidores

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

    • Para mostrar os seguidores do utilizador atual, defina a propriedade Itens da galeria como a seguinte fórmula:

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

    • Para mostrar os seguidores de outro utilizador, defina a propriedade Itens da galeria como a seguinte fórmula:

      Twitter.Followers( *TwitterHandle* )

      Introduza um identificador do Twitter entre aspas ou um valor equivalente. Por exemplo, introduza "satyanadella" ou "powerapps" diretamente na expressão de fórmula.

    • Adicione um controlo de entrada de texto com o nome Tweep e defina a respetiva propriedade Default como Tweep.Text. Na caixa de texto Tweep, introduza um identificador do Twitter, tal como satyanadella (sem aspas e sem o símbolo @).

      No controlo da galeria, defina a propriedade Itens como a seguinte fórmula:

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

      O controlo da galeria mostra automaticamente quem está a seguir o identificador do Twitter que escrever.

      Dica

      Algumas destas fórmulas utilizam o argumento maxResults para mostrar o número x de tweets mais recentes numa linha cronológica.

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

    Com a galeria selecionada, o painel do lado direito apresenta opções para essa galeria.

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

    A galeria mostra agora os valores das propriedades que escolheu.

Mostrar utilizadores seguidos

  1. Com uma galeria Com texto, vamos mostrar alguns utilizadores seguidos:

    • Para mostrar os utilizadores que o utilizador atual está a seguir, defina a propriedade Itens da galeria como a seguinte fórmula:

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

    • Para mostrar os utilizadores que outro utilizador está a seguir, defina a propriedade Itens da galeria como a seguinte fórmula:

      Twitter.Following( *TwitterHandle* )

      Introduza um identificador do Twitter entre aspas ou um valor equivalente. Por exemplo, introduza "satyanadella" ou "powerapps" diretamente na expressão de fórmula.

    • Adicione um controlo de entrada de texto com o nome Tweep e defina a respetiva propriedade Default como Tweep.Text. Na caixa de texto Tweep, introduza um identificador do Twitter, tal como satyanadella (sem aspas e sem o símbolo @).

      No controlo da galeria, defina a propriedade Itens como a seguinte fórmula:

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

      O controlo da galeria mostra automaticamente os outros identificadores que está a seguir.

      Com a galeria selecionada, o painel do lado direito apresenta opções para essa galeria.

  2. Selecione Descrição na lista Body1, Nome do utilizador na lista Heading1 e FullName na lista Subtitle1.

    A galeria mostra agora os valores das propriedades que escolheu.

Mostrar informações sobre um utilizador

Adicione uma etiqueta e, em seguida, defina a respetiva propriedade Text como uma das seguintes 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

Introduza um identificador do Twitter entre aspas ou um valor equivalente. Por exemplo, introduza "satyanadella" ou "powerapps" diretamente na expressão de fórmula.

Em alternativa, pode utilizar um controlo de texto de entrada para escrever um identificador do Twitter, tal como fizemos ao longo deste tópico.

Pesquisar tweets

  1. Com uma galeria Com texto, defina a respetiva propriedade Itens como a seguinte fórmula:

    Twitter.SearchTweet( *SearchTerm* ).TweetText

    Introduza um Termo de Pesquisa entre aspas ou fazendo referência a um valor equivalente. Por exemplo, introduza "PowerApps" ou "microsoft" diretamente na fórmula.

    Em alternativa, pode utilizar um controlo de Texto de entrada para especificar um termo de pesquisa, tal como fizemos ao longo deste tópico.

    Dica

    Para mostrar os primeiros cinco resultados, utilize 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 do lado direito apresenta opções para essa galeria.

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

    A galeria mostra agora os valores das propriedades que escolheu.

Enviar um tweet

  1. Adicione um controlo de entrada de texto e, em seguida, mude o nome do mesmo para MyTweet.
  2. Adicione um botão e defina a respetiva propriedade OnSelect como a seguinte fórmula:
    Twitter.Tweet("",{tweetText: MyTweet.Text})
    Exemplo: Twitter.Tweet("",{tweetText:"Sample tweet!"})
  3. Prima F5 ou selecione o botão de Pré-visualização (botão de Pré-visualização). Escreva algum texto em MyTweet e, em seguida, selecione o botão para enviar o tweet do texto que introduziu.
  4. Prima Esc para voltar à área de trabalho predefinida.

Ver as funções disponíveis

Esta ligação inclui as seguintes funções:

Nome da Função Descrição
UserTimeline Obtém uma coleção dos tweets mais recentes publicados pelo utilizador especificado
HomeTimeline Obtém os tweets e os tweets reenviados mais recentes publicados por mim e pelos meus seguidores
SearchTweet Obtém uma coleção de tweets relevantes que correspondem a uma consulta especificada
Seguidores Obtém os utilizadores que seguem o utilizador especificado
MyFollowers Obtém os utilizadores que me seguem
A Seguir Obtém os utilizadores que o utilizador especificado está a seguir
MyFollowing Obtém os utilizadores que estou a seguir
Utilizador Obtém detalhes sobre o utilizador especificado (exemplo: nome de utilizador, descrição, contagem de seguidores, etc.)
Tweet Tweet
OnNewTweet Aciona um fluxo de trabalho quando é publicado um novo tweet que corresponde à sua consulta de pesquisa

UserTimeline

Obter linha cronológica do utilizador: obtém uma coleção dos tweets mais recentes publicados pelo utilizador especificado

Propriedades de entrada

Nome Tipo de Dados Necessária Descrição
nome de utilizador string sim Identificador do Twitter
maxResults integer não Número máximo de tweets a obter, por exemplo {maxResults:5}

Propriedades de saída

Nome de Propriedade Tipo de Dados Necessária Descrição
TweetText string Sim
TweetId string No
CreatedAt string No
RetweetCount integer Sim
TweetedBy string Sim
MediaUrls matriz No

HomeTimeline

Obter linha cronológica base: obtém os tweets e os tweets reenviados mais recentes publicados por mim e pelos meus seguidores

Propriedades de entrada

Nome Tipo de Dados Necessária Descrição
maxResults integer não Número máximo de tweets a obter, por exemplo {maxResults:5}

Propriedades de saída

Nome de Propriedade Tipo de Dados Necessária Descrição
TweetText string Sim
TweetId string No
CreatedAt string No
RetweetCount integer Sim
TweetedBy string Sim
MediaUrls matriz No

SearchTweet

Procurar tweets: obtém uma coleção de tweets relevantes que correspondem a uma consulta especificada

Propriedades de entrada

Nome Tipo de Dados Necessária Descrição
searchQuery string sim Texto da Consulta (pode utilizar os operadores de consulta do Twitter suportados: https://www.twitter.com/search)
maxResults integer não Número máximo de tweets a obter, por exemplo {maxResults:5}

Propriedades de saída

Nome de Propriedade Tipo de Dados Necessária Descrição
TweetText string Sim
TweetId string No
CreatedAt string No
RetweetCount integer Sim
TweetedBy string Sim
MediaUrls matriz No

Seguidores

Obter seguidores: obtém os utilizadores que seguem o utilizador especificado

Propriedades de entrada

Nome Tipo de Dados Necessária Descrição
nome de utilizador string sim Identificador do Twitter do utilizador
maxResults integer não Número máximo de utilizadores a obter, por exemplo {maxResults:5}

Propriedades de saída

Nome de Propriedade Tipo de Dados Necessária Descrição
FullName string Sim
Localização string Sim
ID integer No
Nome de utilizador string Sim
FollowersCount integer No
Descrição string Sim
StatusesCount integer No
FriendsCount integer No

MyFollowers

Obter os meus seguidores: obtém os utilizadores que me seguem

Propriedades de entrada

Nome Tipo de Dados Necessária Descrição
maxResults integer não Número máximo de utilizadores a obter, por exemplo {maxResults:5}

Propriedades de saída

Nome de Propriedade Tipo de Dados Necessária Descrição
FullName string Sim
Localização string Sim
ID integer No
Nome de utilizador string Sim
FollowersCount integer No
Descrição string Sim
StatusesCount integer No
FriendsCount integer No

A Seguir

Obter utilizadores seguidos: obtém os utilizadores que o utilizador especificado está a seguir

Propriedades de entrada

Nome Tipo de Dados Necessária Descrição
nome de utilizador string sim Identificador do Twitter do utilizador
maxResults integer não Número máximo de utilizadores a obter, por exemplo {maxResults:5}

Propriedades de saída

Nome de Propriedade Tipo de Dados Necessária Descrição
FullName string Sim
Localização string Sim
ID integer No
Nome de utilizador string Sim
FollowersCount integer No
Descrição string Sim
StatusesCount integer No
FriendsCount integer No

MyFollowing

Obter utilizadores seguidos por mim: obtém os utilizadores que estou a seguir

Propriedades de entrada

Nome Tipo de Dados Necessária Descrição
maxResults integer não Número máximo de utilizadores a obter, por exemplo {maxResults:5}

Propriedades de saída

Nome de Propriedade Tipo de Dados Necessária Descrição
FullName string Sim
Localização string Sim
ID integer No
Nome de utilizador string Sim
FollowersCount integer No
Descrição string Sim
StatusesCount integer No
FriendsCount integer No

User

Obter utilizador: obtém detalhes sobre o utilizador especificado (exemplo: nome de utilizador, descrição, contagem de seguidores, etc.)

Propriedades de entrada

Nome Tipo de Dados Necessária Descrição
nome de utilizador string sim Identificador do Twitter do utilizador

Propriedades de saída

Nome de Propriedade Tipo de Dados Necessária Descrição
FullName string Sim
Localização string Sim
ID integer No
Nome de utilizador string Sim
FollowersCount integer No
Descrição string Sim
StatusesCount integer No
FriendsCount integer No

Tweet

Publicar um novo tweet: tweet

Propriedades de entrada

Nome Tipo de Dados Necessária Descrição
tweetText string não Texto a publicar, por exemplo, {tweetText:"hello"}
corpo string não Multimédia a publicar

Propriedades de saída

Nome de Propriedade Tipo de Dados Necessária Descrição
TweetId string Sim

OnNewTweet

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

Propriedades de entrada

Nome Tipo de Dados Necessária Descrição
searchQuery string sim Texto da Consulta (pode utilizar os operadores de consulta do Twitter suportados: https://www.twitter.com/search)

Propriedades de saída

Nome de Propriedade Tipo de Dados Necessária Descrição
valor matriz No

Veja todas as ligações disponíveis.
Saiba como adicionar ligações às suas aplicações.

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).