[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-29。"],[[["\u003cp\u003eThis documentation covers audience management within Apigee and Apigee hybrid integrated portals, which is currently a Beta feature.\u003c/p\u003e\n"],["\u003cp\u003eAudiences allow segmentation of portal users or developer teams to control access to portal pages and published API products.\u003c/p\u003e\n"],["\u003cp\u003eTwo default audiences, "Anonymous users" and "Authenticated users," are automatically created for every portal, but only authenticated users can have entitlements customized.\u003c/p\u003e\n"],["\u003cp\u003eThe Audiences page allows users to view, add, edit, delete, and manage assignments for audiences, with a limit of 16 custom audiences.\u003c/p\u003e\n"],["\u003cp\u003eWhen adding or editing an audience, teams and individual portal users can be assigned, and resource entitlements can be managed to restrict access to specific content.\u003c/p\u003e\n"]]],[],null,["# Manage the audiences for your portal (Preview)\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\n|\n| **Preview\n| --- Apigee integrated portal**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nEnrolling in the Preview release of the audience management feature\n-------------------------------------------------------------------\n\nTo manage audiences, you must enroll in the Preview release of the audience management feature.\n\nTo enroll in the audience management feature: \n\n### Cloud Console UI\n\n1. In the Apigee in Cloud console, go to the **Distribution \\\u003e Portals** page.\n\n [Go to Portals](https://console.cloud.google.com/apigee/portals)\n2. Click a portal name.\n\n3. Click **Audiences**.\n\n4. Click **Enroll**.\n\n### Classic UI\n\nFrom the landing page of your portal, in the Preview enrollment\nbanner click **Enroll**.\n\nUnderstanding audiences\n-----------------------\n\nUsing audiences, you can segment portal users or developer teams to control access to the following resources:\n\n- Pages in your portal\n- Published API products\n\nThe following figure shows how audiences are used to control access to a set of resources.\n\nAs shown in the figure, as an authenticated portal user, User A is able access the resources available through the public API program. In addition, as a member of Team A, User A inherits the entitlements from the Preview Users audience and is able to access the resources available through this restricted API program.\n| For restricted API programs, the API provider is responsible for advertising the program and processing access requests from portal users.\n\nThe following sections describe how to manage audiences and configure audience entitlements, and the audiences that are available by default.\n\nAbout the default audiences\n---------------------------\n\nThe following two audiences are defined, by default.\n\nExploring the Audiences page\n----------------------------\n\nTo access the Audiences page:\n\n1. Display the list of portals:\n\n ### Cloud Console UI\n\n In the Apigee in Cloud console, go to the **Distribution \\\u003e Portals** page.\n\n [Go to Portals](https://console.cloud.google.com/apigee/portals)\n\n ### Classic UI\n\n Select **Publish \\\u003e Portals** in the side navigation bar to display the list of portals.\n2. Click the row of the portal for which you want to view audiences.\n\n3. Click **Audiences**.\n\n4. Click the **Audiences** tab.\n\nThe Audiences page is displayed.\n\nThe Audiences page lets you:\n\n- View details for all audiences, including:\n - Name\n - Description\n - Total number of team and individual portal user assignments\n - Creation date\n- [Add an audience](#add)\n- [Edit](#edit) and [delete](#delete) an audience\n\nYou can also [manage the resource entitlements for an audience](#resource-entitlements) when creating resources and\n[manage the default visibility for specific portal resources](/apigee/docs/api-platform/publish/portal/default-audience).\n\nAdding an audience\n------------------\n\n| **Note:** The maximum number of audiences that you can add is **16**.\n\nTo add an audience:\n\n1. [Access the Audiences page](#explore-ui).\n2. Add an Audience.\n\n ### Cloud Console UI\n\n 1. Click **+ Audience**.\n 2. Enter the name and description of the audience.\n 3. Click **Save**.\n\n ### Classic UI\n\n 1. Click **+**.\n 2. Enter the name and description of the audience.\n 3. Click **OK**.\n3. [Manage the assignments for an audience](#audience-assignments).\n\nManage the assignments for an audience\n--------------------------------------\n\nWhen [adding](#add) or [editing](#edit) an audience, you can manage the developer teams and individual portal users assigned.\n\nTo manage the assignments for an audience:\n\n1. [Access the Audiences page](#explore-ui).\n2. Click the row of the audience for which you want to manage audience assignments.\n3. To add a team or individual portal user to an audience:\n\n ### Cloud Console UI\n\n 1. Click edit **Edit**.\n 2. Select members in the drop-down list.\n 3. Click **Save**.\n\n ### Classic UI\n\n 1. Click **+** in the Assignments section.\n 2. Select one or more developer teams or individual portal users in the Add assignments dialog. Enter a string in the Search box to filter the list. Click **All** to select all items on the list or **None** to deselect all items.\n 3. Click **Add**.\n4. To delete an audience assignment:\n\n ### Cloud Console UI\n\n Click delete **Delete**.\n\n ### Classic UI\n\n Click .\n\nManaging the resource entitlements for an audience\n--------------------------------------------------\n\nWhen creating a portal page or publishing an API product, you can restrict access to the resource by assigning one or more audiences. When the visibility of that resource is set to **Selected audiences**, access is limited to the audiences to which the resource is assigned.\n\nFor more information, see:\n\n- [Manage the audience for a page in your portal](/apigee/docs/api-platform/publish/portal/page-editor#audience)\n- [Manage the audience for an API on your portal](/apigee/docs/api-platform/publish/portal/publish-apis#audience)\n\nWhen [viewing and editing](#edit) an audience, you can view the resource entitlements assigned.\n\nEditing an audience\n-------------------\n\nTo edit an audience:\n\n1. [Access the Audiences page](#explore-ui).\n2. Click the row of the audience that you want to edit.\n3. Edit the audience details.\n\n ### Cloud Console UI\n\n 1. Click edit **Edit**.\n 2. Edit the name, description, or members.\n 3. Click **Save**.\n\n ### Classic UI\n\n 1. In Audience details section, click .\n 2. Edit the name and description of the audience.\n 3. Click **Save**.\n4. [Manage the developer teams and individual portal users assigned to an audience](#audience-assignments).\n\n5. In the **Content visibility entitlements** section, view the resource entitlements for an audience.\n See [Manage the resource entitlements for an audience](#resource-entitlements).\n\nDeleting an audience\n--------------------\n\nTo delete an audience:\n\n1. [Access the Audiences page](#explore-ui).\n2. Delete the audience.\n\n ### Cloud Console UI\n\n 1. Click delete **Delete**.\n 2. Click **Delete** to confirm the operation.\n\n ### Classic UI\n\n 1. Position the cursor over the audience that you want to delete to display the actions menu.\n 2. Click\n 3. Click **Delete** to confirm the operation."]]