-Learn more about [Teams meetings, expiration and policies](/MicrosoftTeams/meeting-expiration) and [meetings, webinars, and live events](/microsoftteams/quick-start-meetings-live-events).

-* [Teams recording policy](/MicrosoftTeams/teams-recording-policy)

-* [View app permission and grant admin consent](/MicrosoftTeams/app-permissions-admin-center)

-* [Security and compliance in Microsoft Teams](/MicrosoftTeams/security-compliance-overview)

-> [Publish your app to your org](/MicrosoftTeams/tenant-apps-catalog-teams?toc=/microsoftteams/platform/toc.json&bc=/MicrosoftTeams/breadcrumb/toc.json)

-* [Shared channels in Microsoft Teams](/MicrosoftTeams/shared-channels)

-4. [Install the Teams PowerShell module](https://www.powershellgallery.com/packages/MicrosoftTeams/1.0.2).

-For more information, see [manage your apps in the Teams admin center](/MicrosoftTeams/manage-apps?toc=%2Fmicrosoftteams%2Fplatform%2Ftoc.json&bc=%2FMicrosoftTeams%2Fbreadcrumb%2Ftoc.json).

-description: Understand Microsoft Teams store ranking parameters such as historical usage and user engagement data, app quality and values, audience relevance, app update.

-The information in this disclosure statement applies to the Microsoft Teams store in which Microsoft makes third-party apps available to users. The Microsoft Teams store ranks app search results in the store using a set of ranking parameters to deliver relevant search results to users. The ranking parameters listed aren't exhaustive and they're intended to provide our publisher community with a high-level understanding of the main parameters that the storefront use in ranking determinations. All defined terms used but not otherwise defined herein will have the meaning ascribed thereto in the Microsoft Publisher Agreement.

-The Microsoft Teams store editorial team determines the prominence and location of an app within the Editorial sections such as promo banner on the Microsoft Teams store based on ranking parameters, and are used as objective criteria applied equally to all apps in the Microsoft Teams store that includes MicrosoftΓÇÖs own apps and all third-party developer apps. Following are the main parameters used to determine app placements:

-* Historical usage data: Apps with higher volumes of usage in the Teams store tend to rank higher than apps with lower usage.

-* User engagement data: Apps with higher user engagement in the Teams store tend to rank higher than apps with lower engagement.

-* App quality and value: Apps that have distinct value and provide a high-quality user experience tend to rank higher.

-* Audience relevance: Apps that are likely to be more relevant to a particular audience (for example, based on their language settings and license type such as, Education, Enterprise, or Small and Medium business) tend to rank higher than apps that are likely to be less relevant.

-* App update or new release: Newly released or updated high-quality apps tend to rank higher than apps that were released or updated on an earlier date.

-Admins can purchase app subscription plans in the [Teams admin center](/MicrosoftTeams/purchase-third-party-apps).

-* [Publish your Teams app to your org](/MicrosoftTeams/tenant-apps-catalog-teams?toc=/microsoftteams/platform/toc.json&bc=/MicrosoftTeams/breadcrumb/toc.json)

-Microsoft Teams lets admins customize Teams app to enhance store experience and adhere to their organization's branding. An app developer can allow their app to be customized by a Teams admin. For more information, see

-[Customize apps in the Teams admin center](/MicrosoftTeams/customize-apps).

-You can enable this feature by defining the app properties that your customers can customize in the [`configurableProperties` section in the Teams app manifest](/microsoftteams/platform/resources/schema/manifest-schema#configurableproperties), starting with version 1.11. That can be done in the [Developer Portal for Teams](https://dev.teams.microsoft.com/home) if you've chosen to use the Developer Portal to edit the manifest of your app.

-Provide guidelines for customers (specifically Teams admins) who want to customize your app. For more information, see [customize apps in Teams](/MicrosoftTeams/customize-apps).

-To enhance Teams app experience, you can hide an app from users by default until admin allows to unhide the app. For example, Contoso Electronics has created a help desk app for Teams. To enable appropriate functioning of the app, Contoso ElectronicsΓÇÖ wants the customers to first set up specific properties of the app. The app is hidden by default and is available to users only after the admin allows it.

-* [Customize apps in the Teams admin center](/MicrosoftTeams/customize-apps)

-* [Manage app setup policies in Microsoft Teams](/MicrosoftTeams/teams-app-setup-policies#create-a-custom-app-setup-policy)

-After your app is published as a Microsoft 365-enabled Teams app, your app will be discoverable as an installable app in the Outlook and Microsoft 365 app stores, in addition to the Teams store. When running in Outlook and Microsoft 365 app, your app uses the same permissions granted in Teams. Teams admins can [manage access to Teams apps across Microsoft 365](/MicrosoftTeams/manage-third-party-teams-apps) for users in their organization.

-After it's published, your app will be discoverable as an installable app from the Outlook and Microsoft 365 app stores, in addition to the Teams store. Your app uses the permissions defined in Teams across Outlook and Microsoft 365. Teams admins can [manage access to Teams apps across Microsoft 365](/MicrosoftTeams/manage-third-party-teams-apps) for users in their organization.

-As a Teams admin, you can upload and pre-install the app package for your organization's tenant from [Teams admin center](https://admin.teams.microsoft.com/). For more information, see [upload your custom apps in the Microsoft Teams admin center](/MicrosoftTeams/upload-custom-apps).

-description: In this module, learn about Collaboration control and settings REST API reference to manage settings, start, map, and retrieve collaboration activities.

-Developers can use the Collaboration control and Settings REST API to manage settings, start, map, and retrieve collaboration activities with their own business model entities.

-This article provides reference for the Collaboration control solution REST API.

-|[Associate Collaboration Map](/rest/api/industry/collaboration-controls/collaboration-custom-ap-is/associate-collaboration-map)|Associates a collaborative entity to a collaboration session.|

-|[Begin Collaboration Session](/rest/api/industry/collaboration-controls/collaboration-custom-ap-is/begin-collaboration-session)|Creates a collaboration session record linked to a business entity, application context, and optional metadata.|

-|[Disassociate Collaboration Map](/rest/api/industry/collaboration-controls/collaboration-custom-ap-is/disassociate-collaboration-map-custom-api)|Disassociates a mapped entity from the given collaboration session.|

-|[Retrieve Collaboration Maps](/rest/api/industry/collaboration-controls/collaboration-custom-ap-is/retrieve-collaboration-maps-custom-api)|Gets a list of collaboration maps for a session of a specific entity type.|

-|[Retrieve Collaboration Session](/rest/api/industry/collaboration-controls/collaboration-custom-ap-is/retrieve-collaboration-session-custom-api)|Gets a collaboration session record based on the parameters provided.|

-|[Update Collaboration Map](/rest/api/industry/collaboration-controls/collaboration-custom-ap-is/update-collaboration-map-custom-api)|Updates a collaboration map record and its metadata if provided.|

-|[Update Collaboration Session](/rest/api/industry/collaboration-controls/collaboration-custom-ap-is/update-collaboration-session)|Updates a collaboration session record and optionally its metadata.|

-|[Get Collaboration Map By Id](/rest/api/industry/collaboration-controls/collaboration-standard-o-data-ap-is/get-collaboration-map-by-id)|Gets the details from a collaboration map record.|

-|[Get Collaboration Metadata](/rest/api/industry/collaboration-controls/collaboration-standard-o-data-ap-is/get-collaboration-metadata)|Gets a list of the collaboration metadata records for a given collaboration map or a collaboration root entity name.|

-|[Get Collaboration Root](/rest/api/industry/collaboration-controls/collaboration-standard-o-data-ap-is/get-collaboration-root)|Lists all the collaboration sessions created.|

-|[Create and Update Settings](/rest/api/industry/collaboration-controls/settings-custom-ap-is/create-update-setting-custom-api)|Creates or updates a setting that matches both the group path and the settings definition name.|

-|[Retrieve Null Settings](/rest/api/industry/collaboration-controls/settings-custom-ap-is/retrieve-null-settings-custom-api)|Returns a list of settings definitions that do not have a value.|

-|[Retrieve Settings](/rest/api/industry/collaboration-controls/settings-custom-ap-is/retrieve-settings-custom-api)|Returns a list of specific settings or settings in groups.|

-|[Delete Settings Definition](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/delete-settings-definition)|Deletes a settings definition.|

-|[Delete Settings Group](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/delete-settings-group)|Deletes a settings group.|

-|[Delete Settings Type](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/delete-settings-type)|Delete a settings type.|

-|[Delete Settings Value](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/delete-settings-value)|Deletes a settings value.|

-|[Get Settings Definitions](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/get-settings-definitions)|Lists settings definitions.|

-|[Get Settings Groups](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/get-settings-groups)|Lists settings groups.|

-|[Get Settings Types](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/get-settings-types)|Lists settings types.|

-|[Get Settings Value](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/get-settings-value)|Lists settings values.|

-|[Patch Settings Definition](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/patch-settings-definition)|Updates a settings definition.|

-|[Patch Settings Group](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/patch-settings-group)|Updates a settings group.|

-|[Patch Settings Type](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/patch-settings-type)|Updates a settings type.|

-|[Patch Settings Value](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/patch-settings-value)|Updates a setting value.|

-|[Post Settings Definition](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/post-settings-definition)|Creates a new settings definition.|

-|[Post Settings Group](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/post-settings-group)|Creates a new settings group.|

-|[Post Settings Type](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/post-settings-type)|Creates a new settings type.|

-|[Post Settings Value](/rest/api/industry/collaboration-controls/settings-standard-o-data-ap-is/post-settings-value)|Creates a new setting value.|

- ::image type="content" source="../assets/images/collaboration-control/retrieve-collab-session.png" alt-text="Screenshot is an example that shows how to Retrieve collaboration session.":::

-If you want to change the app name, icon, or description after uploading it to Teams, see [customize appearance of apps](/MicrosoftTeams/customize-apps#customize-details-of-an-app)

-To resolve this issue, you must check the error message in the response and if it's set to the message shown above this means the virtual record isn't associated. To create an association for this record, you must call [Associate Collaboration Map - REST API](/rest/api/industry/collaboration-controls/collaboration-custom-ap-is/associate-collaboration-map).

-s

- For more information, see [Publish to your org](/MicrosoftTeams/manage-apps?toc=%2Fmicrosoftteams%2Fplatform%2Ftoc.json&bc=%2Fmicrosoftteams%2Fplatform%2Fbreadcrumb%2Ftoc.json)

-* [Manage Teams app in the Microsoft Teams admin center](/MicrosoftTeams/manage-apps?toc=%2Fmicrosoftteams%2Fplatform%2Ftoc.json&bc=%2Fmicrosoftteams%2Fplatform%2Fbreadcrumb%2Ftoc.json)

-* [How admins can enable or disable connectors](/MicrosoftTeams/office-365-custom-connectors#enable-or-disable-connectors-in-teams)

-* [How admins can publish custom connectors within their org](/MicrosoftTeams/office-365-custom-connectors)