From 58ac8bb8083044f37c1999b61ecb763918d7a703 Mon Sep 17 00:00:00 2001 From: Harmon Date: Fri, 9 Apr 2021 13:52:19 -0500 Subject: [PATCH] Add API.get_profile_banner --- docs/api.rst | 2 ++ tweepy/api.py | 24 ++++++++++++++++++++++++ 2 files changed, 26 insertions(+) diff --git a/docs/api.rst b/docs/api.rst index 495333e..6faa869 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -152,6 +152,8 @@ Manage account settings and profile .. automethod:: API.get_saved_search +.. automethod:: API.get_profile_banner + Direct Message Methods ---------------------- diff --git a/tweepy/api.py b/tweepy/api.py index 936d549..3e495eb 100644 --- a/tweepy/api.py +++ b/tweepy/api.py @@ -1804,6 +1804,30 @@ class API: """ return self.request('GET', f'saved_searches/show/{id}', **kwargs) + @payload('json') + def get_profile_banner(self, **kwargs): + """get_profile_banner(*, user_id, screen_name) + + Returns a map of the available size variations of the specified user's + profile banner. If the user has not uploaded a profile banner, a HTTP + 404 will be served instead. + + The profile banner data available at each size variant's URL is in PNG + format. + + :param user_id: |user_id| + :param screen_name: |screen_name| + + :rtype: :class:`JSON` object + + :reference: https://developer.twitter.com/en/docs/twitter-api/v1/accounts-and-users/manage-account-settings/api-reference/get-users-profile_banner + """ + return self.request( + 'GET', 'users/profile_banner', endpoint_parameters=( + 'user_id', 'screen_name' + ), **kwargs + ) + def media_upload(self, filename, *, file=None, chunked=False, media_category=None, additional_owners=None, **kwargs): """ :reference: https://developer.twitter.com/en/docs/twitter-api/v1/media/upload-media/overview -- 2.25.1