X
X, dříve označovaná jako Twitter, je online služba sociálních sítí, která umožňuje uživatelům posílat a přijímat krátké příspěvky. Připojte se k X a spravujte příspěvky. Můžete provádět různé akce, jako je odesílání příspěvků, vyhledávání, zobrazení sledujících atd.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Všechny oblasti Power Automate s výjimkou následujících: - China Cloud provozovaný společností 21Vianet |
| Logic Apps | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Standard | Všechny oblasti Power Apps s výjimkou následujících: - China Cloud provozovaný společností 21Vianet |
| Power Automate | Standard | Všechny oblasti Power Automate s výjimkou následujících: - China Cloud provozovaný společností 21Vianet |
| Kontakt | |
|---|---|
| Název | Microsoft |
| URL |
Podpora Microsoft LogicApps Podpora microsoft Power Automate Podpora Microsoft Power Apps |
| Metadata konektoru | |
|---|---|
| Vydavatel | Microsoft |
| Internetová stránka | https://x.com/ |
| Zásady ochrany osobních údajů | https://x.com/privacy |
Ověřování a používání vlastní aplikace
Důležité
Výchozí sdílená aplikace (klient twitterové aplikace udržovaná Microsoftem) už není dostupná. Konektor teď podporuje jenom jeden typ ověřování – Přineste si vlastní aplikaci. Od června 2023 vyžaduje placenou aplikaci na úrovni Enterprise. Zásady cen Twitteru se ale můžou i nadále měnit.
Pomocí možnosti Přineste si vlastní aplikaci můžete použít vlastní klientskou aplikaci Twitter OAuth. To vám umožní řídit oprávnění a povolit určitá omezení používání konektoru.
Pokud chcete používat vlastní klientskou aplikaci Twitter OAuth s konektorem Twitteru, musíte provést následující kroky:
- Vytvoření klientské aplikace OAuth pomocí stránky pro vývojáře Twitteru (https://developer.twitter.com)
- Použití aplikace v konektoru Twitteru
Vytvoření klientské aplikace OAuth na Twitteru
Pokud chcete vytvořit vlastní klientskou aplikaci Twitter OAuth, musíte se nejprve přihlásit k https://developer.twitter.com. Přejděte do části Projekty a aplikace, kde můžete spravovat a vytvářet aplikace twitteru. Tento proces je vysvětlený v Příručce pro vývojáře Twitteru na Twitteru. Po vytvoření aplikace Twitter na stránce pro vývojáře jsou potřeba následující kroky pro správné nastavení:
- Vyberte aplikaci pro Twitter.
- Upravte oprávnění aplikace pro povolení čtení a zápisu.
- Úprava nastavení ověřování
- Povolení ověřování třetí strany
- Přidání
https://global.consent.azure-apim.net/redirectadres URL zpětného volání (POZNÁMKA: Pokud používáte předplatné Fairfax nebo prostředí GCC, projděte si část "Fairfax a GCC callbacks" (Zpětná volání Fairfax a GCC) - Nastavte "Adresa URL webu" (povinné pole, ale hodnota toku nemá vliv)
Fairfax a zpětná volání GCC
Pokud používáte předplatné Fairfax nebo prostředí GCC, přidejte následující adresy URL pro adresy URL zpětného volání vaší aplikace Twitter:
- Pro 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
- Pro GCC:
https://power-apis-usgov001-public.consent.azure-apihub.us/redirect
Až budete hotovi, vyberte aplikaci Twitter a přejděte na stránku Klíče a tokeny. V části Consumer Keys (Uživatelské klíče) klikněte na tlačítko View Keys (Zobrazit klíče) a získejte klíč rozhraní API a tajný klíč rozhraní API vaší aplikace. Tyto hodnoty teď můžete použít ve svém připojení k Twitteru.
Použití vlastní aplikace v konektoru Twitteru
Jakmile vytvoříte klientskou aplikaci Twitter OAuth, můžete ji použít při vytváření připojení k Twitteru.
- Vyberte Možnost Přineste si vlastní aplikaci.
- Zadejte ID klienta a tajné klíče klienta z vaší aplikace. (Použijte klíč rozhraní API a tajný klíč rozhraní API vaší aplikace Twitter.
Klikněte na Přihlásit se a přihlaste se ke svému účtu Na Twitteru. Zobrazí se výzva, abyste se přihlásili ke svému účtu Na Twitteru a pak autorizujete přístup k aplikaci Twitter, kterou jste vytvořili výše.
HRANICE
Tady jsou některá omezení a omezení:
- Maximální počet připojení na uživatele: 2
- Limit četnosti volání rozhraní API pro operaci POST: 12 za hodinu
- Limit četnosti volání rozhraní API pro jiné operace: 600 za hodinu
- Frekvence aktivačních dotazování: 1 hodina
- Maximální velikost nahrávání obrázku: 5 MB
- Maximální velikost nahrávání videa: 15 MB
- Maximální počet výsledků hledání: 100
- Maximální počet nových tweetů sledovaných v jednom intervalu dotazování: 5
- Maximální povolená délka hodnoty parametru Search text je 470.
Omezení rozhraní Twitter API
- Rozhraní API pro vyhledávání hledá vzorkování nedávných tweetů publikovaných za posledních 7 dnů.
- Rozhraní API standardního vyhledávání se zaměřuje na relevanci a ne na úplnost. To znamená, že ve výsledcích hledání můžou chybět některé tweety a uživatelé.
Další omezení pro operaci POST
Zmínka o @user publikování tweetu se nepodporuje. Konkrétně se při publikování tweetu odstraní znaky @.
Obecné limity
| Název | Hodnota |
|---|---|
| Připojení na účet | 2 |
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| Používání vlastní aplikace | Přihlaste se pomocí vlastní aplikace Twitter. Další podrobnosti najdete v části Ověřování a používání vlastní aplikace na této stránce. | Všechny oblasti | Nesdílitelné |
| Výchozí [ZASTARALÉ] | Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu. | Všechny oblasti | Nesdílitelné |
Používání vlastní aplikace
ID ověřování: byoa
Použitelné: Všechny oblasti
Přihlaste se pomocí vlastní aplikace Twitter. Další podrobnosti najdete v části Ověřování a používání vlastní aplikace na této stránce.
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Uživatelský klíč | řetězec | Uživatelský klíč aplikace Twitter | Pravdivé |
| Tajný klíč příjemce | securestring | Tajný klíč klienta aplikace Twitter | Pravdivé |
Výchozí [ZASTARALÉ]
Použitelné: Všechny oblasti
Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu.
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
Akce
| Publikování tweetu |
Tato operace publikuje nový tweet. |
| Retweet |
Tato operace retweetuje tweet. |
| Vyhledávání tweetů |
Tato operace získá seznam relevantních tweetů odpovídajících vyhledávacímu dotazu. |
| Získat domovskou časovou osu |
Tato operace získá nejnovější tweety a znovu tweety publikované mnou a mými sledujícími. |
| Získat moje následující |
Tato operace získá seznam uživatelů, které sledujem. |
| Získat moje sledující |
Tato operace získá seznam uživatelů, kteří mě sledují. |
| Získat následující informace |
Operace získá seznam lidí, které daný uživatel sleduje. |
| Získání sledujících uživatelů |
Tato operace získá seznam uživatelů, kteří sledují daného uživatele. |
| Získání uživatele |
Tato operace získá podrobnosti profilu pro daného uživatele, například uživatelské jméno, popis, počet sledujících uživatelů a další. |
| Získání časové osy uživatele |
Tato operace získá seznam nejnovějších tweetů publikovaných daným uživatelem. |
Publikování tweetu
Tato operace publikuje nový tweet.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Text tweetu
|
tweetText | string |
Text, který se má publikovat. |
|
|
Média
|
body | binary |
Média, která se mají publikovat. |
Návraty
Představuje odpověď příspěvku tweetu.
- Body
- TweetResponseModel
Retweet
Tato operace retweetuje tweet.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID tweetu
|
tweetId | True | string |
Tweet, který se má retweetovat. |
|
Střih uživatele
|
trimUser | boolean |
Logická hodnota označující, jestli se mají oříznout informace o uživateli. |
Návraty
Představuje odpověď příspěvku tweetu.
- Body
- TweetResponseModel
Vyhledávání tweetů
Tato operace získá seznam relevantních tweetů odpovídajících vyhledávacímu dotazu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Hledat text
|
searchQuery | True | string |
Hledaný termín jako "šťastná hodina", #haiku, od:@username, láska NEBO nenávist. |
|
Maximální počet výsledků
|
maxResults | integer |
Maximální počet tweetů, které se mají vrátit. |
|
|
sinceId
|
sinceId | string |
Po zadaném ID tweetu se vrátí tweety. |
Návraty
- response
- array of TweetModel
Získat domovskou časovou osu
Tato operace získá nejnovější tweety a znovu tweety publikované mnou a mými sledujícími.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Maximální počet výsledků
|
maxResults | integer |
Maximální počet tweetů, které se mají vrátit. |
Návraty
- response
- array of TweetModel
Získat moje následující
Tato operace získá seznam uživatelů, které sledujem.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Maximální počet výsledků
|
maxResults | integer |
Maximální počet uživatelů, kteří se mají vrátit. |
Návraty
- response
- array of UserDetailsModel
Získat moje sledující
Tato operace získá seznam uživatelů, kteří mě sledují.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Maximální počet výsledků
|
maxResults | integer |
Maximální počet uživatelů, kteří se mají získat. |
Návraty
- response
- array of UserDetailsModel
Získat následující informace
Operace získá seznam lidí, které daný uživatel sleduje.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Jméno uživatele
|
userName | True | string |
Popisovač X pro uživatele |
|
Maximální počet výsledků
|
maxResults | integer |
Maximální počet uživatelů, kteří se mají vrátit. |
Návraty
- response
- array of UserDetailsModel
Získání sledujících uživatelů
Tato operace získá seznam uživatelů, kteří sledují daného uživatele.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Jméno uživatele
|
userName | True | string |
Popisovač X pro uživatele |
|
Maximální počet výsledků
|
maxResults | integer |
Maximální počet uživatelů, kteří se mají vrátit. |
Návraty
- response
- array of UserDetailsModel
Získání uživatele
Tato operace získá podrobnosti profilu pro daného uživatele, například uživatelské jméno, popis, počet sledujících uživatelů a další.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Jméno uživatele
|
userName | True | string |
Popisovač X pro uživatele |
Návraty
Představuje uživatele.
- Body
- UserDetailsModel
Získání časové osy uživatele
Tato operace získá seznam nejnovějších tweetů publikovaných daným uživatelem.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Jméno uživatele
|
userName | True | string |
Popisovač X pro uživatele |
|
Maximální počet výsledků
|
maxResults | integer |
Maximální počet tweetů, které se mají vrátit. |
Návraty
- response
- array of TweetModel
Aktivační události
| Při publikování nového tweetu |
Tato operace aktivuje tok, když se publikuje nový tweet, který odpovídá danému vyhledávacímu dotazu. |
Při publikování nového tweetu
Tato operace aktivuje tok, když se publikuje nový tweet, který odpovídá danému vyhledávacímu dotazu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Hledat text
|
searchQuery | True | string |
Hledaný termín jako "šťastná hodina", #haiku, od:@username, láska NEBO nenávist. |
Návraty
Představuje objekt obálky pro odpověď triggeru dávky.
Definice
Model tweetu
Představuje příspěvek tweetu.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Text tweetu
|
TweetText | string |
Textový obsah tweetu |
|
ID tweetu
|
TweetId | string |
ID tweetu |
|
Vytvořeno v
|
CreatedAtIso | string |
Čas publikování tweetu |
|
Počet retweetů
|
RetweetCount | integer |
Celkový počet opakovaných tweetů pro tweet |
|
Autor tweetu
|
TweetedBy | string |
Jméno uživatele, který tweet publikoval |
|
Adresy URL médií
|
MediaUrls | array of string |
Adresa URL média zveřejněného spolu s tweetem |
|
Jazyk tweetu
|
TweetLanguageCode | string |
Kód jazyka tweetu |
|
in_reply_to_user_id
|
TweetInReplyToUserId | string |
ID uživatele autora tweetu, na který aktuální tweet odpovídá |
|
Oblíbené
|
Favorited | boolean |
Označuje, jestli je tweet označený jako oblíbený, nebo ne. |
|
Zmínky uživatelů
|
UserMentions | array of UserMentionsModel |
Seznam uživatelů uvedených v tweetu |
|
OriginalTweet
|
OriginalTweet | OriginalTweetModel |
Představuje původní příspěvek tweetu. |
|
Podrobnosti o uživateli
|
UserDetails | UserDetailsModel |
Představuje uživatele. |
UserMentionsModel
Představuje uživatele zmíněného v tweetu.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Uvedené ID uživatele
|
Id | integer |
ID X (popisovač) uživatele |
|
Zmínka o úplném jménu uživatele
|
FullName | string |
Celé jméno uživatele |
|
Zmínka o uživatelském jménu
|
UserName | string |
Název obrazovky uživatele |
OriginalTweetModel
Představuje původní příspěvek tweetu.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Původní text tweetu
|
TweetText | string |
Textový obsah původního načteného tweetu |
|
Původní ID tweetu
|
TweetId | string |
ID původního tweetu |
|
Původní tweet vytvořený na adrese
|
CreatedAtIso | string |
Čas publikování původního tweetu |
|
Původní počet retweetů tweetu
|
RetweetCount | integer |
Celkový počet opakovaných tweetů pro tento původní tweet |
|
Původní tweet tweetovaný uživatelem
|
TweetedBy | string |
Uživatelské jméno osoby, která publikovala původní tweet |
|
Původní adresy URL médií tweetu
|
MediaUrls | array of string |
Adresa URL média publikovaného spolu s původním tweetem |
|
Původní jazyk tweetu
|
TweetLanguageCode | string |
Kód jazyka pro původní tweet |
|
Původní in_reply_to_user_id tweetu
|
TweetInReplyToUserId | string |
ID uživatele autora tweetu, na který aktuální původní tweet odpovídá |
|
Původní oblíbený tweet
|
Favorited | boolean |
Označuje, jestli je původní tweet označený jako oblíbený. |
|
Původní zmínky uživatelů tweetu
|
UserMentions | array of OriginalTweetUserMentionsModel |
Seznam uživatelů uvedených v tweetu |
|
Podrobnosti o uživateli
|
UserDetails | OriginalTweetUserDetailsModel |
Představuje uživatele, který publikoval původní tweet. |
UserDetailsModel
Představuje uživatele.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Název
|
FullName | string |
Jméno uživatele |
|
Umístění
|
Location | string |
Umístění uživatele |
|
ID uživatele
|
Id | integer |
ID X (popisovač) uživatele |
|
Jméno uživatele
|
UserName | string |
Název obrazovky uživatele |
|
Počet sledujících uživatelů
|
FollowersCount | integer |
Počet sledujících uživatelů |
|
Description
|
Description | string |
Popis uživatele |
|
Počet stavů
|
StatusesCount | integer |
Počet stavu uživatele |
|
Počet přátel
|
FriendsCount | integer |
Počet přátel |
|
Počet oblíbených položek
|
FavouritesCount | integer |
Počet tweetů, které uživatel označil jako oblíbený |
|
Adresa URL obrázku profilu
|
ProfileImageUrl | string |
Adresa URL obrázku profilu |
OriginalTweetUserMentionsModel
Představuje uživatele uvedeného v původním tweetu.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Původní tweet se zmínil o ID uživatele
|
Id | integer |
ID X (popisovač) uživatele |
|
Původní tweet se zmínil o úplném jménu uživatele
|
FullName | string |
Celé jméno uživatele |
|
Původní tweet se zmínil o uživatelském jménu
|
UserName | string |
Název obrazovky uživatele |
OriginalTweetUserDetailsModel
Představuje uživatele, který publikoval původní tweet.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Jméno uživatele původního tweetu
|
FullName | string |
Jméno uživatele |
|
Původní umístění uživatele tweetu
|
Location | string |
Umístění uživatele |
|
Původní ID uživatele tweetu
|
Id | integer |
ID X (popisovač) uživatele |
|
Původní uživatelské jméno tweetu
|
UserName | string |
Název obrazovky uživatele |
|
Původní počet sledujících uživatelů tweetu
|
FollowersCount | integer |
Počet sledujících uživatelů |
|
Původní popis uživatele tweetu
|
Description | string |
Popis uživatele |
|
Počet stavů původního uživatele tweetu
|
StatusesCount | integer |
Počet stavu uživatele |
|
Počet původních uživatelů tweetu
|
FriendsCount | integer |
Počet přátel |
|
Počet oblíbených uživatelů původního tweetu
|
FavouritesCount | integer |
Počet tweetů, které uživatel označil jako oblíbený |
|
Adresa URL původního obrázku profilu uživatele tweetu
|
ProfileImageUrl | string |
Adresa URL obrázku profilu |
TweetResponseModel
Představuje odpověď příspěvku tweetu.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID tweetu
|
TweetId | string |
ID publikovaného tweetu |
TriggerBatchResponse[TweetModel]
Představuje objekt obálky pro odpověď triggeru dávky.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
value
|
value | array of TweetModel |
Seznam objektů odpovědi |