Files
mautrix-telegram/pkg/gotd/tg/tl_messages_upload_media_gen.go
T
2025-12-03 17:11:20 +02:00

329 lines
9.7 KiB
Go
Generated

// Code generated by gotdgen, DO NOT EDIT.
package tg
import (
"context"
"errors"
"fmt"
"sort"
"strings"
"go.uber.org/multierr"
"go.mau.fi/mautrix-telegram/pkg/gotd/bin"
"go.mau.fi/mautrix-telegram/pkg/gotd/tdjson"
"go.mau.fi/mautrix-telegram/pkg/gotd/tdp"
"go.mau.fi/mautrix-telegram/pkg/gotd/tgerr"
)
// No-op definition for keeping imports.
var (
_ = bin.Buffer{}
_ = context.Background()
_ = fmt.Stringer(nil)
_ = strings.Builder{}
_ = errors.Is
_ = multierr.AppendInto
_ = sort.Ints
_ = tdp.Format
_ = tgerr.Error{}
_ = tdjson.Encoder{}
)
// MessagesUploadMediaRequest represents TL type `messages.uploadMedia#14967978`.
// Upload a file and associate it to a chat (without actually sending it to the chat)
// May also be used in a business connection¹, not by wrapping the query in
// invokeWithBusinessConnection »², but rather by specifying the business connection ID
// in the business_connection_id parameter.
//
// Links:
// 1. https://core.telegram.org/api/bots/connected-business-bots
// 2. https://core.telegram.org/method/invokeWithBusinessConnection
//
// See https://core.telegram.org/method/messages.uploadMedia for reference.
type MessagesUploadMediaRequest struct {
// Flags, see TL conditional fields¹
//
// Links:
// 1) https://core.telegram.org/mtproto/TL-combinators#conditional-fields
Flags bin.Fields
// Whether the media will be used only in the specified business connection »¹, and not
// directly by the bot.
//
// Links:
// 1) https://core.telegram.org/api/bots/connected-business-bots
//
// Use SetBusinessConnectionID and GetBusinessConnectionID helpers.
BusinessConnectionID string
// The chat, can be inputPeerEmpty¹ for bots and inputPeerSelf² for users.
//
// Links:
// 1) https://core.telegram.org/constructor/inputPeerEmpty
// 2) https://core.telegram.org/constructor/inputPeerSelf
Peer InputPeerClass
// File uploaded in chunks as described in files »¹
//
// Links:
// 1) https://core.telegram.org/api/files
Media InputMediaClass
}
// MessagesUploadMediaRequestTypeID is TL type id of MessagesUploadMediaRequest.
const MessagesUploadMediaRequestTypeID = 0x14967978
// Ensuring interfaces in compile-time for MessagesUploadMediaRequest.
var (
_ bin.Encoder = &MessagesUploadMediaRequest{}
_ bin.Decoder = &MessagesUploadMediaRequest{}
_ bin.BareEncoder = &MessagesUploadMediaRequest{}
_ bin.BareDecoder = &MessagesUploadMediaRequest{}
)
func (u *MessagesUploadMediaRequest) Zero() bool {
if u == nil {
return true
}
if !(u.Flags.Zero()) {
return false
}
if !(u.BusinessConnectionID == "") {
return false
}
if !(u.Peer == nil) {
return false
}
if !(u.Media == nil) {
return false
}
return true
}
// String implements fmt.Stringer.
func (u *MessagesUploadMediaRequest) String() string {
if u == nil {
return "MessagesUploadMediaRequest(nil)"
}
type Alias MessagesUploadMediaRequest
return fmt.Sprintf("MessagesUploadMediaRequest%+v", Alias(*u))
}
// FillFrom fills MessagesUploadMediaRequest from given interface.
func (u *MessagesUploadMediaRequest) FillFrom(from interface {
GetBusinessConnectionID() (value string, ok bool)
GetPeer() (value InputPeerClass)
GetMedia() (value InputMediaClass)
}) {
if val, ok := from.GetBusinessConnectionID(); ok {
u.BusinessConnectionID = val
}
u.Peer = from.GetPeer()
u.Media = from.GetMedia()
}
// TypeID returns type id in TL schema.
//
// See https://core.telegram.org/mtproto/TL-tl#remarks.
func (*MessagesUploadMediaRequest) TypeID() uint32 {
return MessagesUploadMediaRequestTypeID
}
// TypeName returns name of type in TL schema.
func (*MessagesUploadMediaRequest) TypeName() string {
return "messages.uploadMedia"
}
// TypeInfo returns info about TL type.
func (u *MessagesUploadMediaRequest) TypeInfo() tdp.Type {
typ := tdp.Type{
Name: "messages.uploadMedia",
ID: MessagesUploadMediaRequestTypeID,
}
if u == nil {
typ.Null = true
return typ
}
typ.Fields = []tdp.Field{
{
Name: "BusinessConnectionID",
SchemaName: "business_connection_id",
Null: !u.Flags.Has(0),
},
{
Name: "Peer",
SchemaName: "peer",
},
{
Name: "Media",
SchemaName: "media",
},
}
return typ
}
// SetFlags sets flags for non-zero fields.
func (u *MessagesUploadMediaRequest) SetFlags() {
if !(u.BusinessConnectionID == "") {
u.Flags.Set(0)
}
}
// Encode implements bin.Encoder.
func (u *MessagesUploadMediaRequest) Encode(b *bin.Buffer) error {
if u == nil {
return fmt.Errorf("can't encode messages.uploadMedia#14967978 as nil")
}
b.PutID(MessagesUploadMediaRequestTypeID)
return u.EncodeBare(b)
}
// EncodeBare implements bin.BareEncoder.
func (u *MessagesUploadMediaRequest) EncodeBare(b *bin.Buffer) error {
if u == nil {
return fmt.Errorf("can't encode messages.uploadMedia#14967978 as nil")
}
u.SetFlags()
if err := u.Flags.Encode(b); err != nil {
return fmt.Errorf("unable to encode messages.uploadMedia#14967978: field flags: %w", err)
}
if u.Flags.Has(0) {
b.PutString(u.BusinessConnectionID)
}
if u.Peer == nil {
return fmt.Errorf("unable to encode messages.uploadMedia#14967978: field peer is nil")
}
if err := u.Peer.Encode(b); err != nil {
return fmt.Errorf("unable to encode messages.uploadMedia#14967978: field peer: %w", err)
}
if u.Media == nil {
return fmt.Errorf("unable to encode messages.uploadMedia#14967978: field media is nil")
}
if err := u.Media.Encode(b); err != nil {
return fmt.Errorf("unable to encode messages.uploadMedia#14967978: field media: %w", err)
}
return nil
}
// Decode implements bin.Decoder.
func (u *MessagesUploadMediaRequest) Decode(b *bin.Buffer) error {
if u == nil {
return fmt.Errorf("can't decode messages.uploadMedia#14967978 to nil")
}
if err := b.ConsumeID(MessagesUploadMediaRequestTypeID); err != nil {
return fmt.Errorf("unable to decode messages.uploadMedia#14967978: %w", err)
}
return u.DecodeBare(b)
}
// DecodeBare implements bin.BareDecoder.
func (u *MessagesUploadMediaRequest) DecodeBare(b *bin.Buffer) error {
if u == nil {
return fmt.Errorf("can't decode messages.uploadMedia#14967978 to nil")
}
{
if err := u.Flags.Decode(b); err != nil {
return fmt.Errorf("unable to decode messages.uploadMedia#14967978: field flags: %w", err)
}
}
if u.Flags.Has(0) {
value, err := b.String()
if err != nil {
return fmt.Errorf("unable to decode messages.uploadMedia#14967978: field business_connection_id: %w", err)
}
u.BusinessConnectionID = value
}
{
value, err := DecodeInputPeer(b)
if err != nil {
return fmt.Errorf("unable to decode messages.uploadMedia#14967978: field peer: %w", err)
}
u.Peer = value
}
{
value, err := DecodeInputMedia(b)
if err != nil {
return fmt.Errorf("unable to decode messages.uploadMedia#14967978: field media: %w", err)
}
u.Media = value
}
return nil
}
// SetBusinessConnectionID sets value of BusinessConnectionID conditional field.
func (u *MessagesUploadMediaRequest) SetBusinessConnectionID(value string) {
u.Flags.Set(0)
u.BusinessConnectionID = value
}
// GetBusinessConnectionID returns value of BusinessConnectionID conditional field and
// boolean which is true if field was set.
func (u *MessagesUploadMediaRequest) GetBusinessConnectionID() (value string, ok bool) {
if u == nil {
return
}
if !u.Flags.Has(0) {
return value, false
}
return u.BusinessConnectionID, true
}
// GetPeer returns value of Peer field.
func (u *MessagesUploadMediaRequest) GetPeer() (value InputPeerClass) {
if u == nil {
return
}
return u.Peer
}
// GetMedia returns value of Media field.
func (u *MessagesUploadMediaRequest) GetMedia() (value InputMediaClass) {
if u == nil {
return
}
return u.Media
}
// MessagesUploadMedia invokes method messages.uploadMedia#14967978 returning error if any.
// Upload a file and associate it to a chat (without actually sending it to the chat)
// May also be used in a business connection¹, not by wrapping the query in
// invokeWithBusinessConnection »², but rather by specifying the business connection ID
// in the business_connection_id parameter.
//
// Links:
// 1. https://core.telegram.org/api/bots/connected-business-bots
// 2. https://core.telegram.org/method/invokeWithBusinessConnection
//
// Possible errors:
//
// 400 CHANNEL_INVALID: The provided channel is invalid.
// 400 CHANNEL_PRIVATE: You haven't joined this channel/supergroup.
// 400 CHAT_ADMIN_REQUIRED: You must be an admin in this chat to do this.
// 400 CHAT_ID_INVALID: The provided chat id is invalid.
// 400 CHAT_RESTRICTED: You can't send messages in this chat, you were restricted.
// 403 CHAT_WRITE_FORBIDDEN: You can't write in this chat.
// 400 FILE_PARTS_INVALID: The number of file parts is invalid.
// 400 FILE_PART_LENGTH_INVALID: The length of a file part is invalid.
// 400 IMAGE_PROCESS_FAILED: Failure while processing image.
// 400 INPUT_USER_DEACTIVATED: The specified user was deleted.
// 400 MEDIA_INVALID: Media invalid.
// 400 MSG_ID_INVALID: Invalid message ID provided.
// 400 PEER_ID_INVALID: The provided peer id is invalid.
// 400 PHOTO_EXT_INVALID: The extension of the photo is invalid.
// 400 PHOTO_INVALID_DIMENSIONS: The photo dimensions are invalid.
// 400 PHOTO_SAVE_FILE_INVALID: Internal issues, try again later.
// 400 USER_BANNED_IN_CHANNEL: You're banned from sending messages in supergroups/channels.
// 400 VOICE_MESSAGES_FORBIDDEN: This user's privacy settings forbid you from sending voice messages.
// 400 WEBPAGE_CURL_FAILED: Failure while fetching the webpage with cURL.
//
// See https://core.telegram.org/method/messages.uploadMedia for reference.
func (c *Client) MessagesUploadMedia(ctx context.Context, request *MessagesUploadMediaRequest) (MessageMediaClass, error) {
var result MessageMediaBox
if err := c.rpc.Invoke(ctx, request, &result); err != nil {
return nil, err
}
return result.MessageMedia, nil
}