X
X, tidigare känt som Twitter, är en onlinetjänst för sociala nätverk som gör det möjligt för användare att skicka och ta emot korta inlägg. Anslut till X för att hantera dina inlägg. Du kan utföra olika åtgärder som att skicka inlägg, söka, visa följare osv.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Tjänster | Class | Regioner |
|---|---|---|
| Copilot Studio | Norm | Alla Power Automate-regioner utom följande: – China Cloud drivs av 21Vianet |
| Logiska appar | Norm | Alla Logic Apps-regioner utom följande: – Regioner i Azure Kina - US Department of Defense (DoD) |
| Power Apps | Norm | Alla Power Apps-regioner utom följande: – China Cloud drivs av 21Vianet |
| Power Automate | Norm | Alla Power Automate-regioner utom följande: – China Cloud drivs av 21Vianet |
| Kontakt | |
|---|---|
| Namn | Microsoft |
| URL |
Microsoft LogicApps Support Microsoft Power Automate-support Microsoft Power Apps Support |
| Metadata för anslutningsprogram | |
|---|---|
| Utgivare | Microsoft |
| Webbplats | https://x.com/ |
| Sekretesspolicy | https://x.com/privacy |
Autentisering och Bring your own-program
Viktigt!
Det delade standardprogrammet (Twitter-klientprogrammet som underhålls av Microsoft) är inte längre tillgängligt. Anslutningsappen har nu endast stöd för en autentiseringstyp – Bring your own application (Ta med ditt eget program). Från och med juni 2023 krävs ett betalt företagsnivåprogram. Twitters prisprincip kan dock fortsätta att ändras.
Med alternativet "Bring your own application" kan du använda ditt eget Twitter OAuth-klientprogram. På så sätt kan du styra behörigheter och aktivera vissa begränsningar för användningen av anslutningsappen.
Om du vill använda ditt eget Twitter OAuth-klientprogram med Twitter-anslutningsappen måste du utföra följande steg:
- Skapa ett OAuth-klientprogram med twitter-utvecklarsidan (https://developer.twitter.com)
- Använda programmet i Twitter-anslutningsappen
Skapa ett OAuth-klientprogram i Twitter
Om du vill skapa ett eget Twitter OAuth-klientprogram måste du först logga in https://developer.twitter.compå . Gå till avsnittet Projekt och appar där du kan hantera och skapa Twitter-program. Den här processen förklaras i Twitters Utvecklarguide för Twitter. När du har skapat en Twitter-app på utvecklarsidan krävs följande steg för korrekt konfiguration:
- Välj din Twitter-app
- Redigera appbehörigheter för att aktivera läsning och skrivning.
- Redigera autentiseringsinställningar
- Aktivera autentisering från tredje part
- Lägg till
https://global.consent.azure-apim.net/redirectför url:er för återanrop (OBS! Om du använder Fairfax-prenumerationen eller GCC-miljön kan du titta på avsnittet "Fairfax- och GCC-motringningar") - Ange "Webbplats-URL" (obligatoriskt fält, men dess värde påverkar inte flödet)
Fairfax- och GCC-återanrop
Om du använder En Fairfax-prenumeration eller en GCC-miljö lägger du till följande URL:er för återanrops-URL:er för din Twitter-app:
- För 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
- För GCC:
https://power-apis-usgov001-public.consent.azure-apihub.us/redirect
När du är klar väljer du din Twitter-app och går till sidan "Nycklar och token". I avsnittet Konsumentnycklar klickar du på knappen Visa nycklar för att hämta API-nyckeln och API-nyckelhemligheten för din app. Du kan nu använda dessa värden i din Twitter-anslutning.
Använda ditt eget program i Twitter-anslutningsappen
När du har skapat Twitter OAuth-klientprogrammet kan du använda det när du skapar en Twitter-anslutning.
- Välj Ta med ditt eget program.
- Ange värden för klient-ID och klienthemlighet från ditt program. (Använd API-nyckeln och API-nyckelhemligheten för din Twitter-app)
Klicka på Logga in för att logga in på ditt Twitter-konto. Detta uppmanar dig att logga in på ditt Twitter-konto och sedan auktorisera åtkomst till Twitter-appen som du skapade ovan.
GRÄNSER
Följande är några av begränsningarna och begränsningarna:
- Maximalt antal anslutningar per användare: 2
- GRÄNS för API-anropsfrekvens för POST-åtgärd: 12 per timme
- Gräns för API-anropsfrekvens för andra åtgärder: 600 per timme
- Frekvens för utlösarundersökningar: 1 timme
- Maximal storlek på bilduppladdning: 5 MB
- Maximal storlek för videouppladdning: 15 MB
- Maximalt antal sökresultat: 100
- Maximalt antal nya tweets som spåras inom ett avsökningsintervall: 5
- Maximal tillåten parametervärdelängd för söktext är 470
Begränsningar för Twitter API
- Sök API-sökningar mot en sampling av de senaste Tweets som publicerats under de senaste 7 dagarna
- Api för standardsökning fokuserar på relevans och inte fullständighet. Det innebär att vissa tweets och användare kanske saknas i sökresultaten
Ytterligare begränsningar för POST-åtgärd
Det går inte att nämna en @user tweet när du publicerar en tweet. Mer specifikt tas "@"-tecknen bort när du publicerar en tweet.
Allmänna gränser
| Namn | Värde |
|---|---|
| Anslutningar per konto | 2 |
Skapa en anslutning
Anslutningsappen stöder följande autentiseringstyper:
| Ta med ditt eget program | Logga in med din egen Twitter-app. Mer information finns i avsnittet "Autentisering och bring your own application" på den här sidan. | Alla regioner | Går inte att dela |
| Standard [INAKTUELL] | Det här alternativet är endast för äldre anslutningar utan en explicit autentiseringstyp och tillhandahålls endast för bakåtkompatibilitet. | Alla regioner | Går inte att dela |
Ta med ditt eget program
Autentiserings-ID: byoa
Tillämpligt: Alla regioner
Logga in med din egen Twitter-app. Mer information finns i avsnittet "Autentisering och bring your own application" på den här sidan.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Namn | Typ | Description | Krävs |
|---|---|---|---|
| Konsumentnyckel | snöre | Konsumentnyckel för ditt Twitter-program | Sann |
| Konsumenthemlighet | securestring | Klienthemlighet för ditt Twitter-program | Sann |
Standard [INAKTUELL]
Tillämpligt: Alla regioner
Det här alternativet är endast för äldre anslutningar utan en explicit autentiseringstyp och tillhandahålls endast för bakåtkompatibilitet.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
Åtgärder
| Hämta användare |
Den här åtgärden hämtar profilinformationen för en viss användare, till exempel användarnamn, beskrivning, antal följare med mera. |
| Hämta användartidslinje |
Den här åtgärden hämtar en lista över de senaste tweetsen som publicerats av en viss användare. |
| Hämta följande |
Åtgärden hämtar listan över personer som den angivna användaren följer. |
| Hämta följande |
Den här åtgärden hämtar listan över användare som jag följer. |
| Hämta följare |
Den här åtgärden hämtar listan över användare som följer en viss användare. |
| Hämta mina följare |
Den här åtgärden hämtar listan över användare som följer mig. |
| Publicera en tweet |
Den här åtgärden publicerar en ny tweet. |
| Retweet |
Den här åtgärden retweetar en tweet. |
| Sök tweets |
Den här åtgärden hämtar en lista över relevanta tweets som matchar sökfrågan. |
| Tidslinje för att hämta hem |
Den här åtgärden får de senaste tweetsen och re-tweets som publicerats av mig och mina följare. |
Hämta användare
Den här åtgärden hämtar profilinformationen för en viss användare, till exempel användarnamn, beskrivning, antal följare med mera.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Användarnamn
|
userName | True | string |
X-handtag för användaren. |
Returer
Representerar en användare.
- Body
- UserDetailsModel
Hämta användartidslinje
Den här åtgärden hämtar en lista över de senaste tweetsen som publicerats av en viss användare.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Användarnamn
|
userName | True | string |
X-handtag för användaren. |
|
Maximalt resultat
|
maxResults | integer |
Maximalt antal tweets som ska returneras. |
Returer
- response
- array of TweetModel
Hämta följande
Åtgärden hämtar listan över personer som den angivna användaren följer.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Användarnamn
|
userName | True | string |
X-handtag för användaren. |
|
Maximalt resultat
|
maxResults | integer |
Maximalt antal användare som ska returneras. |
Returer
- response
- array of UserDetailsModel
Hämta följande
Den här åtgärden hämtar listan över användare som jag följer.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Maximalt resultat
|
maxResults | integer |
Maximalt antal användare som ska returneras. |
Returer
- response
- array of UserDetailsModel
Hämta följare
Den här åtgärden hämtar listan över användare som följer en viss användare.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Användarnamn
|
userName | True | string |
X-handtag för användaren. |
|
Maximalt resultat
|
maxResults | integer |
Maximalt antal användare som ska returneras. |
Returer
- response
- array of UserDetailsModel
Hämta mina följare
Den här åtgärden hämtar listan över användare som följer mig.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Maximalt resultat
|
maxResults | integer |
Maximalt antal användare att hämta. |
Returer
- response
- array of UserDetailsModel
Publicera en tweet
Den här åtgärden publicerar en ny tweet.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Tweettext
|
tweetText | string |
Text som ska publiceras. |
|
|
Media
|
body | binary |
Media som ska publiceras. |
Returer
Representerar svaret från ett tweetinlägg.
- Body
- TweetResponseModel
Retweet
Den här åtgärden retweetar en tweet.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Tweet-ID
|
tweetId | True | string |
Tweet som ska retweetas. |
|
Trimma användare
|
trimUser | boolean |
Booleskt värde för att ange om användarinformation ska trimmas. |
Returer
Representerar svaret från ett tweetinlägg.
- Body
- TweetResponseModel
Sök tweets
Den här åtgärden hämtar en lista över relevanta tweets som matchar sökfrågan.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Söktext
|
searchQuery | True | string |
Sökord som "happy hour", #haiku, från:@username, love OR hate. |
|
Maximalt resultat
|
maxResults | integer |
Maximalt antal tweets som ska returneras. |
|
|
sinceId
|
sinceId | string |
Returnera tweets efter det angivna tweet-ID:t. |
Returer
- response
- array of TweetModel
Tidslinje för att hämta hem
Den här åtgärden får de senaste tweetsen och re-tweets som publicerats av mig och mina följare.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Maximalt resultat
|
maxResults | integer |
Maximalt antal tweets som ska returneras. |
Returer
- response
- array of TweetModel
Utlösare
| När en ny tweet publiceras |
Den här åtgärden utlöser ett flöde när en ny tweet som matchar en viss sökfråga publiceras. |
När en ny tweet publiceras
Den här åtgärden utlöser ett flöde när en ny tweet som matchar en viss sökfråga publiceras.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Söktext
|
searchQuery | True | string |
Sökord som "happy hour", #haiku, från:@username, love OR hate. |
Returer
Representerar ett omslutningsobjekt för batchutlösarsvar
Definitioner
TweetModel
Representerar ett tweetinlägg.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Tweettext
|
TweetText | string |
Textinnehåll i tweeten |
|
Tweet-ID
|
TweetId | string |
ID för tweeten |
|
Skapat vid
|
CreatedAtIso | string |
Tidpunkt då tweeten publicerades |
|
Antal retweets
|
RetweetCount | integer |
Totalt antal re-tweets för tweeten |
|
Tweetat av
|
TweetedBy | string |
Namnet på den användare som har publicerat tweeten |
|
Medie-URL:ar
|
MediaUrls | array of string |
Url för media som publicerats tillsammans med tweeten |
|
Tweetspråk
|
TweetLanguageCode | string |
Språkkod för tweeten |
|
in_reply_to_user_id
|
TweetInReplyToUserId | string |
Användar-ID för författaren till tweeten som den aktuella tweeten är ett svar på |
|
Favorited
|
Favorited | boolean |
Anger om tweeten är markerad som favorit eller inte |
|
Användaromnämnanden
|
UserMentions | array of UserMentionsModel |
Lista över användare som nämns i tweeten |
|
OriginalTweet
|
OriginalTweet | OriginalTweetModel |
Representerar ett ursprungligt tweetinlägg. |
|
Användar Detaljer
|
UserDetails | UserDetailsModel |
Representerar en användare. |
UserMentionsModel
Representerar en användare som nämns i en tweet.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Nämnda användar-ID
|
Id | integer |
X-ID (handtag) för användaren |
|
Användarens fullständiga namn nämns
|
FullName | string |
Användarens fullständiga namn |
|
Nämnda användarnamn
|
UserName | string |
Användarens skärmnamn |
OriginalTweetModel
Representerar ett ursprungligt tweetinlägg.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Ursprunglig tweettext
|
TweetText | string |
Textinnehåll i den ursprungliga hämtade tweeten |
|
Ursprungligt tweet-ID
|
TweetId | string |
ID för den ursprungliga tweeten |
|
Ursprunglig tweet som skapades på
|
CreatedAtIso | string |
Tid då den ursprungliga tweeten publicerades |
|
Ursprungligt antal tweet-retweets
|
RetweetCount | integer |
Totalt antal re-tweets för den här ursprungliga tweeten |
|
Ursprunglig tweet tweet av
|
TweetedBy | string |
Användarnamn för den person som publicerade den ursprungliga tweeten |
|
Url:ar för ursprungligt tweetmedium
|
MediaUrls | array of string |
Url för media som publicerats tillsammans med den ursprungliga tweeten |
|
Ursprungligt tweetspråk
|
TweetLanguageCode | string |
Språkkod för den ursprungliga tweeten |
|
Ursprunglig tweet in_reply_to_user_id
|
TweetInReplyToUserId | string |
Användar-ID för författaren till tweeten att den aktuella ursprungliga tweeten är ett svar på |
|
Ursprunglig tweet favorited
|
Favorited | boolean |
Anger om den ursprungliga tweeten är markerad som favorit |
|
Ursprungliga tweetanvändaren nämner
|
UserMentions | array of OriginalTweetUserMentionsModel |
Listan över användare som nämns i tweeten |
|
Användar Detaljer
|
UserDetails | OriginalTweetUserDetailsModel |
Representerar en användare som publicerade en ursprunglig tweet |
UserDetailsModel
Representerar en användare.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Namn
|
FullName | string |
Användarens namn |
|
Plats
|
Location | string |
Användarens plats |
|
Användar-ID
|
Id | integer |
X-ID (handtag) för användaren |
|
Användarnamn
|
UserName | string |
Användarens skärmnamn |
|
Antal följare
|
FollowersCount | integer |
Antal följare |
|
Description
|
Description | string |
Användarbeskrivning |
|
Antal statusar
|
StatusesCount | integer |
Antal användarstatusar |
|
Antal vänner
|
FriendsCount | integer |
Antal vänner |
|
Antal favoriter
|
FavouritesCount | integer |
Antal tweets som användaren har valt som favorit |
|
Url för profilbild
|
ProfileImageUrl | string |
Url för profilbilden |
OriginalTweetUserMentionsModel
Representerar en användare som nämns i en ursprunglig tweet.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Ursprungligt tweet nämnt användar-ID
|
Id | integer |
X-ID (handtag) för användaren |
|
Ursprunglig tweet nämnde användarens fullständiga namn
|
FullName | string |
Användarens fullständiga namn |
|
Ursprungligt tweet nämnt användarnamn
|
UserName | string |
Användarens skärmnamn |
OriginalTweetUserDetailsModel
Representerar en användare som publicerade en ursprunglig tweet
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Fullständigt namn på den ursprungliga tweetanvändaren
|
FullName | string |
Användarens namn |
|
Ursprunglig tweetanvändarplats
|
Location | string |
Användarens plats |
|
Ursprungligt tweetanvändar-ID
|
Id | integer |
X-ID (handtag) för användaren |
|
Ursprungligt tweetanvändarnamn
|
UserName | string |
Användarens skärmnamn |
|
Ursprungligt antal tweetanvändare
|
FollowersCount | integer |
Antal följare |
|
Beskrivning av ursprunglig tweetanvändare
|
Description | string |
Användarbeskrivning |
|
Antal ursprungliga tweetanvändare
|
StatusesCount | integer |
Antal användarstatusar |
|
Ursprungligt antal tweetanvändare
|
FriendsCount | integer |
Antal vänner |
|
Ursprungligt antal tweetanvändares favoriter
|
FavouritesCount | integer |
Antal tweets som användaren har valt som favorit |
|
Url för användarprofil för ursprunglig tweet
|
ProfileImageUrl | string |
Url för profilbilden |
TweetResponseModel
Representerar svaret från ett tweetinlägg.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Tweet-ID
|
TweetId | string |
ID för tweeten som publicerats |
TriggerBatchResponse[TweetModel]
Representerar ett omslutningsobjekt för batchutlösarsvar
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
värde
|
value | array of TweetModel |
En lista över svarsobjekten |