From 1c68f5b031104c8f43d0831c1fbe573a3ca26cf1 Mon Sep 17 00:00:00 2001 From: GitHub Action Date: Sun, 21 Nov 2021 12:20:27 +0000 Subject: [PATCH] Update content of files --- .../api/sponsored-messages.html | 136 ++++++++++++++++ data/corefork.telegram.org/methods.html | 149 +++++++++--------- 2 files changed, 211 insertions(+), 74 deletions(-) create mode 100644 data/corefork.telegram.org/api/sponsored-messages.html diff --git a/data/corefork.telegram.org/api/sponsored-messages.html b/data/corefork.telegram.org/api/sponsored-messages.html new file mode 100644 index 0000000000..c618f547b5 --- /dev/null +++ b/data/corefork.telegram.org/api/sponsored-messages.html @@ -0,0 +1,136 @@ + + + + + Sponsored messages + + + + + + + + + + + + + +
+
+
+
+ + +
+
+
+
+
+
+
+

Sponsored messages

+ +

Related TL schema:

+
sponsoredMessage flags:# random_id:bytes from_id:Peer channel_post:flags.2?int start_param:flags.0?string message:string entities:flags.1?Vector<MessageEntity> = SponsoredMessage;
+messages.sponsoredMessages messages:Vector<SponsoredMessage> chats:Vector<Chat> users:Vector<User> = messages.SponsoredMessages;
+
+---functions---
+
+channels.getSponsoredMessages channel:InputChannel = messages.SponsoredMessages;
+channels.viewSponsoredMessage channel:InputChannel random_id:bytes = Bool;
+

Getting sponsored messages

+

Each time the user opens a channel, channels.getSponsoredMessages should be called to receive sponsored messages available for this channel. The result should be cached for 5 minutes.

+

Displaying sponsored messages

+

Sponsored messages are displayed below all posts of the channel under the scroll. Promoted channel or bot specified in the from_id field is displayed as the author of the message. The message should also contain one of these buttons at the bottom:

+
    +
  • View Bot, if the bot is promoted. The bot should be opened when the user taps this button. If start_param specified you should use deep linking mechanism to open the bot.
    • +
  • View Channel, if the channel is promoted. The channel should be opened when the user taps this button.
    • +
  • View Post, if the channel is promoted and channel_post specified. The channel post should be opened when the user taps this button.
    • +
+

Accounting for sponsored message views

+

Once the entire text is shown on the screen (excluding the button), channels.viewSponsoredMessage should be called with the random_id of this sponsored message.

+
+ +
+ +
+
+
+
+
+
Telegram
+
+ Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed. +
+ +
+
About
+ +
+
+
Mobile Apps
+ +
+
+
Desktop Apps
+ +
+
+
Platform
+ +
+
+
+
+
About
+
+
+
Blog
+
+
+
Apps
+
+
+
Platform
+
+
+
Twitter
+
+
+
+
+ + + + + + diff --git a/data/corefork.telegram.org/methods.html b/data/corefork.telegram.org/methods.html index ccee2697c7..060a572a84 100644 --- a/data/corefork.telegram.org/methods.html +++ b/data/corefork.telegram.org/methods.html @@ -39,7 +39,7 @@

Methods

-

Accepting the Terms of Service

+

Accepting the Terms of Service

@@ -50,7 +50,7 @@ - + @@ -58,7 +58,7 @@
help.getTermsOfServiceUpdateLook for updates of telegram's terms of serviceLook for updates of telegram's terms of service
help.acceptTermsOfService
-

Dealing with spam and ToS violations

+

Dealing with spam and ToS violations

@@ -69,7 +69,7 @@ - + @@ -81,7 +81,7 @@ - + @@ -93,7 +93,7 @@
account.reportPeerReport a peer for violation of telegram's Terms of ServiceReport a peer for violation of telegram's Terms of Service
account.reportProfilePhoto
messages.reportReport a message in a chat for violation of telegram's Terms of ServiceReport a message in a chat for violation of telegram's Terms of Service
messages.reportSpam
-

Fetching configuration

+

Fetching configuration

@@ -104,7 +104,7 @@ - + @@ -128,7 +128,7 @@ - + @@ -144,7 +144,7 @@
help.getAppChangelogGet changelog of current app.
Typically, an updates constructor will be returned, containing one or more updateServiceNotification updates with app-specific changelogs.		Get changelog of current app.
Typically, an updates constructor will be returned, containing one or more updateServiceNotification updates with app-specific changelogs.
help.getAppConfig
help.getSupportReturns the support user for the 'ask a question' feature.Returns the support user for the 'ask a question' feature.
help.getSupportName
-

Login via QR code

+

Login via QR code

@@ -155,7 +155,7 @@ - + @@ -167,7 +167,7 @@
auth.exportLoginTokenGenerate a login token, for login via QR code.
The generated login token should be encoded using base64url, then shown as a tg://login?token=base64encodedtoken URL in the QR code.

For more info, see login via QR code.		Generate a login token, for login via QR code.
The generated login token should be encoded using base64url, then shown as a tg://login?token=base64encodedtoken URL in the QR code.

For more info, see login via QR code.
auth.acceptLoginToken
-

Miscellaneous

+

Miscellaneous

@@ -202,7 +202,7 @@
-

Registration/Authorization

+

Registration/Authorization

@@ -265,7 +265,7 @@ - + @@ -281,7 +281,7 @@
auth.resetAuthorizationsTerminates all user's authorized sessions except for the current one.

After calling this method it is necessary to reregister the current device using the method account.registerDevice		Terminates all user's authorized sessions except for the current one.

After calling this method it is necessary to reregister the current device using the method account.registerDevice
auth.sendCode
-

Working with GDPR export

+

Working with GDPR export

@@ -300,7 +300,7 @@ - + @@ -316,7 +316,7 @@
messages.getSplitRangesGet message ranges for saving the user's chat historyGet message ranges for saving the user's chat history
channels.getLeftChannels
-

Working with GIFs (actually MPEG4 GIFs)

+

Working with GIFs (actually MPEG4 GIFs)

@@ -339,7 +339,7 @@
-

Working with Public Service Announcement and MTProxy channels

+

Working with Public Service Announcement and MTProxy channels

@@ -358,7 +358,7 @@
-

Working with TSF (internal use only)

+

Working with TSF (internal use only)

@@ -377,7 +377,7 @@
-

Working with 2FA login

+

Working with 2FA login

@@ -416,7 +416,7 @@
-

Working with Seamless Telegram Login

+

Working with Seamless Telegram Login

@@ -447,7 +447,7 @@
-

Working with VoIP calls

+

Working with VoIP calls

@@ -470,7 +470,7 @@ - + @@ -498,7 +498,7 @@
phone.getCallConfigGet phone call configuration to be passed to libtgvoip's shared configGet phone call configuration to be passed to libtgvoip's shared config
phone.receivedCall
-

Working with channels/supergroups/geogroups

+

Working with channels/supergroups/geogroups

@@ -565,7 +565,7 @@ - + @@ -577,7 +577,7 @@ - + @@ -633,7 +633,7 @@
channels.getAdminedPublicChannelsGet channels/supergroups/geogroups we're admin in. Usually called when the user exceeds the limit for owned public channels/supergroups/geogroups, and the user is given the choice to remove one of his channels/supergroups/geogroups.Get channels/supergroups/geogroups we're admin in. Usually called when the user exceeds the limit for owned public channels/supergroups/geogroups, and the user is given the choice to remove one of his channels/supergroups/geogroups.
channels.getChannels
channels.getGroupsForDiscussionGet all groups that can be used as discussion groups.

Returned legacy group chats must be first upgraded to supergroups before they can be set as a discussion group.
To set a returned supergroup as a discussion group, access to its old messages must be enabled using channels.togglePreHistoryHidden, first.		Get all groups that can be used as discussion groups.

Returned legacy group chats must be first upgraded to supergroups before they can be set as a discussion group.
To set a returned supergroup as a discussion group, access to its old messages must be enabled using channels.togglePreHistoryHidden, first.
channels.getMessages
-

Working with chats/supergroups/channels

+

Working with chats/supergroups/channels

@@ -748,7 +748,7 @@
-

Working with deep links

+

Working with deep links

@@ -771,7 +771,7 @@
-

Working with files

+

Working with files

@@ -830,7 +830,7 @@
-

Working with instant view pages

+

Working with instant view pages

@@ -849,7 +849,7 @@
-

Working with secret chats

+

Working with secret chats

@@ -900,7 +900,7 @@
-

Working with telegram passport

+

Working with telegram passport

@@ -959,11 +959,11 @@ - +
users.setSecureValueErrorsNotify the user that the sent passport data contains some errors The user will not be able to re-submit their Passport data to you until the errors are fixed (the contents of the field for which you returned the error must change).

Use this if the data submitted by the user doesn't satisfy the standards your service requires for any reason. For example, if a birthday date seems invalid, a submitted document is blurry, a scan shows evidence of tampering, etc. Supply some details in the error message to make sure the user knows how to correct the issues.		Notify the user that the sent passport data contains some errors The user will not be able to re-submit their Passport data to you until the errors are fixed (the contents of the field for which you returned the error must change).

Use this if the data submitted by the user doesn't satisfy the standards your service requires for any reason. For example, if a birthday date seems invalid, a submitted document is blurry, a scan shows evidence of tampering, etc. Supply some details in the error message to make sure the user knows how to correct the issues.
-

Working with updates

+

Working with updates

@@ -986,7 +986,7 @@
-

Working with bot inline queries and callback buttons

+

Working with bot inline queries and callback buttons

@@ -1021,7 +1021,7 @@
-

Working with bots

+

Working with bots

@@ -1044,7 +1044,7 @@
-

Working with bots (internal bot API use)

+

Working with bots (internal bot API use)

@@ -1063,11 +1063,11 @@ - +
help.setBotUpdatesStatusInforms the server about the number of pending bot updates if they haven't been processed for a long time; for bots onlyInforms the server about the number of pending bot updates if they haven't been processed for a long time; for bots only
-

Working with cloud themes

+

Working with cloud themes

@@ -1114,7 +1114,7 @@
-

Working with contacts and top peers

+

Working with contacts and top peers

@@ -1161,7 +1161,7 @@ - + @@ -1205,7 +1205,7 @@
contacts.getContactsReturns the current user's contact list.Returns the current user's contact list.
contacts.getLocated
-

Working with credit cards

+

Working with credit cards

@@ -1220,7 +1220,7 @@
-

Working with dialogs

+

Working with dialogs

@@ -1263,7 +1263,7 @@ - + @@ -1283,7 +1283,7 @@
messages.hidePeerSettingsBarShould be called after the user hides the report spam/add as contact bar of a new chat, effectively prevents the user from executing the actions specified in the peer's settings.Should be called after the user hides the report spam/add as contact bar of a new chat, effectively prevents the user from executing the actions specified in the peer's settings.
messages.getOnlines
-

Working with drafts

+

Working with drafts

@@ -1306,7 +1306,7 @@
-

Working with emoji keywords

+

Working with emoji keywords

@@ -1333,7 +1333,7 @@
-

Working with folders

+

Working with folders

@@ -1368,7 +1368,7 @@
-

Working with games

+

Working with games

@@ -1395,7 +1395,7 @@
-

Working with group calls & live streaming

+

Working with group calls & live streaming

@@ -1482,7 +1482,7 @@
-

Working with imported chats

+

Working with imported chats

@@ -1497,7 +1497,7 @@ - + @@ -1513,7 +1513,7 @@
messages.startHistoryImportComplete the history import process, importing all messages into the chat.
To be called only after initializing the import with messages.initHistoryImport and uploading all files using messages.uploadImportedMedia.		Complete the history import process, importing all messages into the chat.
To be called only after initializing the import with messages.initHistoryImport and uploading all files using messages.uploadImportedMedia.
messages.checkHistoryImportPeer
-

Working with localization packs

+

Working with localization packs

@@ -1544,7 +1544,7 @@
-

Working with media autodownload settings

+

Working with media autodownload settings

@@ -1563,7 +1563,7 @@
-

Working with message threads

+

Working with message threads

@@ -1590,7 +1590,7 @@
-

Working with message reactions

+

Working with message reactions

@@ -1613,7 +1613,7 @@
-

Working with messages

+

Working with messages

@@ -1644,7 +1644,7 @@ - + @@ -1712,7 +1712,7 @@
messages.getMessageEditDataFind out if a media message's caption can be editedFind out if a media message's caption can be edited
messages.getMessages
-

Working with notification settings

+

Working with notification settings

@@ -1751,7 +1751,7 @@
-

Working with other users

+

Working with other users

@@ -1770,7 +1770,7 @@
-

Working with payments

+

Working with payments

@@ -1809,7 +1809,7 @@ - + @@ -1817,7 +1817,7 @@
messages.setBotPrecheckoutResultsOnce the user has confirmed their payment and shipping details, the bot receives an updateBotPrecheckoutQuery update.
Use this method to respond to such pre-checkout queries.
Note: Telegram must receive an answer within 10 seconds after the pre-checkout query was sent.		Once the user has confirmed their payment and shipping details, the bot receives an updateBotPrecheckoutQuery update.
Use this method to respond to such pre-checkout queries.
Note: Telegram must receive an answer within 10 seconds after the pre-checkout query was sent.
payments.getPaymentReceipt
-

Working with polls

+

Working with polls

@@ -1840,7 +1840,7 @@
-

Working with scheduled messages

+

Working with scheduled messages

@@ -1867,7 +1867,7 @@
-

Working with sensitive content (NSFW)

+

Working with sensitive content (NSFW)

@@ -1886,7 +1886,7 @@
-

Working with sponsored messages

+

Working with sponsored messages

@@ -1905,7 +1905,7 @@
-

Working with sponsored proxies

+

Working with sponsored proxies

@@ -1920,7 +1920,7 @@
-

Working with statistics

+

Working with statistics

@@ -1939,7 +1939,7 @@ - + @@ -1951,7 +1951,7 @@
stats.getMessagePublicForwardsObtains a list of messages, indicating to which other public channels was a channel message forwarded.
Will return a list of messages with peer_id equal to the public channel to which this message was forwarded.		Obtains a list of messages, indicating to which other public channels was a channel message forwarded.
Will return a list of messages with peer_id equal to the public channel to which this message was forwarded.
stats.getMegagroupStats
-

Working with stickers

+

Working with stickers

@@ -2066,7 +2066,7 @@
-

Working with the user's account

+

Working with the user's account

@@ -2085,7 +2085,7 @@ - + @@ -2133,7 +2133,7 @@
account.deleteAccountDelete the user's account from the telegram servers. Can be used, for example, to delete the account of a user that provided the login code, but forgot the 2FA password and no recovery method is configured.Delete the user's account from the telegram servers. Can be used, for example, to delete the account of a user that provided the login code, but forgot the 2FA password and no recovery method is configured.
account.getAccountTTL
-

Working with user profile pictures

+

Working with user profile pictures

@@ -2160,7 +2160,7 @@
-

Working with usernames

+

Working with usernames

@@ -2191,7 +2191,7 @@
-

Working with wallpapers

+

Working with wallpapers

@@ -2229,7 +2229,8 @@ -
Create and upload a new wallpaper
+ +