From 90cf7734f1ebdd73dfd5006ac4a73703514f2553 Mon Sep 17 00:00:00 2001 From: Harmon Date: Sat, 22 May 2021 08:03:13 -0500 Subject: [PATCH] Update and improve documentation for API.get_oembed --- tweepy/api.py | 98 ++++++++++++++++++++++++++++++--------------------- 1 file changed, 57 insertions(+), 41 deletions(-) diff --git a/tweepy/api.py b/tweepy/api.py index 72f5543..55ca047 100644 --- a/tweepy/api.py +++ b/tweepy/api.py @@ -675,49 +675,65 @@ class API: The Tweet fallback markup is meant to be cached on your servers for up to the suggested cache lifetime specified in the ``cache_age``. - :param url: The URL of the Tweet to be embedded - :param maxwidth: The maximum width of a rendered Tweet in whole pixels. - A supplied value under or over the allowed range will be returned - as the minimum or maximum supported width respectively; the reset - width value will be reflected in the returned ``width`` property. - Note that Twitter does not support the oEmbed ``maxheight`` - parameter. Tweets are fundamentally text, and are therefore of - unpredictable height that cannot be scaled like an image or video. - Relatedly, the oEmbed response will not provide a value for - ``height``. Implementations that need consistent heights for Tweets - should refer to the ``hide_thread`` and ``hide_media`` parameters - below. - :param hide_media: When set to ``true``, ``"t"``, or ``1``, links in a - Tweet are not expanded to photo, video, or link previews. - :param hide_thread: When set to ``true``, ``"t"``, or ``1``, a - collapsed version of the previous Tweet in a conversation thread - will not be displayed when the requested Tweet is in reply to - another Tweet. - :param omit_script: When set to ``true``, ``"t"``, or ``1``, the - ``