SetGameScoreRequest
Only bots can use this request. See code examples.
---functions--- messages.setGameScore#8ef8ecc0 flags:# edit_message:flags.0?true force:flags.1?true peer:InputPeer id:int user_id:InputUser score:int = Updates
Returns
| Updates |
This type can be an instance of either:
| UpdateShort | UpdateShortChatMessage |
| UpdateShortMessage | UpdateShortSentMessage |
| Updates | UpdatesCombined |
| UpdatesTooLong |
Parameters
| peer | InputPeer | Anything entity-like will work if the library can find its Input version (e.g., usernames, Peer, User or Channel objects, etc.). |
| id | int | |
| user_id | InputUser | Anything entity-like will work if the library can find its Input version (e.g., usernames, Peer, User or Channel objects, etc.). |
| score | int | |
| edit_message | flag | This argument defaults to None and can be omitted. |
| force | flag | This argument defaults to None and can be omitted. |
Known RPC errors
This request can cause 2 known errors:
PeerIdInvalidError | An invalid Peer was used. Make sure to pass the right peer type and that the value is valid (for instance, bots cannot start conversations). |
UserBotRequiredError | This method can only be called by a bot. |
You can import these from telethon.errors.
Example
from telethon.sync import TelegramClient
from telethon import functions, types
with TelegramClient(name, api_id, api_hash) as client:
result = client(functions.messages.SetGameScoreRequest(
peer='username',
id=42,
user_id='username',
score=42,
edit_message=True,
force=True
))
print(result.stringify())