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:
- Tworzenie aplikacji klienckiej OAuth przy użyciu strony dewelopera usługi Twitter (https://developer.twitter.com)
- 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/redirectadresy 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/redirecthttps://logic-apis-usgovtexas.consent.azure-apihub.us/redirecthttps://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:
- Maksymalna liczba połączeń na użytkownika: 2
- Limit szybkości wywołań interfejsu API dla operacji POST: 12 na godzinę
- Limit liczby wywołań interfejsu API dla innych operacji: 600 na godzinę
- Częstotliwość sond wyzwalacza: 1 godzina
- Maksymalny rozmiar przekazywania obrazu: 5 MB
- Maksymalny rozmiar przekazywania wideo: 15 MB
- Maksymalna liczba wyników wyszukiwania: 100
- Maksymalna liczba nowych tweetów śledzonych w jednym interwale sondowania: 5
- Maksymalna dozwolona długość parametru "Tekst wyszukiwania" wynosi 470
Ograniczenia interfejsu API usługi Twitter
- Wyszukiwanie interfejsu API wyszukuje próbkowanie ostatnich tweetów opublikowanych w ciągu ostatnich 7 dni
- 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
- response
- array of UserDetailsModel
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
- response
- array of UserDetailsModel
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
- response
- array of TweetModel
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
- response
- array of TweetModel
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.
- Body
- UserDetailsModel
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
- response
- array of UserDetailsModel
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.
- Body
- TweetResponseModel
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.
- Body
- TweetResponseModel
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
- response
- array of UserDetailsModel
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
- response
- array of TweetModel
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 |