Udostępnij przez


X

X, wcześniej znany jako Twitter, jest usługą sieci społecznościowych online, która umożliwia użytkownikom wysyłanie i odbieranie krótkich postów. Połącz się z platformą X, aby zarządzać swoimi wpisami. Możesz wykonywać różne akcje, takie jak wysyłanie wpisów, wyszukiwanie, wyświetlanie obserwujących itp.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Standard Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - China Cloud obsługiwane przez firmę 21Vianet
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Standard Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - China Cloud obsługiwane przez firmę 21Vianet
Power Automate Standard Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - China Cloud obsługiwane przez firmę 21Vianet
Kontakt
Name Microsoft
adres URL Obsługa usługi Microsoft LogicApps
Pomoc techniczna usługi Microsoft Power Automate
Obsługa usługi Microsoft Power Apps
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://x.com/
Zasady ochrony prywatności https://x.com/privacy

Uwierzytelnianie i korzystanie z własnej aplikacji

Ważne

Domyślna aplikacja udostępniona (aplikacja kliencka Twitter utrzymywana przez firmę Microsoft) nie jest już dostępna. Łącznik obsługuje teraz tylko jeden typ uwierzytelniania — Przynieś własną aplikację. Od czerwca 2023 r. wymaga płatnej aplikacji w warstwie Enterprise. Jednak zasady cenowe Twittera mogą nadal ulec zmianie.

Za pomocą opcji "Przynieś własną aplikację" możesz użyć własnej aplikacji klienckiej OAuth w usłudze Twitter. Dzięki temu można kontrolować uprawnienia i włączać pewne ograniczenia dotyczące korzystania z łącznika.

Aby korzystać z własnej aplikacji klienckiej usługi Twitter OAuth z łącznikiem usługi Twitter, należy wykonać następujące czynności:

  1. Tworzenie aplikacji klienckiej OAuth przy użyciu strony dewelopera usługi Twitter (https://developer.twitter.com)
  2. Używanie aplikacji w łączniku usługi Twitter

Tworzenie aplikacji klienckiej OAuth w usłudze Twitter

Aby utworzyć własną aplikację klienczą usługi Twitter OAuth, musisz najpierw zalogować się do https://developer.twitter.comusługi . Przejdź do sekcji "Projekty i aplikacje", w której można zarządzać aplikacjami twitter i tworzyć je. Ten proces został wyjaśniony w Serwisie Twitter Developer Guide. Po utworzeniu aplikacji twitter na stronie dewelopera wymagane są odpowiednie kroki:

  • Wybierz aplikację twitter
  • Edytuj uprawnienia aplikacji, aby włączyć odczyt i zapis.
  • Edytowanie ustawień uwierzytelniania
    • Włączanie uwierzytelniania innej firmy
    • Dodaj https://global.consent.azure-apim.net/redirect adresy URL wywołania zwrotnego (UWAGA: Jeśli używasz subskrypcji Fairfax lub środowiska GCC, zapoznaj się z sekcją "Fairfax i GCC callbacks")
    • Ustaw wartość "Adres URL witryny internetowej" (pole wymagane, ale wartość nie ma wpływu na przepływ)

Wywołania zwrotne Fairfax i GCC

Jeśli używasz subskrypcji Fairfax lub środowiska GCC, dodaj następujące adresy URL dla adresów URL wywołania zwrotnego aplikacji Twitter:

  • Dla Fairfax:
    • https://logic-apis-usgovvirginia.consent.azure-apihub.us/redirect
    • https://logic-apis-usgovtexas.consent.azure-apihub.us/redirect
    • https://logic-apis-usgovarizona.consent.azure-apihub.us/redirect
  • Dla GCC:
    • https://power-apis-usgov001-public.consent.azure-apihub.us/redirect

Po zakończeniu wybierz aplikację twitter i przejdź do strony "Klucze i tokeny". W sekcji "Klucze konsumentów" kliknij przycisk "Wyświetl klucze", aby uzyskać klucz interfejsu API i klucz interfejsu API wpisów tajny aplikacji. Teraz możesz użyć tych wartości w połączeniu z usługą Twitter.

Korzystanie z własnej aplikacji w łączniku usługi Twitter

Po utworzeniu aplikacji klienckiej usługi Twitter OAuth można jej użyć podczas tworzenia połączenia z usługą Twitter.

  • Wybierz pozycję Przynieś własną aplikację.
  • Określ wartości Identyfikator klienta i Klucz tajny klienta z aplikacji. (Użyj klucza interfejsu API i klucza interfejsu API wpisu tajnego aplikacji Twitter)

Kliknij pozycję Zaloguj się, aby zalogować się do swojego konta w usłudze Twitter. Spowoduje to wyświetlenie monitu o zalogowanie się do konta usługi Twitter, a następnie autoryzowanie dostępu do utworzonej powyżej aplikacji Twitter.

LIMITY

Poniżej przedstawiono niektóre limity i ograniczenia:

  1. Maksymalna liczba połączeń na użytkownika: 2
  2. Limit szybkości wywołań interfejsu API dla operacji POST: 12 na godzinę
  3. Limit liczby wywołań interfejsu API dla innych operacji: 600 na godzinę
  4. Częstotliwość sond wyzwalacza: 1 godzina
  5. Maksymalny rozmiar przekazywania obrazu: 5 MB
  6. Maksymalny rozmiar przekazywania wideo: 15 MB
  7. Maksymalna liczba wyników wyszukiwania: 100
  8. Maksymalna liczba nowych tweetów śledzonych w jednym interwale sondowania: 5
  9. Maksymalna dozwolona długość parametru "Tekst wyszukiwania" wynosi 470

Ograniczenia interfejsu API usługi Twitter

  1. Wyszukiwanie interfejsu API wyszukuje próbkowanie ostatnich tweetów opublikowanych w ciągu ostatnich 7 dni
  2. Interfejs API wyszukiwania w warstwie Standardowa koncentruje się na istotności, a nie na kompletności. Oznacza to, że w wynikach wyszukiwania brakuje niektórych tweetów i użytkowników

Dodatkowe ograniczenia dla operacji POST

Wzmianka o @user czasie publikowania tweetu nie jest obsługiwana. W szczególności znaki "@" zostaną usunięte podczas publikowania tweetu.

Ogólne limity

Name Wartość
Połączenia na konto 2

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Korzystanie z własnej aplikacji Zaloguj się przy użyciu własnej aplikacji Twitter. Aby uzyskać więcej informacji, zobacz sekcję "Uwierzytelnianie i korzystanie z własnej aplikacji" na tej stronie. Wszystkie regiony Nie można udostępniać
Domyślne [PRZESTARZAŁE] Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami. Wszystkie regiony Nie można udostępniać

Korzystanie z własnej aplikacji

Identyfikator uwierzytelniania: byoa

Dotyczy: Wszystkie regiony

Zaloguj się przy użyciu własnej aplikacji Twitter. Aby uzyskać więcej informacji, zobacz sekcję "Uwierzytelnianie i korzystanie z własnej aplikacji" na tej stronie.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Klucz klienta ciąg Klucz użytkownika aplikacji usługi Twitter Prawda
Wpis tajny użytkownika securestring Wpis tajny klienta aplikacji twitter Prawda

Domyślne [PRZESTARZAŁE]

Dotyczy: Wszystkie regiony

Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Akcje

Pobieranie moich obserwatorów

Ta operacja pobiera listę użytkowników, którzy mnie obserwujeją.

Pobieranie obserwatorów

Ta operacja pobiera listę użytkowników, którzy obserwują danego użytkownika.

Pobieranie osi czasu strony głównej

Ta operacja pobiera najnowsze tweety i ponownie tweety opublikowane przeze mnie i moich obserwatorów.

Pobieranie osi czasu użytkownika

Ta operacja pobiera listę najnowszych tweetów opublikowanych przez danego użytkownika.

Pobieranie użytkownika

Ta operacja pobiera szczegóły profilu dla danego użytkownika, takie jak nazwa użytkownika, opis, liczba obserwujących i inne.

Pobierz moje następujące elementy

Ta operacja pobiera listę użytkowników, których obserwuję.

Publikowanie tweetu

Ta operacja publikuje nowy tweet.

Retweet

Ta operacja retweetuje tweet.

Wykonaj następujące czynności

Operacja pobiera listę osób, które następują po danym użytkowniku.

Wyszukaj tweety

Ta operacja pobiera listę odpowiednich tweetów pasujących do zapytania wyszukiwania.

Pobieranie moich obserwatorów

Ta operacja pobiera listę użytkowników, którzy mnie obserwujeją.

Parametry

Nazwa Klucz Wymagane Typ Opis
Maksymalna liczba wyników
maxResults integer

Maksymalna liczba użytkowników do pobrania.

Zwraca

Pobieranie obserwatorów

Ta operacja pobiera listę użytkowników, którzy obserwują danego użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa użytkownika
userName True string

X dojście dla użytkownika.

Maksymalna liczba wyników
maxResults integer

Maksymalna liczba użytkowników do zwrócenia.

Zwraca

Pobieranie osi czasu strony głównej

Ta operacja pobiera najnowsze tweety i ponownie tweety opublikowane przeze mnie i moich obserwatorów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Maksymalna liczba wyników
maxResults integer

Maksymalna liczba tweetów do zwrócenia.

Zwraca

Pobieranie osi czasu użytkownika

Ta operacja pobiera listę najnowszych tweetów opublikowanych przez danego użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa użytkownika
userName True string

X dojście dla użytkownika.

Maksymalna liczba wyników
maxResults integer

Maksymalna liczba tweetów do zwrócenia.

Zwraca

Pobieranie użytkownika

Ta operacja pobiera szczegóły profilu dla danego użytkownika, takie jak nazwa użytkownika, opis, liczba obserwujących i inne.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa użytkownika
userName True string

X dojście dla użytkownika.

Zwraca

Reprezentuje użytkownika.

Pobierz moje następujące elementy

Ta operacja pobiera listę użytkowników, których obserwuję.

Parametry

Nazwa Klucz Wymagane Typ Opis
Maksymalna liczba wyników
maxResults integer

Maksymalna liczba użytkowników do zwrócenia.

Zwraca

Publikowanie tweetu

Ta operacja publikuje nowy tweet.

Parametry

Nazwa Klucz Wymagane Typ Opis
Tekst tweetu
tweetText string

Tekst do opublikowania.

Środki masowego przekazu
body binary

Media do opublikowania.

Zwraca

Reprezentuje odpowiedź wpisu tweetu.

Retweet

Ta operacja retweetuje tweet.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator tweetu
tweetId True string

Tweet do retweeted.

Przycinanie użytkownika
trimUser boolean

Wartość logiczna określająca, czy przycinać informacje o użytkowniku.

Zwraca

Reprezentuje odpowiedź wpisu tweetu.

Wykonaj następujące czynności

Operacja pobiera listę osób, które następują po danym użytkowniku.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa użytkownika
userName True string

X dojście dla użytkownika.

Maksymalna liczba wyników
maxResults integer

Maksymalna liczba użytkowników do zwrócenia.

Zwraca

Wyszukaj tweety

Ta operacja pobiera listę odpowiednich tweetów pasujących do zapytania wyszukiwania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Tekst wyszukiwania
searchQuery True string

Wyszukiwany termin, taki jak "happy hour", #haiku, from:@username, love OR hate.

Maksymalna liczba wyników
maxResults integer

Maksymalna liczba tweetów do zwrócenia.

sinceId
sinceId string

Zwracanie tweetów po określonym identyfikatorze tweetu.

Zwraca

Wyzwalacze

Po opublikowaniu nowego tweetu

Ta operacja wyzwala przepływ po opublikowaniu nowego tweetu zgodnego z danym zapytaniem wyszukiwania.

Po opublikowaniu nowego tweetu

Ta operacja wyzwala przepływ po opublikowaniu nowego tweetu zgodnego z danym zapytaniem wyszukiwania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Tekst wyszukiwania
searchQuery True string

Wyszukiwany termin, taki jak "happy hour", #haiku, from:@username, love OR hate.

Zwraca

Reprezentuje obiekt otoki dla odpowiedzi wyzwalacza wsadowego

Definicje

TweetModel

Reprezentuje wpis w tweecie.

Nazwa Ścieżka Typ Opis
Tekst tweetu
TweetText string

Zawartość tekstowa tweetu

Identyfikator tweetu
TweetId string

Identyfikator tweetu

Utworzono w
CreatedAtIso string

Godzina opublikowania tweetu

Liczba ponownych prób
RetweetCount integer

Łączna liczba ponownych tweetów dla tweetu

Tweeted przez
TweetedBy string

Nazwa użytkownika, który opublikował tweet

Adresy URL multimediów
MediaUrls array of string

Adres URL mediów opublikowanych wraz z tweetem

Język tweetów
TweetLanguageCode string

Kod języka tweetu

in_reply_to_user_id
TweetInReplyToUserId string

Identyfikator użytkownika autora tweetu, do którego odpowiada bieżący tweet

Ulubione
Favorited boolean

Wskazuje, czy tweet jest oznaczony jako ulubiony, czy nie

Wzmianki o użytkownikach
UserMentions array of UserMentionsModel

Lista użytkowników wymienionych w tweecie

OriginalTweet
OriginalTweet OriginalTweetModel

Reprezentuje oryginalny wpis w tweecie.

Szczegóły użytkownika
UserDetails UserDetailsModel

Reprezentuje użytkownika.

UserMentionsModel

Reprezentuje użytkownika wymienionego w tweecie.

Nazwa Ścieżka Typ Opis
Wymieniony identyfikator użytkownika
Id integer

Identyfikator X (uchwyt) użytkownika

Imię i nazwisko wymienionego użytkownika
FullName string

Pełna nazwa użytkownika

Wymieniona nazwa użytkownika
UserName string

Nazwa ekranu użytkownika

OriginalTweetModel

Reprezentuje oryginalny wpis w tweecie.

Nazwa Ścieżka Typ Opis
Oryginalny tekst tweetu
TweetText string

Zawartość tekstowa oryginalnego pobranego tweetu

Oryginalny identyfikator tweetu
TweetId string

Identyfikator oryginalnego tweetu

Oryginalny tweet utworzony na stronie
CreatedAtIso string

Godzina opublikowania oryginalnego tweetu

Oryginalna liczba ponownych prób tweetów
RetweetCount integer

Łączna liczba ponownych tweetów dla tego oryginalnego tweetu

Oryginalny tweet tweeted przez
TweetedBy string

Nazwa użytkownika osoby, która opublikowała oryginalny tweet

Oryginalne adresy URL multimediów tweetów
MediaUrls array of string

Adres URL mediów opublikowany wraz z oryginalnym tweetem

Oryginalny język tweetów
TweetLanguageCode string

Kod języka oryginalnego tweetu

Oryginalny tweet in_reply_to_user_id
TweetInReplyToUserId string

Identyfikator użytkownika autora tweetu, do którego odpowiada bieżący oryginalny tweet

Oryginalny tweet ulubiony
Favorited boolean

Wskazuje, czy oryginalny tweet jest oznaczony jako ulubiony

Oryginalne wzmianki o użytkownikach tweetów
UserMentions array of OriginalTweetUserMentionsModel

Lista użytkowników wymienionych w tweecie

Szczegóły użytkownika
UserDetails OriginalTweetUserDetailsModel

Reprezentuje użytkownika, który opublikował oryginalny tweet

UserDetailsModel

Reprezentuje użytkownika.

Nazwa Ścieżka Typ Opis
Name
FullName string

Nazwa użytkownika

Lokalizacja
Location string

Lokalizacja użytkownika

Identyfikator użytkownika
Id integer

Identyfikator X (uchwyt) użytkownika

Nazwa użytkownika
UserName string

Nazwa ekranu użytkownika

Liczba obserwujących
FollowersCount integer

Liczba obserwujących

Description
Description string

Opis użytkownika

Liczba stanów
StatusesCount integer

Liczba stanów użytkownika

Liczba znajomych
FriendsCount integer

Liczba znajomych

Liczba ulubionych
FavouritesCount integer

Liczba tweetów ulubionych przez użytkownika

Adres URL obrazu profilu
ProfileImageUrl string

Adres URL obrazu profilu

OriginalTweetUserMentionsModel

Reprezentuje użytkownika wymienionego w oryginalnym tweecie.

Nazwa Ścieżka Typ Opis
Oryginalny tweet wymieniony identyfikator użytkownika
Id integer

Identyfikator X (uchwyt) użytkownika

Oryginalna pełną nazwę użytkownika wymienionego tweetu
FullName string

Pełna nazwa użytkownika

Oryginalna nazwa użytkownika wymienionego tweetu
UserName string

Nazwa ekranu użytkownika

OriginalTweetUserDetailsModel

Reprezentuje użytkownika, który opublikował oryginalny tweet

Nazwa Ścieżka Typ Opis
Oryginalna nazwa użytkownika tweetu
FullName string

Nazwa użytkownika

Oryginalna lokalizacja użytkownika tweetu
Location string

Lokalizacja użytkownika

Oryginalny identyfikator użytkownika tweetu
Id integer

Identyfikator X (uchwyt) użytkownika

Oryginalna nazwa użytkownika tweetu
UserName string

Nazwa ekranu użytkownika

Oryginalna liczba obserwujących użytkowników tweetu
FollowersCount integer

Liczba obserwujących

Oryginalny opis użytkownika tweetu
Description string

Opis użytkownika

Liczba stanów użytkownika oryginalnego tweetu
StatusesCount integer

Liczba stanów użytkownika

Oryginalna liczba znajomych użytkowników tweetu
FriendsCount integer

Liczba znajomych

Liczba ulubionych użytkownika oryginalnego tweetu
FavouritesCount integer

Liczba tweetów ulubionych przez użytkownika

Oryginalny adres URL obrazu profilu użytkownika tweetu
ProfileImageUrl string

Adres URL obrazu profilu

TweetResponseModel

Reprezentuje odpowiedź wpisu tweetu.

Nazwa Ścieżka Typ Opis
Identyfikator tweetu
TweetId string

Identyfikator opublikowanego tweetu

TriggerBatchResponse[TweetModel]

Reprezentuje obiekt otoki dla odpowiedzi wyzwalacza wsadowego

Nazwa Ścieżka Typ Opis
value
value array of TweetModel

Lista obiektów odpowiedzi