telegram.ChatAdministratorRights

class telegram.ChatAdministratorRights(is_anonymous, can_manage_chat, can_delete_messages, can_manage_video_chats, can_restrict_members, can_promote_members, can_change_info, can_invite_users, can_post_messages=None, can_edit_messages=None, can_pin_messages=None, **_kwargs)

Bases: telegram.base.TelegramObject

Represents the rights of an administrator in a chat. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their is_anonymous, can_manage_chat, can_delete_messages, can_manage_video_chats, can_restrict_members, can_promote_members, can_change_info, can_invite_users, can_post_messages, can_edit_messages, can_pin_messages are equal.

New in version 13.12.

Parameters
  • is_anonymous (bool) – True, if the user’s presence in the chat is hidden.

  • can_manage_chat (bool) – True, if the administrator can access the chat event log, chat statistics, message statistics in channels, see channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other administrator privilege.

  • can_delete_messages (bool) – True, if the administrator can delete messages of other users.

  • can_manage_video_chats (bool) – True, if the administrator can manage video chats.

  • can_restrict_members (bool) – True, if the administrator can restrict, ban or unban chat members.

  • can_promote_members (bool) – True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by the user.)

  • can_change_info (bool) – True, if the user is allowed to change the chat title , photo and other settings.

  • can_invite_users (bool) – True, if the user is allowed to invite new users to the chat.

  • can_post_messages (bool, optional) – True, if the administrator can post messages in the channel; channels only.

  • can_edit_messages (bool, optional) – True, if the administrator can edit messages of other users.

  • can_pin_messages (bool, optional) – True, if the user is allowed to pin messages; groups and supergroups only.

is_anonymous

True, if the user’s presence in the chat is hidden.

Type

bool

can_manage_chat

True, if the administrator can access the chat event log, chat statistics, message statistics in channels, see channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other administrator privilege.

Type

bool

can_delete_messages

True, if the administrator can delete messages of other users.

Type

bool

can_manage_video_chats

True, if the administrator can manage video chats.

Type

bool

can_restrict_members

True, if the administrator can restrict, ban or unban chat members.

Type

bool

can_promote_members

True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by the user.)

Type

bool

can_change_info

True, if the user is allowed to change the chat title ,photo and other settings.

Type

bool

can_invite_users

True, if the user is allowed to invite new users to the chat.

Type

bool

can_post_messages

Optional. True, if the administrator can post messages in the channel; channels only.

Type

bool

can_edit_messages

Optional. True, if the administrator can edit messages of other users.

Type

bool

can_pin_messages

Optional. True, if the user is allowed to pin messages; groups and supergroups only.

Type

bool

classmethod all_rights()

This method returns the ChatAdministratorRights object with all attributes set to True. This is e.g. useful when changing the bot’s default administrator rights with telegram.Bot.set_my_default_administrator_rights().

classmethod no_rights()

This method returns the ChatAdministratorRights object with all attributes set to False.