Document Premium App Subscriptions #6451
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
* overview page * start app subscriptions edits * move to monetization * jk
* round of edits * table/link
Jiralite
reviewed
Sep 26, 2023
Co-authored-by: Jiralite <33201955+Jiralite@users.noreply.github.com>
appellation
approved these changes
Sep 26, 2023
nathanctech
reviewed
Sep 26, 2023
| "promotion_id": null, | ||
| "type": 8, | ||
| "deleted": false, | ||
| "gift_code_flags": 0, |
There was a problem hiding this comment.
I see promotions and this gift code flag in the payload but not the docs. Are these used at all?
There was a problem hiding this comment.
Not at this time. We will be taking another pass at these docs shortly and welcome feedback with a premium-apps issue or PR.
Lulalaby
reviewed
Sep 26, 2023
| - App belongs to a developer team | ||
| - Team owner must be at least 18 years old | ||
| - Team must have verified emails and 2FA set up | ||
| - App uses slash commands, or has been approved for the Message Content privileged intent |
There was a problem hiding this comment.
Suggested change
| - App uses slash commands, or has been approved for the Message Content privileged intent | |
| - App uses slash commands, or has been approved for the privileged `Message Content` intent |
Mayhappens
|
|
||
| | Field | Type | Description | | ||
| |----------------|-----------|-------------------------------------------------------------| | ||
| | id | todo | ID of SKU | |
There was a problem hiding this comment.
Suggested change
| | id | todo | ID of SKU | | |
| | id | todo | ID of SKU | |
*snowflake
I won't be destroying tables this time tho
| | guild_id? | snowflake | ID of the guild that is granted access to the entitlement's sku | | ||
| | application_id | snowflake | ID of the parent application | | ||
| | type | integer | [Type of entitlement](#DOCS_MONETIZATION_ENTITLEMENTS/entitlement-object-entitlement-types) | | ||
| | consumed | boolean | Not applicable for App Subscriptions. Subscriptions are not consumed and will be `false` | |
There was a problem hiding this comment.
Suggested change
| | consumed | boolean | Not applicable for App Subscriptions. Subscriptions are not consumed and will be `false` | |
if it doesn't apply for us, it doesn't need to be documented? (at least that's the normal behavior)
|
|
||
| ## Configuring App Subscriptions | ||
|
|
||
| Once you have an idea what type of subscription you want to offer your app, you can create and [customize your SKU](#DOCS_MONETIZATION_SKUS/customizing-your-skus) to reflect the premium features that you are adding to your app. This is a good place to outline the benefits your users will receive from having an app subscription. |
There was a problem hiding this comment.
"you want to offer your app" sounds weird
| | app_permissions? | string | Bitwise set of permissions the app or bot has within the channel the interaction was sent from | | ||
| | locale?\*\*\* | string | Selected [language](#DOCS_REFERENCE/locales) of the invoking user | | ||
| | guild_locale? | string | [Guild's preferred locale](#DOCS_RESOURCES_GUILD/guild-object), if invoked in a guild | | ||
| | entitlements | array of [entitlement](#DOCS_MONETIZATION_ENTITLEMENTS/entitlement-object) objects | For [monetized apps](#DOCS_MONETIZATION_OVERVIEW), any entitlements for the invoking user, representing access to premium [SKUs](#DOCS_MONETIZATION_SKUS) | |
|
Merging this to publish the docs. We'll be collecting feedback and doing another pass on this shortly. |
2 tasks
Nihlus
added a commit
to Remora/Remora.Discord
that referenced
this pull request
Oct 29, 2023
mccoderpy
added a commit
to mccoderpy/discord.py-message-components
that referenced
this pull request
Nov 4, 2023
See discord/discord-api-docs#6451, discord/discord-api-docs#6452, and discord/discord-api-docs#6477. Signed-off-by: mccoderpy <mccuber04@outlook.de>
shaydewael
added a commit
to Jupith/discord-api-docs
that referenced
this pull request
May 14, 2024
* WIP premium apps * Rework Overview (discord#4) * overview page * start app subscriptions edits * move to monetization * jk * Implementing App Subscriptions * Added query params to entitlements * Update to Monetization Overview * Update entitlements in interactions * Round of small edits (discord#5) * round of edits * table/link * Use Nelly sample app. Remove en-us from help center * Added entitlements to Interaction object * Update to Test Entitlement * Testing your implementation * Added emoji/icon docs * Added Premium Apps to change log * fix tables * Update docs/monetization/App_Subscriptions.md Co-authored-by: Jiralite <33201955+Jiralite@users.noreply.github.com> --------- Co-authored-by: shay <swdewael@gmail.com> Co-authored-by: Jiralite <33201955+Jiralite@users.noreply.github.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
馃捀 Premium App Subscriptions
For feedback and bug reports, we have created a
premium-appsissue label.