diff --git a/discord/client.py b/discord/client.py index 008d44fe0..a3ebdf08f 100644 --- a/discord/client.py +++ b/discord/client.py @@ -861,6 +861,10 @@ class Client: Using this, you will only receive :attr:`Guild.owner`, :attr:`Guild.icon`, :attr:`Guild.id`, and :attr:`Guild.name` per :class:`Guild`. + .. note:: + + This method is an API call. For general usage, consider :attr:`guilds` instead. + All parameters are optional. Parameters @@ -912,6 +916,10 @@ class Client: Using this, you will not receive :attr:`Guild.channels`, :class:`Guild.members`, :attr:`Member.activity` and :attr:`Member.voice` per :class:`Member`. + .. note:: + + This method is an API call. For general usage, consider :meth:`get_guild` instead. + Parameters ----------- guild_id: :class:`int` @@ -1099,6 +1107,10 @@ class Client: with the user to get this information, however many operations do require that you do. + .. note:: + + This method is an API call. For general usage, consider :meth:`get_user` instead. + Parameters ----------- user_id: :class:`int` diff --git a/discord/guild.py b/discord/guild.py index 260d296ba..529828568 100644 --- a/discord/guild.py +++ b/discord/guild.py @@ -931,6 +931,10 @@ class Guild(Hashable): Retreives a :class:`Member` from a guild ID, and a member ID. + .. note:: + + This method is an API call. For general usage, consider :meth:`get_member` instead. + Parameters ----------- member_id: :class:`int` @@ -1149,6 +1153,10 @@ class Guild(Hashable): Retrieves all custom :class:`Emoji`\s from the guild. + .. note:: + + This method is an API call. For general usage, consider :attr:`emojis` instead. + Raises --------- HTTPException @@ -1167,6 +1175,11 @@ class Guild(Hashable): Retrieves a custom :class:`Emoji` from the guild. + .. note:: + + This method is an API call. + For general usage, consider iterating over :attr:`emojis` instead. + Parameters ------------- emoji_id: :class:`int`