Update content of files

This commit is contained in:
GitHub Action 2023-12-22 19:19:16 +00:00
parent fb2c10a202
commit 03f287ae91
6 changed files with 16 additions and 13 deletions

View file

@ -108,7 +108,7 @@ If the default chat icon is used, its color cannot be modified after creating th
<p>Topics may be pinned or unpinned using <a href="/method/channels.updatePinnedForumTopic">channels.updatePinnedForumTopic</a>; use <a href="/method/channels.reorderPinnedForumTopics">channels.reorderPinnedForumTopics</a> to reorder pinned topics.<br>
You can pin at most <code>topics_pinned_limit</code> topics per forum, as specified by the <a href="/api/config#client-configuration">client configuration parameters »</a>.</p>
<p>Users may also choose to display messages from all topics as if they were sent to a normal group, using a "View as messages" setting in the local client.<br>
This setting only affects the current account, and is synced to other logged in sessions using the <a href="/method/channels.toggleViewForumAsMessages">channels.toggleViewForumAsMessages</a> method; invoking this method will update the value of the <code>view_forum_as_messages</code> flag of <a href="/constructor/channelFull">channelFull</a> or <a href="/constructor/dialog">dialog</a>.</p></div>
This setting only affects the current account, and is synced to other logged in sessions using the <a href="/method/channels.toggleViewForumAsMessages">channels.toggleViewForumAsMessages</a> method; invoking this method will update the value of the <code>view_forum_as_messages</code> flag of <a href="/constructor/channelFull">channelFull</a> or <a href="/constructor/dialog">dialog</a> and emit an <a href="/constructor/updateChannelViewForumAsMessages">updateChannelViewForumAsMessages</a>.</p></div>
</div>

View file

@ -61,6 +61,7 @@
<a href='/constructor/messageMediaGiveaway'>messageMediaGiveaway</a>#58260664 flags:<a href='/type/%23'>#</a> only_new_subscribers:flags.0?<a href='/constructor/true'>true</a> channels:<a href='/type/Vector%20t'>Vector</a>&lt;<a href='/type/long'>long</a>&gt; countries_iso2:flags.1?<a href='/type/Vector%20t'>Vector</a>&lt;<a href='/type/string'>string</a>&gt; quantity:<a href='/type/int'>int</a> months:<a href='/type/int'>int</a> until_date:<a href='/type/int'>int</a> = <a href='/type/MessageMedia'>MessageMedia</a>;
<a href='/constructor/messageActionGiveawayLaunch'>messageActionGiveawayLaunch</a>#332ba9ed = <a href='/type/MessageAction'>MessageAction</a>;
<a href='/constructor/messageActionGiveawayResults'>messageActionGiveawayResults</a>#2a9fadc5 winners_count:<a href='/type/int'>int</a> unclaimed_count:<a href='/type/int'>int</a> = <a href='/type/MessageAction'>MessageAction</a>;
<a href='/constructor/messageActionGiftCode'>messageActionGiftCode</a>#d2cfdb0e flags:<a href='/type/%23'>#</a> via_giveaway:flags.0?<a href='/constructor/true'>true</a> unclaimed:flags.2?<a href='/constructor/true'>true</a> boost_peer:flags.1?<a href='/type/Peer'>Peer</a> months:<a href='/type/int'>int</a> slug:<a href='/type/string'>string</a> = <a href='/type/MessageAction'>MessageAction</a>;
@ -106,12 +107,14 @@ Users may also use this method to simply gift subscriptions to contacts by <stro
<ul>
<li>
<p>If the payment succeeds and we're launching a giveaway using <a href="/constructor/inputStorePaymentPremiumGiveaway">inputStorePaymentPremiumGiveaway</a>: a <a href="/constructor/messageActionGiveawayLaunch">messageActionGiveawayLaunch</a> service message and a media message containing a <a href="/constructor/messageMediaGiveaway">messageMediaGiveaway</a> will be sent to the channel. </p>
<p>Once the giveaway is over, the winners will automatically receive a <a href="/constructor/messageActionGiftCode">messageActionGiftCode</a> service message from Telegram's service user, containing the <code>slug</code> that can be used to generate a <a href="/api/links#premium-giftcode-links">giftcode link</a> to redeem the Premium subscription.<br>
The <a href="/constructor/messageActionGiftCode">messageActionGiftCode</a>.<code>via_giveaway</code> will be set. </p>
<p>Once the giveaway is over, a <a href="/constructor/messageActionGiveawayResults">messageActionGiveawayResults</a> will be sent to the channel and the winners will automatically receive a <a href="/constructor/messageActionGiftCode">messageActionGiftCode</a> service message from Telegram's service user, containing the <code>slug</code> that can be used to generate a <a href="/api/links#premium-giftcode-links">giftcode link</a> to redeem the Premium subscription.<br>
The <a href="/constructor/messageActionGiftCode">messageActionGiftCode</a>.<code>via_giveaway</code> flag will be set. </p>
</li>
<li>
<p>If the payment succeeds and we're simply gifting some subscriptions to specific users <a href="/constructor/inputStorePaymentPremiumGiftCode">inputStorePaymentPremiumGiftCode</a>: the specified users will automatically receive a <a href="/constructor/messageActionGiftCode">messageActionGiftCode</a> service message from Telegram's service user, containing the <code>slug</code> that can be used to generate a <a href="/api/links#premium-giftcode-links">giftcode link</a> to redeem the Premium subscription.<br>
The <a href="/constructor/messageActionGiftCode">messageActionGiftCode</a>.<code>via_giveaway</code> will not be set. </p>
The <a href="/constructor/messageActionGiftCode">messageActionGiftCode</a>.<code>via_giveaway</code> flag will not be set. </p>
<p>Note that if the payment was made on behalf of the user (i.e. if <code>boost_peer</code> was <strong>not</strong> set), then the users to which the gift was sent will instead receive a <a href="/constructor/messageService">messageService</a> from the user that sent the gift, containing a <a href="/constructor/messageActionGiftPremium">messageActionGiftPremium</a> constructor with further info about the price and duration of the gifted Telegram Premium subscription.<br>
Clients should display this message, along with a sticker from the <a href="/constructor/inputStickerSetPremiumGifts">inputStickerSetPremiumGifts</a> <a href="/api/stickers">stickerset</a>: here's an <a href="https://telegram.org/blog/custom-emoji#gifting-telegram-premium">example</a>. </p>
</li>
</ul>
<p>The <a href="/constructor/messageActionGiftCode">messageActionGiftCode</a>.<code>slug</code> should be used to generate a <a href="/api/links#premium-giftcode-links">giftcode link</a>, that the user can use to redeem the subscription, or re-gift it to someone else. </p>

View file

@ -65,8 +65,8 @@
</ul>
<h5><a class="anchor" href="#new-constructors" id="new-constructors" name="new-constructors"><i class="anchor-icon"></i></a>New Constructors</h5>
<ul>
<li>Added <a href="/constructor/updateChannelViewForumAsMessages">updateChannelViewForumAsMessages</a> - </li>
<li>Added <a href="/constructor/messageActionGiveawayResults">messageActionGiveawayResults</a> - </li>
<li>Added <a href="/constructor/updateChannelViewForumAsMessages">updateChannelViewForumAsMessages</a> - Users may also choose to display messages from all topics as if they were sent to a normal group, using a "View as messages" setting in the local client. </li>
<li>Added <a href="/constructor/messageActionGiveawayResults">messageActionGiveawayResults</a> - A <a href="/api/giveaways">giveaway</a> has ended.</li>
<li>Added <a href="/constructor/updatePeerWallpaper">updatePeerWallpaper</a> - The <a href="/api/wallpapers">wallpaper »</a> of a given peer has changed.</li>
<li>Added <a href="/constructor/storyFwdHeader">storyFwdHeader</a> - Contains info about the original poster of a reposted story.</li>
<li>Added <a href="/constructor/postInteractionCountersMessage">postInteractionCountersMessage</a> - Interaction counters for a message.</li>
@ -195,12 +195,12 @@
<li>Added <a href="/constructor/messages.webPage">messages.webPage</a> - Represents an Instant View webpage.</li>
<li>Added <a href="/constructor/inputStorePaymentPremiumGiftCode">inputStorePaymentPremiumGiftCode</a> - </li>
<li>Added <a href="/constructor/inputStorePaymentPremiumGiveaway">inputStorePaymentPremiumGiveaway</a> - </li>
<li>Added <a href="/constructor/inputInvoicePremiumGiftCode">inputInvoicePremiumGiftCode</a> - </li>
<li>Added <a href="/constructor/inputInvoicePremiumGiftCode">inputInvoicePremiumGiftCode</a> - Used if the user wishes to start a channel <a href="/api/giveaways">giveaway</a> or send some <a href="/api/giveaways">giftcodes</a> to members of a channel, in exchange for <a href="/api/boost">boosts</a>.</li>
<li>Added <a href="/constructor/premiumGiftCodeOption">premiumGiftCodeOption</a> - </li>
<li>Added <a href="/constructor/payments.checkedGiftCode">payments.checkedGiftCode</a> - </li>
<li>Added <a href="/constructor/messageMediaGiveaway">messageMediaGiveaway</a> - </li>
<li>Added <a href="/constructor/messageActionGiftCode">messageActionGiftCode</a> - </li>
<li>Added <a href="/constructor/messageActionGiveawayLaunch">messageActionGiveawayLaunch</a> - </li>
<li>Added <a href="/constructor/messageActionGiftCode">messageActionGiftCode</a> - Contains a <a href="/api/links#premium-giftcode-links">Telegram Premium giftcode link</a>.</li>
<li>Added <a href="/constructor/messageActionGiveawayLaunch">messageActionGiveawayLaunch</a> - A <a href="/api/giveaways">giveaway</a> was started.</li>
<li>Added <a href="/constructor/payments.giveawayInfo">payments.giveawayInfo</a> - </li>
<li>Added <a href="/constructor/payments.giveawayInfoResults">payments.giveawayInfoResults</a> - </li>
<li>Added <a href="/constructor/messageEntityBlockquote">messageEntityBlockquote</a> - Message entity representing a block quote.</li>
@ -373,7 +373,7 @@
<li>Added <a href="/method/bots.invokeWebViewCustomMethod">bots.invokeWebViewCustomMethod</a> - Send a custom request from a <a href="/api/bots/webapps">mini bot app</a>, triggered by a <a href="/api/web-events#web-app-invoke-custom-method">web_app_invoke_custom_method event »</a>.</li>
<li>Added <a href="/method/stories.getPeerStories">stories.getPeerStories</a> - Fetch the full active <a href="/api/stories#watching-stories">story list</a> of a specific peer.</li>
<li>Added <a href="/method/stories.getAllReadPeerStories">stories.getAllReadPeerStories</a> - Obtain the latest read story ID for all peers when first logging in, returned as a list of <a href="/constructor/updateReadStories">updateReadStories</a> updates, see <a href="/api/stories#watching-stories">here »</a> for more info.</li>
<li>Added <a href="/method/stories.getPeerMaxIDs">stories.getPeerMaxIDs</a> - </li>
<li>Added <a href="/method/stories.getPeerMaxIDs">stories.getPeerMaxIDs</a> - Get the IDs of the maximum read stories for a set of peers.</li>
<li>Added <a href="/method/stories.getChatsToSend">stories.getChatsToSend</a> - Obtain a list of channels where the user can post <a href="/api/stories">stories</a></li>
<li>Added <a href="/method/stories.togglePeerStoriesHidden">stories.togglePeerStoriesHidden</a> - Hide the active stories of a user, preventing them from being displayed on the action bar on the homescreen, see <a href="/api/stories#hiding-stories-of-other-users">here »</a> for more info.</li>
<li>Added <a href="/method/stories.getBoostsStatus">stories.getBoostsStatus</a> - Get the current <a href="/api/boost">boost status</a> of a channel, see <a href="/api/boost">here »</a> for more info on boosts.</li>

View file

@ -1114,7 +1114,7 @@ These links are used to confirm ownership of the phone number, to prevent accoun
<tr>
<td><code>slug</code></td>
<td style="text-align: center;">Optional</td>
<td>Gift code to be applied as described <a href="/api/giveaways">here »</a>.</td>
<td>Gift code slug to be passed to <a href="/method/payments.checkGiftCode">payments.checkGiftCode</a> to obtain further info, and eventually to <a href="/method/payments.applyGiftCode">payments.applyGiftCode</a> to apply it. See the <a href="/api/giveaways">giveaways</a> documentation for more info.</td>
</tr>
</tbody>
</table>

View file

@ -136,7 +136,7 @@ The first button of the keyboard will always be a <a href="/constructor/keyboard
</li>
<li><a href="/constructor/inputInvoicePremiumGiftCode">inputInvoicePremiumGiftCode</a> <ul>
<li>Used if the user wishes to start a channel <a href="/api/giveaways">giveaway</a> or send some <a href="/api/giveaways">giftcodes</a> to members of a channel, in exchange for <a href="/api/boost">boosts</a>.<br>
The <code>purpose</code> field should be populated with <a href="/constructor/inputStorePaymentPremiumGiveaway">inputStorePaymentPremiumGiveaway</a> for giveaways and <a href="/constructor/inputStorePaymentPremiumGiftCode">inputStorePaymentPremiumGiftCode</a> for gift codes.<br>
The <code>purpose</code> field should be populated with <a href="/constructor/inputStorePaymentPremiumGiveaway">inputStorePaymentPremiumGiveaway</a> for <a href="/api/giveaways">giveaways</a> and <a href="/constructor/inputStorePaymentPremiumGiftCode">inputStorePaymentPremiumGiftCode</a> for <a href="/api/giveaways">gifts</a>.<br>
The <code>option</code> field should be populated with one of the giveaway options returned by <a href="/method/payments.getPremiumGiftCodeOptions">payments.getPremiumGiftCodeOptions</a>.<br>
See the <a href="/api/giveaways">giveaways »</a> documentation for more info. </li>
</ul>

View file

@ -204,7 +204,7 @@ Then, when the user clicks on the subscribe button in the sent invoice, follow t
Clients should display this message, along with a sticker from the <a href="/constructor/inputStickerSetPremiumGifts">inputStickerSetPremiumGifts</a> <a href="/api/stickers">stickerset</a>: here's an <a href="https://telegram.org/blog/custom-emoji#gifting-telegram-premium">example</a>. </p>
<p>Note that if the <code>premium_gift_attach_menu_icon</code> <a href="/api/config#client-configuration">app configuration parameter</a> is <code>true</code>, a gift icon should be shown in the attachment menu in private chats with users, offering the current user to gift a <a href="/api/premium">Telegram Premium</a> subscription to the other user in the chat. </p>
<p>If the <code>premium_gift_text_field_icon</code> parameter is also set, a gift icon should be shown in the text bar in private chats with users (ie like the <code>/</code> icon in chats with bots), offering the current user to gift a <a href="/api/premium">Telegram Premium</a> subscription to the other user in the chat. Can only be true if <code>premium_gift_attach_menu_icon</code> is also true.</p>
<p>Note that even if the <code>premium_gifts</code> field is not set, we can still gift a Premium subscription an alternative payment flow <a href="/api/giveaways">described here »</a> (<a href="/constructor/inputStorePaymentPremiumGiftCode">inputStorePaymentPremiumGiftCode</a> without setting <code>boost_peer</code>). </p>
<p>Note that even if the <code>premium_gifts</code> field is not set, we can still gift one (or more!) Premium subscriptions using the alternative payment flow <a href="/api/giveaways">described here »</a> (<a href="/constructor/inputStorePaymentPremiumGiftCode">inputStorePaymentPremiumGiftCode</a> without setting <code>boost_peer</code>). </p>
<p>Gifting a <a href="/api/premium">Telegram Premium</a> subscription to another user will create <a href="/api/config#boosts-per-send-gift">boosts_per_sent_gift</a> <a href="/api/boost">boost slots »</a> for us, and one boost slot for the destination user. </p>
<h3><a class="anchor" href="#blocked-telegram-premium" id="blocked-telegram-premium" name="blocked-telegram-premium"><i class="anchor-icon"></i></a>Blocked Telegram Premium</h3>
<p>If the <code>premium_purchase_blocked</code> <a href="/api/config#client-configuration">app configuration parameter</a> is set, the user can't purchase a Premium account, and all Telegram Premium features must be hidden (like the <a href="#badge">badges</a> of Premium users, Telegram Premium purchase buttons, and so on).</p></div>