X
Az X, korábbi nevén Twitter egy online közösségi hálózatkezelési szolgáltatás, amellyel a felhasználók rövid bejegyzéseket küldhetnek és fogadhatnak. A bejegyzések kezeléséhez csatlakozzon az X-hez. Különféle műveleteket hajthat végre, például bejegyzéseket küldhet, kereshet, követőket tekinthet meg stb.
Ez az összekötő a következő termékekben és régiókban érhető el:
| Service | Class | Régiók |
|---|---|---|
| Copilot Studio | Standard | Az összes Power Automate-régió, kivéve a következőket: - A 21Vianet által üzemeltetett China Cloud |
| Logikai alkalmazások | Standard | Az összes Logic Apps-régió , kivéve a következőket: - Azure China-régiók - Amerikai Védelmi Minisztérium (DoD) |
| Power Alkalmazások | Standard | Az összes Power Apps-régió , kivéve a következőket: - A 21Vianet által üzemeltetett China Cloud |
| Power Automate | Standard | Az összes Power Automate-régió, kivéve a következőket: - A 21Vianet által üzemeltetett China Cloud |
| Érintkezés | |
|---|---|
| Név | Microsoft |
| URL |
Microsoft LogicApps-támogatás Microsoft Power Automate-támogatás Microsoft Power Apps-támogatás |
| Összekötő metaadatai | |
|---|---|
| Kiadó | Microsoft |
| Webhely | https://x.com/ |
| Adatvédelmi irányelvek | https://x.com/privacy |
Hitelesítés és saját alkalmazás létrehozása
Fontos
Az alapértelmezett megosztott alkalmazás (a Microsoft által fenntartott Twitter-ügyfélalkalmazás) már nem érhető el. Az összekötő mostantól csak egy hitelesítési típust támogat – Saját alkalmazás használata. 2023 júniusától fizetős nagyvállalati szintű alkalmazásra van szükség. A Twitter díjszabási szabályzata azonban továbbra is változhat.
A "Saját alkalmazás használata" lehetőséggel használhatja saját Twitter OAuth-ügyfélalkalmazását. Ez lehetővé teszi az engedélyek szabályozását és az összekötő használatára vonatkozó bizonyos korlátozások engedélyezését.
Ha saját Twitter OAuth-ügyfélalkalmazást szeretne használni a Twitter-összekötővel, a következő lépéseket kell végrehajtania:
- OAuth-ügyfélalkalmazás létrehozása a Twitter fejlesztői oldalával (https://developer.twitter.com)
- Az alkalmazás használata a Twitter-összekötőben
OAuth-ügyfélalkalmazás létrehozása a Twitteren
Saját Twitter OAuth-ügyfélalkalmazás létrehozásához először be kell jelentkeznie.https://developer.twitter.com Lépjen a "Projektek és alkalmazások" szakaszra, ahol kezelheti és létrehozhat twitter-alkalmazásokat. Ezt a folyamatot a Twitter fejlesztői útmutatója ismerteti. Miután létrehozta a Twitter-alkalmazást a fejlesztői oldalon , a megfelelő beállításhoz a következő lépések szükségesek:
- A Twitter-alkalmazás kiválasztása
- Az olvasás és írás engedélyezéséhez szerkessze az alkalmazásengedélyeket.
- Hitelesítési beállítások szerkesztése
- Külső hitelesítés engedélyezése
- Hozzáadás
https://global.consent.azure-apim.net/redirecta visszahívási URL-címekhez (MEGJEGYZÉS: Ha Fairfax-előfizetést vagy GCC-környezetet használ, tekintse meg a "Fairfax és GCC visszahívások" szakaszt) - Állítsa be a "Webhely URL-címét" (kötelező mező, de ez az érték nem befolyásolja a folyamatot)
Fairfax- és GCC-visszahívások
Ha Fairfax-előfizetést vagy GCC-környezetet használ, adja hozzá a következő URL-címeket a Twitter-alkalmazás visszahívási URL-címéhez:
- Fairfax esetén:
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
- GCC esetén:
https://power-apis-usgov001-public.consent.azure-apihub.us/redirect
Ha végzett, válassza ki twitter-alkalmazását, és lépjen a "Kulcsok és jogkivonatok" oldalra. A "Fogyasztói kulcsok" szakaszban kattintson a "Kulcsok megtekintése" gombra az alkalmazás API-kulcsának és API-kulcsának titkos kulcsának lekéréséhez. Ezeket az értékeket most már használhatja a Twitter-kapcsolatában.
Saját alkalmazás használata a Twitter-összekötőben
Miután létrehozta a Twitter OAuth ügyfélalkalmazást, használhatja a Twitter-kapcsolat létrehozásakor.
- Válassza a Saját alkalmazás létrehozása lehetőséget.
- Adja meg az alkalmazás ügyfélazonosítóját és titkos ügyfélkulcs-értékeit. (Használja a Twitter-alkalmazás API-kulcsát és API-kulcsát )
Kattintson a Bejelentkezés gombra a Twitter-fiókjába való bejelentkezéshez. Ez arra kéri, hogy jelentkezzen be Twitter-fiókjába, majd engedélyezze a hozzáférést a fent létrehozott Twitter-alkalmazáshoz.
HATÁROK
A korlátok és korlátozások a következők:
- A kapcsolatok maximális száma felhasználónként: 2
- API-hívás sebességkorlátja POST-művelethez: 12 óránként
- API-hívási sebességkorlát más műveletekhez: 600 óránként
- Az eseményindító lekérdezések gyakorisága: 1 óra
- Képfeltöltés maximális mérete: 5 MB
- Videófeltöltés maximális mérete: 15 MB
- Keresési eredmények maximális száma: 100
- Egy lekérdezési intervallumon belül nyomon követett új tweetek maximális száma: 5
- A "Keresési szöveg" paraméter maximális értéke 470
A Twitter API korlátozásai
- Keresési API-keresések az elmúlt 7 napban közzétett legutóbbi tweetek mintavételezése alapján
- A standard keresési API a relevanciára és nem a teljességre összpontosít. Ez azt jelenti, hogy egyes tweetek és felhasználók hiányoznak a keresési eredményekből
A POST művelet további korlátozásai
A tweet közzététele közbeni említés @user nem támogatott. Pontosabban a "@" karakterek le lesznek vetve a tweet közzétételekor.
Kapcsolat létrehozása
Az összekötő a következő hitelesítési típusokat támogatja:
| Saját alkalmazás használata | Jelentkezzen be saját Twitter-alkalmazásával. További részletekért lásd ezen a lapon a "Hitelesítés és saját alkalmazás használata" című szakaszt. | Minden régió | Nem osztható meg |
| Alapértelmezett [ELAVULT] | Ez a beállítás csak olyan régebbi kapcsolatokhoz használható, amelyeknek nincs explicit hitelesítési típusuk, és csak a visszamenőleges kompatibilitást biztosítják. | Minden régió | Nem osztható meg |
Saját alkalmazás használata
Hitelesítési azonosító: byoa
Alkalmazható: Minden régió
Jelentkezzen be saját Twitter-alkalmazásával. További részletekért lásd ezen a lapon a "Hitelesítés és saját alkalmazás használata" című szakaszt.
Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.
| Név | Típus | Description | Kötelező |
|---|---|---|---|
| Fogyasztói kulcs | karakterlánc | A Twitter-alkalmazás fogyasztói kulcsa | True |
| Fogyasztói titkos kód | securestring | A Twitter-alkalmazás titkos ügyfélkódja | True |
Alapértelmezett [ELAVULT]
Alkalmazható: Minden régió
Ez a beállítás csak olyan régebbi kapcsolatokhoz használható, amelyeknek nincs explicit hitelesítési típusuk, és csak a visszamenőleges kompatibilitást biztosítják.
Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.
Műveletek
| A következők lekérése |
A művelet lekéri azoknak a személyeknek a listáját, akiket az adott felhasználó követ. |
| Az alábbiak lekérése |
Ez a művelet lekéri az általam követett felhasználók listáját. |
| Felhasználó lekérése |
Ez a művelet lekéri egy adott felhasználó profiladatait, például a felhasználónevet, a leírást, a követők számát és egyebeket. |
| Felhasználói idővonal lekérése |
Ez a művelet lekéri az adott felhasználó által közzétett legutóbbi tweetek listáját. |
| Keresés tweetekben |
Ez a művelet lekéri a keresési lekérdezésnek megfelelő releváns tweetek listáját. |
| Követőim lekérése |
Ez a művelet lekéri az engem követő felhasználók listáját. |
| Követők lekérése |
Ez a művelet lekéri az adott felhasználót követő felhasználók listáját. |
| Otthoni idővonal lekérése |
Ez a művelet lekéri a legutóbbi tweeteket és újra tweeteket, amelyeket én és a követőim közzétettek. |
| Tweet közzététele |
Ez a művelet egy új tweetet ad közzé. |
| Újrakezdés |
Ez a művelet újra leküld egy tweetet. |
A következők lekérése
A művelet lekéri azoknak a személyeknek a listáját, akiket az adott felhasználó követ.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Felhasználónév
|
userName | True | string |
X leíró a felhasználó számára. |
|
Maximális eredmények
|
maxResults | integer |
A visszaküldött felhasználók maximális száma. |
Válaszok
- response
- array of UserDetailsModel
Az alábbiak lekérése
Ez a művelet lekéri az általam követett felhasználók listáját.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Maximális eredmények
|
maxResults | integer |
A visszaküldött felhasználók maximális száma. |
Válaszok
- response
- array of UserDetailsModel
Felhasználó lekérése
Ez a művelet lekéri egy adott felhasználó profiladatait, például a felhasználónevet, a leírást, a követők számát és egyebeket.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Felhasználónév
|
userName | True | string |
X leíró a felhasználó számára. |
Válaszok
Felhasználót jelöl.
- Törzs
- UserDetailsModel
Felhasználói idővonal lekérése
Ez a művelet lekéri az adott felhasználó által közzétett legutóbbi tweetek listáját.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Felhasználónév
|
userName | True | string |
X leíró a felhasználó számára. |
|
Maximális eredmények
|
maxResults | integer |
A visszaadni kívánt tweetek maximális száma. |
Válaszok
- response
- array of TweetModel
Keresés tweetekben
Ez a művelet lekéri a keresési lekérdezésnek megfelelő releváns tweetek listáját.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Szöveg keresése
|
searchQuery | True | string |
Keresési kifejezés, mint a "boldog óra", #haiku, from:@username, love OR hate. |
|
Maximális eredmények
|
maxResults | integer |
A visszaadni kívánt tweetek maximális száma. |
|
|
sinceId
|
sinceId | string |
Tweeteket ad vissza a megadott tweet-azonosító után. |
Válaszok
- response
- array of TweetModel
Követőim lekérése
Ez a művelet lekéri az engem követő felhasználók listáját.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Maximális eredmények
|
maxResults | integer |
Maximálisan lekérhető felhasználók száma. |
Válaszok
- response
- array of UserDetailsModel
Követők lekérése
Ez a művelet lekéri az adott felhasználót követő felhasználók listáját.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Felhasználónév
|
userName | True | string |
X leíró a felhasználó számára. |
|
Maximális eredmények
|
maxResults | integer |
A visszaküldött felhasználók maximális száma. |
Válaszok
- response
- array of UserDetailsModel
Otthoni idővonal lekérése
Ez a művelet lekéri a legutóbbi tweeteket és újra tweeteket, amelyeket én és a követőim közzétettek.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Maximális eredmények
|
maxResults | integer |
A visszaadni kívánt tweetek maximális száma. |
Válaszok
- response
- array of TweetModel
Tweet közzététele
Ez a művelet egy új tweetet ad közzé.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Tweet szövege
|
tweetText | string |
Közzéteendő szöveg. |
|
|
Média
|
body | binary |
Közzéteendő adathordozó. |
Válaszok
Egy tweet-bejegyzés válaszát jelöli.
- Törzs
- TweetResponseModel
Újrakezdés
Ez a művelet újra leküld egy tweetet.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Tweet azonosítója
|
tweetId | True | string |
Tweet újrapróbálkozott. |
|
Felhasználó vágása
|
trimUser | boolean |
Logikai érték, amely jelzi, hogy meg szeretné-e vágni a felhasználói adatokat. |
Válaszok
Egy tweet-bejegyzés válaszát jelöli.
- Törzs
- TweetResponseModel
Triggerek
| Új tweet közzétételekor |
Ez a művelet elindít egy folyamatot egy adott keresési lekérdezésnek megfelelő új tweet közzétételekor. |
Új tweet közzétételekor
Ez a művelet elindít egy folyamatot egy adott keresési lekérdezésnek megfelelő új tweet közzétételekor.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Szöveg keresése
|
searchQuery | True | string |
Keresési kifejezés, mint a "boldog óra", #haiku, from:@username, love OR hate. |
Válaszok
Burkolóobjektumot jelöl a kötegelt eseményindító-válaszhoz
Definíciók
TweetModel
Tweet-bejegyzést jelöl.
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Tweet szövege
|
TweetText | string |
A tweet szöveges tartalma |
|
Tweet azonosítója
|
TweetId | string |
A tweet azonosítója |
|
Létrehozás időpontja:
|
CreatedAtIso | string |
A tweet közzétételének időpontja |
|
Újrakezdés száma
|
RetweetCount | integer |
A tweet ismételt tweetjeinek teljes száma |
|
Tweeted by
|
TweetedBy | string |
Annak a felhasználónak a neve, aki közzétette a tweetet |
|
Média URL-címei
|
MediaUrls | array of string |
A tweettel együtt közzétett média URL-címe |
|
Tweet nyelv
|
TweetLanguageCode | string |
A tweet nyelvi kódja |
|
in_reply_to_user_id
|
TweetInReplyToUserId | string |
A tweet szerzőjének felhasználóazonosítója, amelyre az aktuális tweet válaszként szolgál |
|
Kedvenc
|
Favorited | boolean |
Azt jelzi, hogy a tweet kedvencként van-e megjelölve |
|
Felhasználói megemlítések
|
UserMentions | array of UserMentionsModel |
A tweetben említett felhasználók listája |
|
OriginalTweet
|
OriginalTweet | OriginalTweetModel |
Egy eredeti tweet-bejegyzést jelöl. |
|
Felhasználói adatok
|
UserDetails | UserDetailsModel |
Felhasználót jelöl. |
UserMentionsModel
Egy tweetben említett felhasználót jelöl.
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Megemlített felhasználói azonosító
|
Id | integer |
A felhasználó X azonosítója (leírója) |
|
Megemlített felhasználónév teljes neve
|
FullName | string |
A felhasználó teljes neve |
|
Megemlített felhasználónév
|
UserName | string |
A felhasználó képernyőneve |
OriginalTweetModel
Egy eredeti tweet-bejegyzést jelöl.
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Eredeti tweetszöveg
|
TweetText | string |
Az eredeti lekért tweet szöveges tartalma |
|
Eredeti tweet-azonosító
|
TweetId | string |
Az eredeti tweet azonosítója |
|
Eredeti tweet létrehozva:
|
CreatedAtIso | string |
Az eredeti tweet közzétételének időpontja |
|
Eredeti tweet újrakezdési száma
|
RetweetCount | integer |
Az eredeti tweet ismételt tweetjeinek teljes száma |
|
Eredeti tweet tweeted by
|
TweetedBy | string |
Annak a személynek a felhasználóneve, aki az eredeti tweetet közzétette |
|
Eredeti tweet média URL-címei
|
MediaUrls | array of string |
Az eredeti tweettel együtt közzétett média URL-címe |
|
Eredeti tweet nyelv
|
TweetLanguageCode | string |
Az eredeti tweet nyelvi kódja |
|
Eredeti tweet in_reply_to_user_id
|
TweetInReplyToUserId | string |
A tweet szerzőjének felhasználóazonosítója, amelyre az aktuális eredeti tweet válaszként szolgál |
|
Eredeti tweet kedvencként
|
Favorited | boolean |
Azt jelzi, hogy az eredeti tweet kedvencként van-e megjelölve |
|
Eredeti tweet felhasználói megemlítések
|
UserMentions | array of OriginalTweetUserMentionsModel |
A tweetben említett felhasználó listája |
|
Felhasználói adatok
|
UserDetails | OriginalTweetUserDetailsModel |
Azt a felhasználót jelöli, aki eredeti tweetet tett közzé |
UserDetailsModel
Felhasználót jelöl.
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Név
|
FullName | string |
A felhasználó neve |
|
Elhelyezkedés
|
Location | string |
A felhasználó helye |
|
Felhasználói azonosító
|
Id | integer |
A felhasználó X azonosítója (leírója) |
|
Felhasználónév
|
UserName | string |
A felhasználó képernyőneve |
|
Követők száma
|
FollowersCount | integer |
Követők száma |
|
Description
|
Description | string |
Felhasználói leírás |
|
Állapotok száma
|
StatusesCount | integer |
Felhasználói állapotok száma |
|
Barátok száma
|
FriendsCount | integer |
Barátok száma |
|
Kedvencek száma
|
FavouritesCount | integer |
A felhasználó által kedvencként jelölt tweetek száma |
|
Profilkép URL-címe
|
ProfileImageUrl | string |
A profilkép URL-címe |
OriginalTweetUserMentionsModel
Egy eredeti tweetben említett felhasználót jelöl.
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Az eredeti tweetben említett felhasználói azonosító
|
Id | integer |
A felhasználó X azonosítója (leírója) |
|
Az eredeti tweetben említett felhasználó teljes neve
|
FullName | string |
A felhasználó teljes neve |
|
Az eredeti tweetben említett felhasználónév
|
UserName | string |
A felhasználó képernyőneve |
OriginalTweetUserDetailsModel
Azt a felhasználót jelöli, aki eredeti tweetet tett közzé
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Eredeti tweet felhasználó teljes neve
|
FullName | string |
A felhasználó neve |
|
Eredeti tweet felhasználói hely
|
Location | string |
A felhasználó helye |
|
Eredeti tweet felhasználói azonosító
|
Id | integer |
A felhasználó X azonosítója (leírója) |
|
Eredeti tweet felhasználóneve
|
UserName | string |
A felhasználó képernyőneve |
|
Az eredeti tweet felhasználói követőinek száma
|
FollowersCount | integer |
Követők száma |
|
Eredeti tweet felhasználó leírása
|
Description | string |
Felhasználói leírás |
|
A tweet eredeti felhasználói állapotainak száma
|
StatusesCount | integer |
Felhasználói állapotok száma |
|
Eredeti tweet felhasználói barátok száma
|
FriendsCount | integer |
Barátok száma |
|
Eredeti tweet felhasználói kedvencek száma
|
FavouritesCount | integer |
A felhasználó által kedvencként jelölt tweetek száma |
|
Eredeti tweet felhasználói profil képének URL-címe
|
ProfileImageUrl | string |
A profilkép URL-címe |
TweetResponseModel
Egy tweet-bejegyzés válaszát jelöli.
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Tweet azonosítója
|
TweetId | string |
A közzétett tweet azonosítója |
TriggerBatchResponse[TweetModel]
Burkolóobjektumot jelöl a kötegelt eseményindító-válaszhoz
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
value
|
value | array of TweetModel |
A válaszobjektumok listája |