From: Qin Yu Date: Fri, 11 Nov 2022 21:55:49 +0000 (+0100) Subject: Update expansions section in docs/expansions_and_fields.rst X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=b9b913b1675ac8e1b0a316c2e31f4e3c833cf680;p=tweepy.git Update expansions section in docs/expansions_and_fields.rst The term "___ object" is used in a natural language context, and Twitter's official documents do use lower cases for "user" and "event". Also, indeed, query parameters' descriptions in all three Direct Messages lookup API references ([1](https://developer.twitter.com/en/docs/twitter-api/direct-messages/lookup/api-reference/get-dm_events) [2](https://developer.twitter.com/en/docs/twitter-api/direct-messages/lookup/api-reference/get-dm_conversations-with-participant_id-dm_events) [3](https://developer.twitter.com/en/docs/twitter-api/direct-messages/lookup/api-reference/get-dm_conversations-dm_conversation_id-dm_events)) use the term "Direct Message conversation event", though in the informal abstract/intro sections they use "Direct Messages (DM) events", "Direct Messages" and "Messages" interchangeably. Co-authored-by: Harmon --- diff --git a/docs/expansions_and_fields.rst b/docs/expansions_and_fields.rst index d71b761..3eb19d1 100644 --- a/docs/expansions_and_fields.rst +++ b/docs/expansions_and_fields.rst @@ -8,13 +8,13 @@ Expansions and Fields ``expansions`` -------------- `Expansions`_ enable you to request additional data objects that relate to the -originally returned List, Space, Tweets, Users, or DirectMessageEvents. Submit -a list of desired expansions in a comma-separated list without spaces. The ID -that represents the expanded data object will be included directly in the List, -Space, Tweet, User, or DirectMessageEvents data object, but the expanded object -metadata will be returned within the ``includes`` response object, and will -also include the ID so that you can match this data object to the original -Space, Tweet, User or DirectMessageEvents object. +originally returned List, Space, Tweets, Users, or Direct Message conversation +events. Submit a list of desired expansions in a comma-separated list without +spaces. The ID(s) that represent(s) the expanded data object(s) will be +included directly in the List, Space, Tweet, user, or event data object, but +the expanded object metadata will be returned within the ``includes`` response +object, and will also include the ID so that you can match this data object to +the original Space, Tweet, User or Direct Message conversation event object. At this time, the only expansion available to endpoints that primarily return List objects is ``expansions=owner_id``. You will find the expanded user data