aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--discord/client.py12
-rw-r--r--discord/guild.py13
2 files changed, 25 insertions, 0 deletions
diff --git a/discord/client.py b/discord/client.py
index 008d44fe..a3ebdf08 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 260d296b..52982856 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`