mirror of
https://github.com/LonamiWebs/Telethon.git
synced 2024-11-25 19:03:46 +03:00
44 lines
7.1 KiB
HTML
44 lines
7.1 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
<title>EditAdminRequest</title>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<link id="style" href="../../css/docs.dark.css" rel="stylesheet">
|
|
<script>
|
|
document.getElementById("style").href = "../../css/docs."
|
|
+ (localStorage.getItem("theme") || "light")
|
|
+ ".css";
|
|
</script>
|
|
<link href="https://fonts.googleapis.com/css?family=Nunito|Source+Code+Pro"
|
|
rel="stylesheet">
|
|
</head>
|
|
<body>
|
|
<div id="main_div"><ul class="horizontal"><li><a href="../../index.html">API</a></li><img src="../../img/arrow.svg" alt="/" /><li><a href="../index.html">Methods</a></li><img src="../../img/arrow.svg" alt="/" /><li><a href="index.html">Channels</a></li><img src="../../img/arrow.svg" alt="/" /><li><a href="edit_admin.html">EditAdminRequest</a></li></ul><h1>EditAdminRequest</h1><p><strong>Both users and bots</strong> can use this request. <a href="#examples">See code examples.</a></p><pre>---functions---
|
|
channels.editAdmin#d33c8902 channel:<a href="../../types/input_channel.html">InputChannel</a> user_id:<a href="../../types/input_user.html">InputUser</a> admin_rights:<a href="../../types/chat_admin_rights.html">ChatAdminRights</a> rank:<a href="../../index.html#string">string</a> = <a href="../../types/updates.html">Updates</a></pre><button onclick="cp('from telethon.tl.functions.channels import EditAdminRequest');">Copy import to the clipboard</button><h3>Returns</h3><table><tr><td><a href="../../types/updates.html">Updates</a></td></tr></table><p>This type can be an instance of either:</p><table><tr><td><a href="../../constructors/update_short.html">UpdateShort</a></td><td><a href="../../constructors/update_short_chat_message.html">UpdateShortChatMessage</a></td></tr><tr><td><a href="../../constructors/update_short_message.html">UpdateShortMessage</a></td><td><a href="../../constructors/update_short_sent_message.html">UpdateShortSentMessage</a></td></tr><tr><td><a href="../../constructors/updates.html">Updates</a></td><td><a href="../../constructors/updates_combined.html">UpdatesCombined</a></td></tr><tr><td><a href="../../constructors/updates_too_long.html">UpdatesTooLong</a></td></tr></table><h3>Parameters</h3><table><tr><td><b>channel</b></td><td style="text-align:center"><a href="../../types/input_channel.html">InputChannel</a></td><td>Anything entity-like will work if the library can find its <code>Input</code> version (e.g., usernames, <code>Peer</code>, <code>User</code> or <code>Channel</code> objects, etc.).</td></tr><tr><td><b>user_id</b></td><td style="text-align:center"><a href="../../types/input_user.html">InputUser</a></td><td>Anything entity-like will work if the library can find its <code>Input</code> version (e.g., usernames, <code>Peer</code>, <code>User</code> or <code>Channel</code> objects, etc.).</td></tr><tr><td><b>admin_rights</b></td><td style="text-align:center"><a href="../../types/chat_admin_rights.html">ChatAdminRights</a></td><td></td></tr><tr><td><b>rank</b></td><td style="text-align:center"><a href="../../index.html#string">string</a></td><td></td></tr></table><h1>Known RPC errors</h1><p>This request can cause 13 known errors:</p><table><tr><td><code>AdminsTooMuchError</code></td><td>Too many admins.</td></tr><tr><td><code>AdminRankEmojiNotAllowedError</code></td><td>Emoji are not allowed in admin titles or ranks.</td></tr><tr><td><code>AdminRankInvalidError</code></td><td>The given admin title or rank was invalid (possibly larger than 16 characters).</td></tr><tr><td><code>BotChannelsNaError</code></td><td>Bots can't edit admin privileges.</td></tr><tr><td><code>ChannelInvalidError</code></td><td>Invalid channel object. Make sure to pass the right types, for instance making sure that the request is designed for channels or otherwise look for a different one more suited.</td></tr><tr><td><code>ChatAdminInviteRequiredError</code></td><td>You do not have the rights to do this.</td></tr><tr><td><code>ChatAdminRequiredError</code></td><td>Chat admin privileges are required to do that in the specified chat (for example, to send a message in a channel which is not yours), or invalid permissions used for the channel or group.</td></tr><tr><td><code>FreshChangeAdminsForbiddenError</code></td><td>Recently logged-in users cannot add or change admins.</td></tr><tr><td><code>RightForbiddenError</code></td><td>Either your admin rights do not allow you to do this or you passed the wrong rights combination (some rights only apply to channels and vice versa).</td></tr><tr><td><code>UserCreatorError</code></td><td>You can't leave this channel, because you're its creator.</td></tr><tr><td><code>UserIdInvalidError</code></td><td>Invalid object ID for a user. Make sure to pass the right types, for instance making sure that the request is designed for users or otherwise look for a different one more suited.</td></tr><tr><td><code>UserNotMutualContactError</code></td><td>The provided user is not a mutual contact.</td></tr><tr><td><code>UserPrivacyRestrictedError</code></td><td>The user's privacy settings do not allow you to do this.</td></tr></table><p>You can import these from <code>telethon.errors</code>.</p><h1 id="examples">Example</h1><p>Please refer to the documentation of <a href="https://docs.telethon.dev/en/stable/modules/client.html#telethon.client.chats.ChatMethods.edit_admin"><code>client.edit_admin()</code></a> to learn about the parameters and see several code examples on how to use it.</p><p>The method above is the recommended way to do it. If you need more control over the parameters or want to learn how it is implemented, open the details by clicking on the "Details" text.</p><details><pre><strong>from</strong> telethon.sync <strong>import</strong> TelegramClient
|
|
<strong>from</strong> telethon <strong>import</strong> functions, types
|
|
|
|
<strong>with</strong> TelegramClient(name, api_id, api_hash) <strong>as</strong> client:
|
|
result = client(functions.channels.EditAdminRequest(
|
|
channel=<em>'username'</em>,
|
|
user_id=<em>'username'</em>,
|
|
admin_rights=types.ChatAdminRights(
|
|
change_info=<strong>True</strong>,
|
|
post_messages=<strong>True</strong>,
|
|
edit_messages=<strong>True</strong>,
|
|
delete_messages=<strong>True</strong>,
|
|
ban_users=<strong>True</strong>,
|
|
invite_users=<strong>True</strong>,
|
|
pin_messages=<strong>True</strong>,
|
|
add_admins=<strong>True</strong>,
|
|
anonymous=<strong>True</strong>,
|
|
manage_call=<strong>True</strong>,
|
|
other=<strong>True</strong>,
|
|
manage_topics=<strong>True</strong>,
|
|
post_stories=<strong>True</strong>,
|
|
edit_stories=<strong>True</strong>,
|
|
delete_stories=<strong>True</strong>
|
|
),
|
|
rank=<em>'some string here'</em>
|
|
))
|
|
print(result.stringify())</pre></details><textarea id="c" class="invisible"></textarea><script>function cp(t){var c=document.getElementById("c");c.value=t;c.select();try{document.execCommand("copy")}catch(e){}}</script></div><script>prependPath = "../../";</script><script src="../../js/search.js"></script></body></html> |