Passer au contenu principal

PostsClient

Classe Bases : object Client pour les opérations sur les publications

Constructeurs

__init__

Paramètres

path.client
Client

create

Créer ou modifier une Publication Crée une nouvelle Publication pour l’utilisateur authentifié, ou modifie une Publication existante lorsque edit_options est défini. body: Corps de la requête :returns: Données de la réponse :rtype: CreateResponse

Paramètres

body.body
CreateRequest

delete

Supprimer une Publication Supprime une Publication spécifique par son id, si elle appartient à l’utilisateur authentifié.

Paramètres

path.id
Any
L’identifiant de la Publication à supprimer.

Renvoie

DeleteResponse - Données de réponse

get_analytics

Obtenir les analyses des Publications Récupère les données d’analyse des Publications spécifiées sur un intervalle de temps défini.

Paramètres

path.ids
List
Une liste d’identifiants de Publications séparés par des virgules. Jusqu’à 100 sont autorisés dans une seule requête.
path.end_time
str
YYYY-MM-DDTHH:mm:ssZ. L’horodatage UTC représentant la fin de l’intervalle de temps.
path.start_time
str
YYYY-MM-DDTHH:mm:ssZ. L’horodatage UTC représentant le début de l’intervalle de temps.
path.granularity
str
La granularité des résultats de comptage de recherche.
path.analytics_fields
List or None
défaut:"None"
Une liste, séparée par des virgules, de champs Analytics à afficher.

Renvoie

GetAnalyticsResponse - Données de réponse

get_by_id

Obtenir une Publication par id Récupère les détails d’une Publication spécifique à partir de son id.

Paramètres

path.id
Any
Un seul identifiant de Publication.
path.tweet_fields
List or None
défaut:"None"
Une liste de champs de Tweet, séparés par des virgules, à afficher.
path.expansions
List or None
défaut:"None"
Une liste de champs, séparés par des virgules, à étendre.
path.media_fields
List or None
défaut:"None"
Une liste de champs de médias, séparés par des virgules, à afficher.
path.poll_fields
List or None
défaut:"None"
Une liste de champs de sondage, séparés par des virgules, à afficher.
path.user_fields
List or None
défaut:"None"
Une liste de champs d’utilisateur, séparés par des virgules, à afficher.
path.place_fields
List or None
défaut:"None"
Une liste de champs de lieu, séparés par des virgules, à afficher.

Renvoie

GetByIdResponse - Données de la réponse

get_by_ids

Obtenir des Publications par leurs id Récupère les détails de plusieurs Publications en fonction de leurs id.

Paramètres

path.ids
List
Une liste d’identifiants de Publications, séparés par des virgules. Jusqu’à 100 peuvent être inclus dans une seule requête.
path.tweet_fields
List or None
défaut:"None"
Une liste de champs de Tweet à afficher, séparés par des virgules.
path.expansions
List or None
défaut:"None"
Une liste de champs à développer, séparés par des virgules.
path.media_fields
List or None
défaut:"None"
Une liste de champs de média à afficher, séparés par des virgules.
path.poll_fields
List or None
défaut:"None"
Une liste de champs de sondage à afficher, séparés par des virgules.
path.user_fields
List or None
défaut:"None"
Une liste de champs d’utilisateur à afficher, séparés par des virgules.
path.place_fields
List or None
défaut:"None"
Une liste de champs de lieu à afficher, séparés par des virgules.

Valeur de retour

GetByIdsResponse - Données de la réponse

get_counts_all

Obtenir le nombre total de Publications Renvoie le nombre de Publications correspondant à une requête de recherche dans l’archive complète.

Paramètres

path.query
str
Une requête, une règle ou un filtre pour faire correspondre des Publications. Pour identifier la longueur maximale de la requête, consultez https://t.co/rulelength.
path.start_time
str or None
défaut:"None"
YYYY-MM-DDTHH:mm:ssZ. L’horodatage UTC le plus ancien (parmi les 7 derniers jours) à partir duquel les Publications seront renvoyées. L’horodatage est à la granularité de la seconde et est inclusif (c’est‑à‑dire que 12:00:01 inclut la première seconde de la minute).
path.end_time
str or None
défaut:"None"
YYYY-MM-DDTHH:mm:ssZ. L’horodatage UTC le plus récent jusqu’auquel les Publications seront renvoyées. L’horodatage est à la granularité de la seconde et est exclusif (c’est‑à‑dire que 12:00:01 exclut la première seconde de la minute).
path.since_id
Any or None
défaut:"None"
Renvoie des résultats avec un identifiant de Publication supérieur (c’est‑à‑dire plus récent) à l’identifiant spécifié.
path.until_id
Any or None
défaut:"None"
Renvoie des résultats avec un identifiant de Publication inférieur (c’est‑à‑dire plus ancien) à l’identifiant spécifié.
path.next_token
Any or None
défaut:"None"
Ce paramètre est utilisé pour obtenir la « page » suivante de résultats. La valeur utilisée avec le paramètre est extraite directement de la réponse fournie par l’API et ne doit pas être modifiée.
path.pagination_token
Any or None
défaut:"None"
Ce paramètre est utilisé pour obtenir la « page » suivante de résultats. La valeur utilisée avec le paramètre est extraite directement de la réponse fournie par l’API et ne doit pas être modifiée.
path.granularity
str or None
défaut:"None"
La granularité des résultats de comptage de recherche.
path.search_count_fields
List or None
défaut:"None"
Une liste de champs SearchCount séparés par des virgules à afficher.

Retourne

IteratorGetCountsAllResponse

get_counts_recent

Obtenir le nombre de Publications récentes Renvoie le nombre de Publications au cours des 7 derniers jours correspondant à une requête de recherche.

Paramètres

path.query
str
Une requête, règle ou filtre pour filtrer les Publications. Reportez-vous à https://t.co/rulelength pour connaître la longueur maximale de la requête.
path.start_time
str or None
défaut:"None"
YYYY-MM-DDTHH:mm:ssZ. L’horodatage UTC le plus ancien (parmi les 7 derniers jours) à partir duquel les Publications seront fournies. L’horodatage est indiqué à la seconde près et est inclusif (c’est-à-dire que 12:00:01 inclut la première seconde de la minute).
path.end_time
str or None
défaut:"None"
YYYY-MM-DDTHH:mm:ssZ. L’horodatage UTC le plus récent jusqu’auquel les Publications seront fournies. L’horodatage est indiqué à la seconde près et est exclusif (c’est-à-dire que 12:00:01 exclut la première seconde de la minute).
path.since_id
Any or None
défaut:"None"
Renvoie des résultats avec un ID de Publication supérieur (c’est-à-dire plus récent) à l’ID spécifié.
path.until_id
Any or None
défaut:"None"
Renvoie des résultats avec un ID de Publication inférieur (c’est-à-dire plus ancien) à l’ID spécifié.
path.next_token
Any or None
défaut:"None"
Ce paramètre est utilisé pour obtenir la « page » suivante de résultats. La valeur utilisée avec le paramètre est extraite directement de la réponse fournie par l’API et ne doit pas être modifiée.
path.pagination_token
Any or None
défaut:"None"
Ce paramètre est utilisé pour obtenir la « page » suivante de résultats. La valeur utilisée avec le paramètre est extraite directement de la réponse fournie par l’API et ne doit pas être modifiée.
path.granularity
str or None
défaut:"None"
La granularité appliquée aux résultats de comptage de recherche.
path.search_count_fields
List or None
défaut:"None"
Une liste, séparée par des virgules, de champs SearchCount à afficher.

Renvoie

IteratorGetCountsRecentResponse

get_insights28hr

Obtenir les insights de Publications sur 28 heures Récupère les métriques d’engagement pour les Publications spécifiées au cours des 28 dernières heures.

Paramètres

path.tweet_ids
List
Liste d’identifiants de Publications pour les métriques sur 28 h.
path.granularity
str
Granularité de la réponse des métriques.
path.requested_metrics
List
Métriques à récupérer pour la requête historique.
path.engagement_fields
List or None
défaut:"None"
Une liste de champs d’Engagement séparés par des virgules à afficher.

Renvoie

GetInsights28hrResponse - Données de la réponse

get_insights_historical

Obtenir les statistiques historiques des Publications Récupère les métriques d’engagement historiques pour des Publications spécifiées sur une période donnée.

Paramètres

path.tweet_ids
List
Liste de PostIds pour les métriques historiques.
path.end_time
str
YYYY-MM-DDTHH:mm:ssZ. Horodatage UTC représentant la fin de l’intervalle de temps.
path.start_time
str
YYYY-MM-DDTHH:mm:ssZ. Horodatage UTC représentant le début de l’intervalle de temps.
path.granularity
str
Granularité des métriques renvoyées.
path.requested_metrics
List
Métriques à calculer pour la requête historique.
path.engagement_fields
List or None
défaut:"None"
Liste de champs d’engagement, séparés par des virgules, à afficher.

Valeur de retour

GetInsightsHistoricalResponse - Données de la réponse

get_liking_users

Obtenir les utilisateurs ayant aimé Récupère la liste des utilisateurs qui ont aimé une Publication spécifique à partir de son id.

Paramètres

path.id
Any
Un ID de Publication unique.
path.max_results
int or None
défaut:"None"
Le nombre maximal de résultats.
path.pagination_token
Any or None
défaut:"None"
Ce paramètre permet d’obtenir la « page » suivante de résultats.
path.user_fields
List or None
défaut:"None"
Une liste de champs utilisateur, séparés par des virgules, à afficher.
path.expansions
List or None
défaut:"None"
Une liste de champs à développer, séparés par des virgules.
path.tweet_fields
List or None
défaut:"None"
Une liste de champs de Tweet, séparés par des virgules, à afficher.

Renvoie

IteratorGetLikingUsersResponse

get_quoted

Récupérer les publications citées Récupère la liste des publications qui citent une publication spécifique par son id.

Paramètres

path.id
Any
Un seul ID de Publication.
path.max_results
int or None
défaut:"None"
Le nombre maximal de résultats à renvoyer.
path.pagination_token
Any or None
défaut:"None"
Ce paramètre permet d’obtenir une « page » spécifique de résultats.
path.exclude
List or None
défaut:"None"
L’ensemble des entités à exclure (par exemple « replies » ou « retweets »).
path.tweet_fields
List or None
défaut:"None"
Une liste de champs de Tweet, séparés par des virgules, à afficher.
path.expansions
List or None
défaut:"None"
Une liste de champs à développer (expansions), séparés par des virgules.
path.media_fields
List or None
défaut:"None"
Une liste de champs de média, séparés par des virgules, à afficher.
path.poll_fields
List or None
défaut:"None"
Une liste de champs de sondage, séparés par des virgules, à afficher.
path.user_fields
List or None
défaut:"None"
Une liste de champs d’utilisateur, séparés par des virgules, à afficher.
path.place_fields
List or None
défaut:"None"
Une liste de champs de lieu, séparés par des virgules, à afficher.

Renvoie

IteratorGetQuotedResponse

get_reposted_by

Obtenir les utilisateurs ayant republiclié Récupère la liste des utilisateurs qui ont republiclié une Publication spécifique à partir de son identifiant.

Paramètres

path.id
Any
Un seul ID de Publication.
path.max_results
int or None
défaut:"None"
Le nombre maximal de résultats.
path.pagination_token
Any or None
défaut:"None"
Ce paramètre est utilisé pour obtenir la « page » suivante de résultats.
path.user_fields
List or None
défaut:"None"
Une liste de champs d’utilisateur séparés par des virgules à afficher.
path.expansions
List or None
défaut:"None"
Une liste de champs séparés par des virgules à étendre.
path.tweet_fields
List or None
défaut:"None"
Une liste de champs de Tweet séparés par des virgules à afficher.

Renvoie

IteratorGetRepostedByResponse

get_reposts

Obtenir les Reposts Récupère la liste des Publications qui repartagent une Publication spécifique à partir de son id.

Paramètres

path.id
Any
Un seul identifiant de Publication.
path.max_results
int or None
défaut:"None"
Le nombre maximal de résultats.
path.pagination_token
Any or None
défaut:"None"
Ce paramètre permet d’obtenir la « page » suivante de résultats.
path.tweet_fields
List or None
défaut:"None"
Une liste de champs de Tweet séparés par des virgules à afficher.
path.expansions
List or None
défaut:"None"
Une liste de champs à développer, séparés par des virgules.
path.media_fields
List or None
défaut:"None"
Une liste de champs de média séparés par des virgules à afficher.
path.poll_fields
List or None
défaut:"None"
Une liste de champs de sondage séparés par des virgules à afficher.
path.user_fields
List or None
défaut:"None"
Une liste de champs d’utilisateur séparés par des virgules à afficher.
path.place_fields
List or None
défaut:"None"
Une liste de champs de lieu séparés par des virgules à afficher.

Retourne

IteratorGetRepostsResponse

hide_reply

Masquer une réponse Masque ou rétablit l’affichage d’une réponse dans une conversation appartenant à l’utilisateur authentifié.

Paramètres

path.tweet_id
Any
L’identifiant de la réponse que vous souhaitez masquer ou réafficher.
body.body
HideReplyRequest
Corps de la requête

search_all

Rechercher dans toutes les Publications Récupère les Publications de l’archive complète qui correspondent à une requête de recherche.

Parameters

path.query
str
Une requête/règle/un filtre pour filtrer les Publications correspondantes. Reportez-vous à https://t.co/rulelength pour connaître la longueur maximale autorisée pour la requête.
path.start_time
str or None
défaut:"None"
YYYY-MM-DDTHH:mm:ssZ. L’horodatage UTC le plus ancien à partir duquel les Publications seront renvoyées. L’horodatage est exprimé avec une granularité à la seconde et il est inclusif (c.-à-d. 12:00:01 inclut la première seconde de la minute).
path.end_time
str or None
défaut:"None"
YYYY-MM-DDTHH:mm:ssZ. L’horodatage UTC le plus récent jusqu’auquel les Publications seront renvoyées. L’horodatage est exprimé avec une granularité à la seconde et il est exclusif (c.-à-d. 12:00:01 exclut la première seconde de la minute).
path.since_id
Any or None
défaut:"None"
Renvoie des résultats avec un ID de Publication supérieur (c’est-à-dire plus récent) à l’ID spécifié.
path.until_id
Any or None
défaut:"None"
Renvoie des résultats avec un ID de Publication inférieur (c’est-à-dire plus ancien) à l’ID spécifié.
path.max_results
int or None
défaut:"None"
Le nombre maximal de résultats de recherche à renvoyer par requête.
path.next_token
Any or None
défaut:"None"
Ce paramètre permet d’obtenir la « page » suivante de résultats. La valeur utilisée avec le paramètre est directement extraite de la réponse fournie par l’API et ne doit pas être modifiée.
path.pagination_token
Any or None
défaut:"None"
Ce paramètre permet d’obtenir la « page » suivante de résultats. La valeur utilisée avec le paramètre est directement extraite de la réponse fournie par l’API et ne doit pas être modifiée.
path.sort_order
str or None
défaut:"None"
L’ordre dans lequel renvoyer les résultats.
path.tweet_fields
List or None
défaut:"None"
Une liste, séparée par des virgules, de champs de Tweet à afficher.
path.expansions
List or None
défaut:"None"
Une liste, séparée par des virgules, de champs à étendre.
path.media_fields
List or None
défaut:"None"
Une liste, séparée par des virgules, de champs Media à afficher.
path.poll_fields
List or None
défaut:"None"
Une liste, séparée par des virgules, de champs Poll à afficher.
path.user_fields
List or None
défaut:"None"
Une liste, séparée par des virgules, de champs User à afficher.
path.place_fields
List or None
défaut:"None"
Une liste, séparée par des virgules, de champs Place à afficher.

Valeur de retour

IteratorSearchAllResponse

search_recent

Rechercher des Publications récentes Récupère les Publications des 7 derniers jours qui correspondent à une requête de recherche.

Paramètres

path.query
str
Une requête/règle/un filtre permettant de filtrer des Publications. Consultez https://t.co/rulelength pour connaître la longueur maximale autorisée d’une requête.
path.start_time
str or None
défaut:"None"
YYYY-MM-DDTHH:mm:ssZ. L’horodatage UTC le plus ancien à partir duquel les Publications seront renvoyées. L’horodatage est à une granularité à la seconde et est inclusif (c’est‑à‑dire qu’à 12:00:01, la première seconde de la minute est incluse).
path.end_time
str or None
défaut:"None"
YYYY-MM-DDTHH:mm:ssZ. L’horodatage UTC le plus récent jusqu’auquel les Publications seront renvoyées. L’horodatage est à une granularité à la seconde et est exclusif (c’est‑à‑dire qu’à 12:00:01, la première seconde de la minute est exclue).
path.since_id
Any or None
défaut:"None"
Renvoie des résultats avec un ID de Publication supérieur (c’est‑à‑dire plus récent) à l’ID spécifié.
path.until_id
Any or None
défaut:"None"
Renvoie des résultats avec un ID de Publication inférieur (c’est‑à‑dire plus ancien) à l’ID spécifié.
path.max_results
int or None
défaut:"None"
Le nombre maximal de résultats de recherche à renvoyer par une requête.
path.next_token
Any or None
défaut:"None"
Ce paramètre est utilisé pour obtenir la « page » suivante de résultats. La valeur utilisée avec le paramètre est extraite directement de la réponse fournie par l’API et ne doit pas être modifiée.
path.pagination_token
Any or None
défaut:"None"
Ce paramètre est utilisé pour obtenir la « page » suivante de résultats. La valeur utilisée avec le paramètre est extraite directement de la réponse fournie par l’API et ne doit pas être modifiée.
path.sort_order
str or None
défaut:"None"
L’ordre dans lequel renvoyer les résultats.
path.tweet_fields
List or None
défaut:"None"
Une liste de champs de Tweet séparés par des virgules à afficher.
path.expansions
List or None
défaut:"None"
Une liste de champs séparés par des virgules à étendre.
path.media_fields
List or None
défaut:"None"
Une liste de champs Media séparés par des virgules à afficher.
path.poll_fields
List or None
défaut:"None"
Une liste de champs de sondage séparés par des virgules à afficher.
path.user_fields
List or None
défaut:"None"
Une liste de champs d’utilisateur séparés par des virgules à afficher.
path.place_fields
List or None
défaut:"None"
Une liste de champs de lieu séparés par des virgules à afficher.

Renvoie

IteratorSearchRecentResponse