X
X, früher als Twitter bezeichnet, ist ein Online-Dienst für soziale Netzwerke, der es Benutzern ermöglicht, kurze Beiträge zu senden und zu empfangen. Stellen Sie eine Verbindung mit X her, um Ihre Beiträge zu verwalten. Sie können verschiedene Aktionen ausführen, z. B. Beiträge senden, Suchen, Follower anzeigen usw.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - China Cloud betrieben von 21Vianet |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Norm | Alle Power Apps-Regionen mit Ausnahme der folgenden: - China Cloud betrieben von 21Vianet |
| Power Automate | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - China Cloud betrieben von 21Vianet |
| Kontakt | |
|---|---|
| Name | Microsoft |
| URL |
Microsoft LogicApps-Unterstützung Microsoft Power Automate-Support Microsoft Power Apps-Unterstützung |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft |
| Webseite | https://x.com/ |
| Datenschutzrichtlinie | https://x.com/privacy |
Authentifizierung und Eigene Anwendung mitbringen
Von Bedeutung
Die von Microsoft verwaltete Standardanwendung (Twitter-Clientanwendung, die von Microsoft verwaltet wird) ist nicht mehr verfügbar. Der Connector unterstützt jetzt nur einen Authentifizierungstyp – Bring your own application. Ab Juni 2023 ist eine kostenpflichtige Enterprise-Stufe-Anwendung erforderlich. Die Preispolitik von Twitter kann sich jedoch weiterhin ändern.
Mit der Option "Eigene Anwendung mitbringen" können Sie Ihre eigene Twitter OAuth Client-Anwendung verwenden. Auf diese Weise können Sie Berechtigungen steuern und bestimmte Einschränkungen für die Verwendung des Connectors aktivieren.
Um Ihre eigene Twitter OAuth Client-Anwendung mit dem Twitter-Connector zu verwenden, müssen Sie die folgenden Schritte ausführen:
- Erstellen einer OAuth-Clientanwendung mithilfe der Twitter-Entwicklerseite (https://developer.twitter.com)
- Verwenden der Anwendung im Twitter-Connector
Erstellen einer OAuth-Clientanwendung in Twitter
Um Ihre eigene Twitter OAuth-Clientanwendung zu erstellen, müssen Sie sich zuerst bei https://developer.twitter.com. Navigieren Sie zum Abschnitt "Projekte & Apps", in dem Sie Twitter-Anwendungen verwalten und erstellen können. Dieser Prozess wird im Twitter-Entwicklerhandbuch erläutert. Nach dem Erstellen einer Twitter-App auf der Entwicklerseite sind die folgenden Schritte für die ordnungsgemäße Einrichtung erforderlich:
- Auswählen Ihrer Twitter-App
- Bearbeiten Sie App-Berechtigungen, um Lese- und Schreibzugriff zu aktivieren.
- Authentifizierungseinstellungen bearbeiten
- Aktivieren der Drittanbieterauthentifizierung
- Add
https://global.consent.azure-apim.net/redirectfor the callback URLs (NOTE: If you are using Fairfax subscription or GCC environment look at "Fairfax and GCC callbacks" section) - Festlegen von "Website-URL" (erforderliches Feld, aber der Wert hat keine Auswirkungen auf den Fluss)
Fairfax- und GCC-Rückrufe
Wenn Sie das Fairfax-Abonnement oder die GCC-Umgebung verwenden, fügen Sie die folgenden URLs für die Rückruf-URLs Ihrer Twitter-App hinzu:
- 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
Nachdem Sie fertig sind, wählen Sie Ihre Twitter-App aus, und navigieren Sie zur Seite "Schlüssel und Token". Klicken Sie im Abschnitt "Consumer Keys" auf die Schaltfläche "Ansichtsschlüssel", um den API-Schlüssel und den API-Schlüsselschlüssel Ihrer App abzurufen. Sie können diese Werte jetzt in Ihrer Twitter-Verbindung verwenden.
Verwenden Ihrer eigenen Anwendung im Twitter-Connector
Nachdem Sie die Twitter OAuth-Clientanwendung erstellt haben, können Sie sie beim Erstellen einer Twitter-Verbindung verwenden.
- Wählen Sie "Eigene Anwendung mitbringen" aus.
- Geben Sie die Werte der Client-ID und des geheimen Clientschlüssels aus Ihrer Anwendung an. (Verwenden Sie den API-Schlüssel und den API-Schlüsselschlüssel Ihrer Twitter-App )
Klicken Sie auf " Anmelden ", um sich bei Ihrem Twitter-Konto anzumelden. Dadurch werden Sie aufgefordert, sich bei Ihrem Twitter-Konto anzumelden und dann den Zugriff auf die oben erstellte Twitter-App zu autorisieren.
GRENZEN
Im Folgenden sind einige der Grenzwerte und Einschränkungen aufgeführt:
- Maximale Anzahl von Verbindungen pro Benutzer: 2
- API-Aufrufratenlimit für POST-Vorgänge: 12 pro Stunde
- API-Aufrufratenlimit für andere Vorgänge: 600 pro Stunde
- Häufigkeit der Triggerumfragen: 1 Stunde
- Maximale Größe des Bilduploads: 5 MB
- Maximale Größe des Videouploads: 15 MB
- Maximale Anzahl von Suchergebnissen: 100
- Maximale Anzahl neuer Tweets, die innerhalb eines Abrufintervalls nachverfolgt werden: 5
- Die maximal zulässige Länge des Parameters 'Suchtext' beträgt 470.
Einschränkungen der Twitter-API
- Such-API sucht nach einer Stichprobe der letzten Tweets, die in den letzten 7 Tagen veröffentlicht wurden
- Die Standardmäßige Such-API konzentriert sich auf Relevanz und nicht auf Vollständigkeit. Dies bedeutet, dass einige Tweets und Benutzer möglicherweise aus Suchergebnissen fehlen
Zusätzliche Einschränkungen für POST-Vorgang
Das Erwähnen einer @user Während der Veröffentlichung eines Tweets wird nicht unterstützt. Insbesondere werden die Zeichen "@" beim Posten eines Tweets entfernt.
Allgemeine Grenzwerte
| Name | Wert |
|---|---|
| Verbindungen pro Konto | 2 |
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Bring Your Own Application | Melden Sie sich mit Ihrer eigenen Twitter-App an. Weitere Informationen finden Sie im Abschnitt "Authentifizierung und Bring your own application" auf dieser Seite. | Alle Regionen | Nicht teilbar |
| Standard [VERALTET] | Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. | Alle Regionen | Nicht teilbar |
Eigene Anwendung mitbringen
Authentifizierungs-ID: byoa
Anwendbar: Alle Regionen
Melden Sie sich mit Ihrer eigenen Twitter-App an. Weitere Informationen finden Sie im Abschnitt "Authentifizierung und Bring your own application" auf dieser Seite.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Consumer Key | Schnur | Verbraucherschlüssel Ihrer Twitter-Anwendung | Richtig |
| Geheimer Verbraucherschlüssel | securestring | Geheimer Clientschlüssel Ihrer Twitter-Anwendung | Richtig |
Standard [VERALTET]
Anwendbar: Alle Regionen
Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
Aktionen
| Benutzer abrufen |
Dieser Vorgang ruft die Profildetails für einen bestimmten Benutzer ab, z. B. Benutzername, Beschreibung, Anzahl der Follower und mehr. |
| Benutzerzeitachse abrufen |
Dieser Vorgang erhält eine Liste der neuesten Tweets, die von einem bestimmten Benutzer gepostet wurden. |
| Folgen |
Der Vorgang ruft die Liste der Personen ab, die der angegebene Benutzer folgt. |
| Follower abrufen |
Dieser Vorgang ruft die Liste der Benutzer ab, die einem bestimmten Benutzer folgen. |
| Meine Folgenden abrufen |
Dieser Vorgang ruft die Liste der Benutzer ab, denen ich folge. |
| Meine Follower abrufen |
Dieser Vorgang ruft die Liste der Benutzer ab, die mir folgen. |
| Posten eines Tweets |
Dieser Vorgang veröffentlicht einen neuen Tweet. |
| Retweet |
Dieser Vorgang retweet einen Tweet. |
| Startseitenzeitachse abrufen |
Dieser Vorgang erhält die neuesten Tweets und re-tweets von mir und meinen Followern gepostet. |
| Tweets suchen |
Dieser Vorgang ruft eine Liste der relevanten Tweets ab, die der Suchabfrage entsprechen. |
Benutzer abrufen
Dieser Vorgang ruft die Profildetails für einen bestimmten Benutzer ab, z. B. Benutzername, Beschreibung, Anzahl der Follower und mehr.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzername
|
userName | True | string |
X-Handle für den Benutzer. |
Gibt zurück
Stellt einen Benutzer dar.
- Body
- UserDetailsModel
Benutzerzeitachse abrufen
Dieser Vorgang erhält eine Liste der neuesten Tweets, die von einem bestimmten Benutzer gepostet wurden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzername
|
userName | True | string |
X-Handle für den Benutzer. |
|
Maximale Ergebnisse
|
maxResults | integer |
Maximale Anzahl von Tweets, die zurückgegeben werden sollen. |
Gibt zurück
- response
- array of TweetModel
Folgen
Der Vorgang ruft die Liste der Personen ab, die der angegebene Benutzer folgt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzername
|
userName | True | string |
X-Handle für den Benutzer. |
|
Maximale Ergebnisse
|
maxResults | integer |
Maximale Anzahl von Benutzern, die zurückgegeben werden sollen. |
Gibt zurück
- response
- array of UserDetailsModel
Follower abrufen
Dieser Vorgang ruft die Liste der Benutzer ab, die einem bestimmten Benutzer folgen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzername
|
userName | True | string |
X-Handle für den Benutzer. |
|
Maximale Ergebnisse
|
maxResults | integer |
Maximale Anzahl von Benutzern, die zurückgegeben werden sollen. |
Gibt zurück
- response
- array of UserDetailsModel
Meine Folgenden abrufen
Dieser Vorgang ruft die Liste der Benutzer ab, denen ich folge.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Maximale Ergebnisse
|
maxResults | integer |
Maximale Anzahl von Benutzern, die zurückgegeben werden sollen. |
Gibt zurück
- response
- array of UserDetailsModel
Meine Follower abrufen
Dieser Vorgang ruft die Liste der Benutzer ab, die mir folgen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Maximale Ergebnisse
|
maxResults | integer |
Maximale Anzahl von Benutzern, die abgerufen werden sollen. |
Gibt zurück
- response
- array of UserDetailsModel
Posten eines Tweets
Dieser Vorgang veröffentlicht einen neuen Tweet.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tweettext
|
tweetText | string |
Text, der gepostet werden soll. |
|
|
Medien
|
body | binary |
Zu postende Medien. |
Gibt zurück
Stellt die Antwort eines Tweetbeitrags dar.
- Body
- TweetResponseModel
Retweet
Dieser Vorgang retweet einen Tweet.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tweet-ID
|
tweetId | True | string |
Tweet zu retweeted. |
|
Benutzer kürzen
|
trimUser | boolean |
Boolescher Wert, der angibt, ob Benutzerinformationen gekürzt werden sollen. |
Gibt zurück
Stellt die Antwort eines Tweetbeitrags dar.
- Body
- TweetResponseModel
Startseitenzeitachse abrufen
Dieser Vorgang erhält die neuesten Tweets und re-tweets von mir und meinen Followern gepostet.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Maximale Ergebnisse
|
maxResults | integer |
Maximale Anzahl von Tweets, die zurückgegeben werden sollen. |
Gibt zurück
- response
- array of TweetModel
Tweets suchen
Dieser Vorgang ruft eine Liste der relevanten Tweets ab, die der Suchabfrage entsprechen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Suchtext
|
searchQuery | True | string |
Suchbegriff wie "Happy Hour", #haiku, from:@username, love OR hasse. |
|
Maximale Ergebnisse
|
maxResults | integer |
Maximale Anzahl von Tweets, die zurückgegeben werden sollen. |
|
|
sinceId
|
sinceId | string |
Geben Sie Tweets nach der angegebenen Tweet-ID zurück. |
Gibt zurück
- response
- array of TweetModel
Auslöser
| Wenn ein neuer Tweet gepostet wird |
Dieser Vorgang löst einen Fluss aus, wenn ein neuer Tweet, der einer bestimmten Suchabfrage entspricht, gepostet wird. |
Wenn ein neuer Tweet gepostet wird
Dieser Vorgang löst einen Fluss aus, wenn ein neuer Tweet, der einer bestimmten Suchabfrage entspricht, gepostet wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Suchtext
|
searchQuery | True | string |
Suchbegriff wie "Happy Hour", #haiku, from:@username, love OR hasse. |
Gibt zurück
Stellt ein Wrapperobjekt für die Batchtriggerantwort dar.
Definitionen
TweetModel
Stellt einen Tweetbeitrag dar.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Tweettext
|
TweetText | string |
Textinhalt des Tweets |
|
Tweet-ID
|
TweetId | string |
ID des Tweets |
|
Erstellt am
|
CreatedAtIso | string |
Zeitpunkt, zu dem der Tweet gepostet wurde |
|
Retweet count
|
RetweetCount | integer |
Gesamtzahl der erneuten Tweets für den Tweet |
|
Tweet von
|
TweetedBy | string |
Name des Benutzers, der den Tweet gepostet hat |
|
Medien-URLs
|
MediaUrls | array of string |
Url der Medien, die zusammen mit dem Tweet gepostet wurden |
|
Tweet-Sprache
|
TweetLanguageCode | string |
Sprachcode des Tweets |
|
in_reply_to_user_id
|
TweetInReplyToUserId | string |
Benutzer-ID des Autors des Tweets, dass der aktuelle Tweet eine Antwort auf |
|
Favoriten
|
Favorited | boolean |
Gibt an, ob der Tweet als Favorit gekennzeichnet ist oder nicht. |
|
Benutzererwähnungen
|
UserMentions | array of UserMentionsModel |
Liste der im Tweet erwähnten Benutzer |
|
OriginalTweet
|
OriginalTweet | OriginalTweetModel |
Stellt einen ursprünglichen Tweetbeitrag dar. |
|
BenutzerDetails
|
UserDetails | UserDetailsModel |
Stellt einen Benutzer dar. |
UserMentionsModel
Stellt einen in einem Tweet erwähnten Benutzer dar.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Erwähnte Benutzer-ID
|
Id | integer |
X-ID (Handle) des Benutzers |
|
Erwähnter Vollständiger Benutzername
|
FullName | string |
Vollständiger Name des Benutzers |
|
Erwähnter Benutzername
|
UserName | string |
Bildschirmname des Benutzers |
OriginalTweetModel
Stellt einen ursprünglichen Tweetbeitrag dar.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Ursprünglicher Tweettext
|
TweetText | string |
Textinhalt des ursprünglich abgerufenen Tweets |
|
Ursprüngliche Tweet-ID
|
TweetId | string |
ID des ursprünglichen Tweets |
|
Ursprünglicher Tweet erstellt unter
|
CreatedAtIso | string |
Zeitpunkt, zu dem der ursprüngliche Tweet gepostet wurde |
|
Ursprüngliche Tweet Retweet Anzahl
|
RetweetCount | integer |
Gesamtzahl der erneuten Tweets für diesen ursprünglichen Tweet |
|
Ursprünglicher Tweet tweeted by
|
TweetedBy | string |
Benutzername der Person, die den ursprünglichen Tweet gepostet hat |
|
Ursprüngliche Tweet-Medien-URLs
|
MediaUrls | array of string |
Url der Medien, die zusammen mit dem ursprünglichen Tweet gepostet wurden |
|
Ursprüngliche Tweetsprache
|
TweetLanguageCode | string |
Sprachcode für den ursprünglichen Tweet |
|
Ursprünglicher Tweet in_reply_to_user_id
|
TweetInReplyToUserId | string |
Benutzer-ID des Autors des Tweets, dass der aktuelle ursprüngliche Tweet eine Antwort auf |
|
Ursprünglicher Tweet mit Favoriten
|
Favorited | boolean |
Gibt an, ob der ursprüngliche Tweet als Favorit gekennzeichnet ist. |
|
Ursprüngliche Tweet-Benutzer-Erwähnungen
|
UserMentions | array of OriginalTweetUserMentionsModel |
Die Liste der im Tweet erwähnten Benutzer |
|
BenutzerDetails
|
UserDetails | OriginalTweetUserDetailsModel |
Stellt einen Benutzer dar, der einen ursprünglichen Tweet gepostet hat |
UserDetailsModel
Stellt einen Benutzer dar.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Name
|
FullName | string |
Name des Benutzers |
|
Standort
|
Location | string |
Speicherort des Benutzers |
|
Benutzer-ID
|
Id | integer |
X-ID (Handle) des Benutzers |
|
Benutzername
|
UserName | string |
Bildschirmname des Benutzers |
|
Anzahl der Follower
|
FollowersCount | integer |
Anzahl der Follower |
|
Description
|
Description | string |
Benutzerbeschreibung |
|
Anzahl der Statuswerte
|
StatusesCount | integer |
Anzahl der Benutzerstatus |
|
Anzahl Der Freunde
|
FriendsCount | integer |
Anzahl der Freunde |
|
Favoritenanzahl
|
FavouritesCount | integer |
Anzahl der Tweets, die der Benutzer als Favoriten verwendet hat |
|
Profilbild-URL
|
ProfileImageUrl | string |
URL des Profilbilds |
OriginalTweetUserMentionsModel
Stellt einen Benutzer dar, der in einem ursprünglichen Tweet erwähnt wird.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Ursprünglicher Tweet erwähnte Benutzer-ID
|
Id | integer |
X-ID (Handle) des Benutzers |
|
Ursprünglicher Tweet erwähnter Benutzername
|
FullName | string |
Vollständiger Name des Benutzers |
|
Ursprünglicher Tweet erwähnter Benutzername
|
UserName | string |
Bildschirmname des Benutzers |
OriginalTweetUserDetailsModel
Stellt einen Benutzer dar, der einen ursprünglichen Tweet gepostet hat
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Vollständiger Name des ursprünglichen Tweets
|
FullName | string |
Name des Benutzers |
|
Ursprünglicher Tweet-Benutzerstandort
|
Location | string |
Speicherort des Benutzers |
|
Ursprüngliche Tweet-Benutzer-ID
|
Id | integer |
X-ID (Handle) des Benutzers |
|
Ursprünglicher Tweet-Benutzername
|
UserName | string |
Bildschirmname des Benutzers |
|
Ursprüngliche Anzahl der Tweet-Nutzer-Follower
|
FollowersCount | integer |
Anzahl der Follower |
|
Beschreibung des ursprünglichen Tweets
|
Description | string |
Benutzerbeschreibung |
|
Anzahl der ursprünglichen Tweet-Benutzerstatus
|
StatusesCount | integer |
Anzahl der Benutzerstatus |
|
Ursprüngliche Anzahl der Tweet-Benutzerfreunde
|
FriendsCount | integer |
Anzahl der Freunde |
|
Ursprüngliche Anzahl der Tweet-Favoriten
|
FavouritesCount | integer |
Anzahl der Tweets, die der Benutzer als Favoriten verwendet hat |
|
Url des ursprünglichen Tweet-Benutzerprofils
|
ProfileImageUrl | string |
URL des Profilbilds |
TweetResponseModel
Stellt die Antwort eines Tweetbeitrags dar.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Tweet-ID
|
TweetId | string |
ID des geposteten Tweets |
TriggerBatchResponse[TweetModel]
Stellt ein Wrapperobjekt für die Batchtriggerantwort dar.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
value
|
value | array of TweetModel |
Eine Liste der Antwortobjekte |