messages.setGameScore
Use this method to set the score of the specified user in a game sent as a normal message (bots only).
func (c *Client) MessagesSetGameScore(ctx context.Context, request *MessagesSetGameScoreRequest) (UpdatesClass, error)
Calling this method
client.Run(ctx, func(ctx context.Context) error {
api := client.API()
res, err := api.MessagesSetGameScore(ctx, &tg.MessagesSetGameScoreRequest{
// see Parameters
})
if err != nil {
return err
}
_ = res // UpdatesClass
return nil
})
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
EditMessage | bool | — | Set this flag if the game message should be automatically edited to include the current scoreboard |
Force | bool | — | Set this flag if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters |
Peer | InputPeerClass | yes | Unique identifier of target chat |
ID | int | yes | Identifier of the sent message |
UserID | InputUserClass | yes | User identifier |
Score | int | yes | New score |
Returns
Possible errors
| Code | Type | Description |
|---|---|---|
| 400 | BOT_SCORE_NOT_MODIFIED | The score wasn't modified. |
| 400 | MESSAGE_ID_INVALID | The provided message id is invalid. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. |
| 400 | SCORE_INVALID | The specified game score is invalid. |
| 400 | USER_BOT_REQUIRED | This method can only be called by a bot. |
References
- Official documentation
- Generated Go reference
- TL definition:
messages.setGameScore#8ef8ecc0