X
X, anciennement Twitter, est un service de réseautage social en ligne qui permet aux utilisateurs d’envoyer et de recevoir des billets courts. Connectez-vous à X pour gérer vos publications. Vous pouvez effectuer différentes actions telles que l’envoi de billets, la recherche, l’affichage des abonnés, etc.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Norme | Toutes les régions Power Automate , à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Norme | Toutes les régions Power Apps , à l’exception des suivantes : - China Cloud géré par 21Vianet |
| Power Automate | Norme | Toutes les régions Power Automate , à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Contact | |
|---|---|
| Nom | Microsoft |
| URL |
Microsoft LogicApps Support Prise en charge de Microsoft Power Automate Prise en charge de Microsoft Power Apps |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Site internet | https://x.com/ |
| Politique de confidentialité | https://x.com/privacy |
Authentification et apportez votre propre application
Important
L’application partagée par défaut (application cliente Twitter gérée par Microsoft) n’est plus disponible. Le connecteur ne prend désormais en charge qu’un seul type d’authentification : apportez votre propre application. À compter de juin 2023, il nécessite une application de niveau Entreprise payante. Toutefois, la politique de tarification de Twitter peut continuer à changer.
Avec l’option « Apportez votre propre application », vous pouvez utiliser votre propre application cliente Twitter OAuth. Cela vous permet de contrôler les autorisations et d’activer certaines limitations sur l’utilisation du connecteur.
Pour utiliser votre propre application cliente Twitter OAuth avec le connecteur Twitter, vous devez effectuer les étapes suivantes :
- Créer une application cliente OAuth à l’aide de la page développeur Twitter (https://developer.twitter.com)
- Utiliser l’application dans le connecteur Twitter
Création d’une application cliente OAuth dans Twitter
Pour créer votre propre application cliente Twitter OAuth, vous devez d’abord vous connecter à https://developer.twitter.com. Accédez à la section « Projects &Apps » qui vous permet de gérer et de créer des applications Twitter. Ce processus est expliqué dans le Guide du développeur Twitter de Twitter. Après avoir créé l’application Twitter sur la page développeur , les étapes suivantes sont requises pour une configuration appropriée :
- Sélectionner votre application Twitter
- Modifiez les autorisations d’application pour activer la lecture et l’écriture.
- Modifier les paramètres d’authentification
- Activer l’authentification tierce
- Ajouter
https://global.consent.azure-apim.net/redirectpour les URL de rappel (REMARQUE : Si vous utilisez l’abonnement Fairfax ou l’environnement GCC, consultez la section « Rappels Fairfax et GCC ») - Définissez « URL du site web » (champ obligatoire, mais sa valeur n’affecte pas le flux)
Rappels Fairfax et GCC
Si vous utilisez l’abonnement Fairfax ou l’environnement GCC, ajoutez les URL suivantes pour les URL de rappel de votre application Twitter :
- Pour 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
- Pour GCC :
https://power-apis-usgov001-public.consent.azure-apihub.us/redirect
Une fois que vous avez terminé, sélectionnez votre application Twitter et accédez à la page « Clés et jetons ». Dans la section « Clés du consommateur », cliquez sur le bouton « Afficher les clés » pour obtenir la clé API et le secret de clé API de votre application. Vous pouvez maintenant utiliser ces valeurs dans votre connexion Twitter.
Utilisation de votre propre application dans le connecteur Twitter
Une fois que vous avez créé l’application cliente OAuth Twitter, vous pouvez l’utiliser lors de la création d’une connexion Twitter.
- Sélectionnez Apporter votre propre application.
- Spécifiez les valeurs d’ID client et de clé secrète client de votre application. (Utilisez la clé API et le secret de clé API de votre application Twitter)
Cliquez sur Se connecter pour vous connecter à votre compte Twitter. Vous êtes alors invité à vous connecter à votre compte Twitter, puis à autoriser l’accès à l’application Twitter que vous avez créée ci-dessus.
LIMITES
Voici quelques-unes des limites et restrictions suivantes :
- Nombre maximal de connexions par utilisateur : 2
- Limite du taux d’appel de l’API pour l’opération POST : 12 par heure
- Limite du taux d’appel d’API pour d’autres opérations : 600 par heure
- Fréquence des sondages déclencheurs : 1 heure
- Taille maximale du chargement d’image : 5 Mo
- Taille maximale du chargement vidéo : 15 Mo
- Nombre maximal de résultats de recherche : 100
- Nombre maximal de nouveaux tweets suivis dans un intervalle d’interrogation : 5
- La longueur maximale autorisée de la valeur du paramètre « Texte de recherche » est de 470
Restrictions de l’API Twitter
- Recherche d’API recherche dans un échantillonnage des tweets récents publiés au cours des 7 derniers jours
- L’API de recherche standard est axée sur la pertinence et l’exhaustivité. Cela signifie que certains Tweets et utilisateurs peuvent être manquants dans les résultats de recherche
Restrictions supplémentaires pour l’opération POST
La mention d’un @user tweet lors de la publication d’un tweet n’est pas prise en charge. Plus précisément, les caractères « @ » seront supprimés lors de la publication d’un tweet.
Limites générales
| Nom | Valeur |
|---|---|
| Connexions par compte | 2 |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Apportez votre propre application | Connectez-vous à l’aide de votre propre application Twitter. Pour plus d’informations, consultez la section « Authentification et apportez votre propre application » sur cette page. | Toutes les régions | Non partageable |
| Valeur par défaut [DÉCONSEILLÉE] | Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante. | Toutes les régions | Non partageable |
Apportez votre propre application
ID d’authentification : byoa
Applicable : Toutes les régions
Connectez-vous à l’aide de votre propre application Twitter. Pour plus d’informations, consultez la section « Authentification et apportez votre propre application » sur cette page.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé du consommateur | ficelle | Clé de consommateur de votre application Twitter | Vrai |
| Secret du consommateur | securestring | Clé secrète client de votre application Twitter | Vrai |
Valeur par défaut [DÉCONSEILLÉE]
Applicable : Toutes les régions
Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
Actions
| Obtenir des abonnés |
Cette opération obtient la liste des utilisateurs qui suivent un utilisateur donné. |
| Obtenir la chronologie de la maison |
Cette opération obtient les tweets les plus récents et les re-tweets publiés par moi et mes abonnés. |
| Obtenir la chronologie de l’utilisateur |
Cette opération obtient la liste des tweets les plus récents publiés par un utilisateur donné. |
| Obtenir les informations suivantes |
L’opération obtient la liste des personnes que l’utilisateur donné suit. |
| Obtenir mes abonnés |
Cette opération obtient la liste des utilisateurs qui me suivent. |
| Obtenir mon code suivant |
Cette opération obtient la liste des utilisateurs que je suit. |
| Obtenir un utilisateur |
Cette opération obtient les détails du profil pour un utilisateur donné, comme le nom d’utilisateur, la description, le nombre d’abonnés, etc. |
| Publier un tweet |
Cette opération publie un nouveau tweet. |
| Rechercher des tweets |
Cette opération obtient une liste de tweets pertinents correspondant à la requête de recherche. |
| Retweet |
Cette opération retweet un tweet. |
Obtenir des abonnés
Cette opération obtient la liste des utilisateurs qui suivent un utilisateur donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom d'utilisateur
|
userName | True | string |
Handle X pour l’utilisateur. |
|
Résultats maximum
|
maxResults | integer |
Nombre maximal d’utilisateurs à retourner. |
Retours
- response
- array of UserDetailsModel
Obtenir la chronologie de la maison
Cette opération obtient les tweets les plus récents et les re-tweets publiés par moi et mes abonnés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Résultats maximum
|
maxResults | integer |
Nombre maximal de tweets à retourner. |
Retours
- response
- array of TweetModel
Obtenir la chronologie de l’utilisateur
Cette opération obtient la liste des tweets les plus récents publiés par un utilisateur donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom d'utilisateur
|
userName | True | string |
Handle X pour l’utilisateur. |
|
Résultats maximum
|
maxResults | integer |
Nombre maximal de tweets à retourner. |
Retours
- response
- array of TweetModel
Obtenir les informations suivantes
L’opération obtient la liste des personnes que l’utilisateur donné suit.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom d'utilisateur
|
userName | True | string |
Handle X pour l’utilisateur. |
|
Résultats maximum
|
maxResults | integer |
Nombre maximal d’utilisateurs à retourner. |
Retours
- response
- array of UserDetailsModel
Obtenir mes abonnés
Cette opération obtient la liste des utilisateurs qui me suivent.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Résultats maximum
|
maxResults | integer |
Nombre maximal d’utilisateurs à obtenir. |
Retours
- response
- array of UserDetailsModel
Obtenir mon code suivant
Cette opération obtient la liste des utilisateurs que je suit.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Résultats maximum
|
maxResults | integer |
Nombre maximal d’utilisateurs à retourner. |
Retours
- response
- array of UserDetailsModel
Obtenir un utilisateur
Cette opération obtient les détails du profil pour un utilisateur donné, comme le nom d’utilisateur, la description, le nombre d’abonnés, etc.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom d'utilisateur
|
userName | True | string |
Handle X pour l’utilisateur. |
Retours
Représente un utilisateur.
- Corps
- UserDetailsModel
Publier un tweet
Cette opération publie un nouveau tweet.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Texte du tweet
|
tweetText | string |
Texte à publier. |
|
|
Média
|
body | binary |
Médias à publier. |
Retours
Représente la réponse d’un billet de tweet.
- Corps
- TweetResponseModel
Rechercher des tweets
Cette opération obtient une liste de tweets pertinents correspondant à la requête de recherche.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Texte de recherche
|
searchQuery | True | string |
Terme de recherche comme « happy hour », #haiku, from :@username, love OR hate. |
|
Résultats maximum
|
maxResults | integer |
Nombre maximal de tweets à retourner. |
|
|
sinceId
|
sinceId | string |
Retournez des tweets après l’ID de tweet spécifié. |
Retours
- response
- array of TweetModel
Retweet
Cette opération retweet un tweet.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de tweet
|
tweetId | True | string |
Tweet pour être retweeted. |
|
Découper l’utilisateur
|
trimUser | boolean |
Boolean pour indiquer s’il faut découper les informations utilisateur. |
Retours
Représente la réponse d’un billet de tweet.
- Corps
- TweetResponseModel
Déclencheurs
| Lorsqu’un nouveau tweet est publié |
Cette opération déclenche un flux lorsqu’un nouveau tweet correspondant à une requête de recherche donnée est publié. |
Lorsqu’un nouveau tweet est publié
Cette opération déclenche un flux lorsqu’un nouveau tweet correspondant à une requête de recherche donnée est publié.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Texte de recherche
|
searchQuery | True | string |
Terme de recherche comme « happy hour », #haiku, from :@username, love OR hate. |
Retours
Représente un objet wrapper pour la réponse de déclencheur par lot
Définitions
TweetModel
Représente un billet de tweet.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Texte du tweet
|
TweetText | string |
Contenu texte du tweet |
|
ID de tweet
|
TweetId | string |
ID du tweet |
|
Créé à
|
CreatedAtIso | string |
Heure à laquelle le tweet a été publié |
|
Nombre de retweets
|
RetweetCount | integer |
Nombre total de re-tweets pour le tweet |
|
Tweeté par
|
TweetedBy | string |
Nom de l’utilisateur qui a publié le tweet |
|
URL de média
|
MediaUrls | array of string |
URL du média publié avec le tweet |
|
Langue du tweet
|
TweetLanguageCode | string |
Code de langue du tweet |
|
in_reply_to_user_id
|
TweetInReplyToUserId | string |
ID utilisateur de l’auteur du tweet que le tweet actuel est une réponse à |
|
Favoris
|
Favorited | boolean |
Indique si le tweet est marqué comme favori ou non |
|
Mentions utilisateur
|
UserMentions | array of UserMentionsModel |
Liste des utilisateurs mentionnés dans le tweet |
|
OriginalTweet
|
OriginalTweet | OriginalTweetModel |
Représente un billet de tweet d’origine. |
|
Détails de l’utilisateur
|
UserDetails | UserDetailsModel |
Représente un utilisateur. |
UserMentionsModel
Représente un utilisateur mentionné dans un tweet.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID d’utilisateur mentionné
|
Id | integer |
ID X (handle) de l’utilisateur |
|
Nom complet de l’utilisateur mentionné
|
FullName | string |
Nom complet de l’utilisateur |
|
Nom d’utilisateur mentionné
|
UserName | string |
Nom d’écran de l’utilisateur |
OriginalTweetModel
Représente un billet de tweet d’origine.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Texte du tweet d’origine
|
TweetText | string |
Contenu texte du tweet récupéré d’origine |
|
ID de tweet d’origine
|
TweetId | string |
ID du tweet d’origine |
|
Tweet d’origine créé à l’adresse
|
CreatedAtIso | string |
Heure à laquelle le tweet d’origine a été publié |
|
Nombre de retweets de tweet d’origine
|
RetweetCount | integer |
Nombre total de re-tweets pour ce tweet d’origine |
|
Tweet d’origine tweeté par
|
TweetedBy | string |
Nom d’utilisateur de la personne qui a publié le tweet d’origine |
|
URL du média de tweet d’origine
|
MediaUrls | array of string |
URL du média publié avec le tweet d’origine |
|
Langue du tweet d’origine
|
TweetLanguageCode | string |
Code de langue du tweet d’origine |
|
Tweet d’origine in_reply_to_user_id
|
TweetInReplyToUserId | string |
ID utilisateur de l’auteur du tweet auquel le tweet d’origine actuel est une réponse |
|
Tweet d’origine préféré
|
Favorited | boolean |
Indique si le tweet d’origine est marqué comme favori |
|
Mentions utilisateur de tweet d’origine
|
UserMentions | array of OriginalTweetUserMentionsModel |
Liste de l’utilisateur mentionné dans le tweet |
|
Détails de l’utilisateur
|
UserDetails | OriginalTweetUserDetailsModel |
Représente un utilisateur qui a publié un tweet d’origine |
UserDetailsModel
Représente un utilisateur.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nom
|
FullName | string |
Nom de l’utilisateur |
|
Emplacement
|
Location | string |
Emplacement de l’utilisateur |
|
Identifiant utilisateur
|
Id | integer |
ID X (handle) de l’utilisateur |
|
Nom d'utilisateur
|
UserName | string |
Nom d’écran de l’utilisateur |
|
Nombre d’abonnés
|
FollowersCount | integer |
Nombre d’abonnés |
|
Descriptif
|
Description | string |
Description de l’utilisateur |
|
Nombre d’états
|
StatusesCount | integer |
Nombre d’états utilisateur |
|
Nombre d’amis
|
FriendsCount | integer |
Nombre d’amis |
|
Nombre de favoris
|
FavouritesCount | integer |
Nombre de tweets que l’utilisateur a favoris |
|
URL de l’image de profil
|
ProfileImageUrl | string |
URL de l’image de profil |
OriginalTweetUserMentionsModel
Représente un utilisateur mentionné dans un tweet d’origine.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id d’utilisateur mentionné dans le tweet d’origine
|
Id | integer |
ID X (handle) de l’utilisateur |
|
Tweet d’origine mentionné nom complet de l’utilisateur
|
FullName | string |
Nom complet de l’utilisateur |
|
Tweet d’origine mentionné nom d’utilisateur
|
UserName | string |
Nom d’écran de l’utilisateur |
OriginalTweetUserDetailsModel
Représente un utilisateur qui a publié un tweet d’origine
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nom complet de l’utilisateur du tweet d’origine
|
FullName | string |
Nom de l’utilisateur |
|
Emplacement utilisateur du tweet d’origine
|
Location | string |
Emplacement de l’utilisateur |
|
ID d’utilisateur du tweet d’origine
|
Id | integer |
ID X (handle) de l’utilisateur |
|
Nom d’utilisateur du tweet d’origine
|
UserName | string |
Nom d’écran de l’utilisateur |
|
Nombre d’abonnés utilisateur du tweet d’origine
|
FollowersCount | integer |
Nombre d’abonnés |
|
Description de l’utilisateur du tweet d’origine
|
Description | string |
Description de l’utilisateur |
|
Nombre d’états utilisateur du tweet d’origine
|
StatusesCount | integer |
Nombre d’états utilisateur |
|
Nombre d’amis utilisateur de tweet d’origine
|
FriendsCount | integer |
Nombre d’amis |
|
Nombre de favoris des utilisateurs de tweets d’origine
|
FavouritesCount | integer |
Nombre de tweets que l’utilisateur a favoris |
|
URL de l’image de profil utilisateur du tweet d’origine
|
ProfileImageUrl | string |
URL de l’image de profil |
TweetResponseModel
Représente la réponse d’un billet de tweet.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de tweet
|
TweetId | string |
ID du tweet publié |
TriggerBatchResponse[TweetModel]
Représente un objet wrapper pour la réponse de déclencheur par lot
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
value
|
value | array of TweetModel |
Liste des objets de réponse |