Identity and Access Management (IAM)

本頁面說明如何使用 Identity and Access Management (IAM) 控管 Vertex AI Search for commerce 的存取權與權限。

總覽

Google Cloud 提供「身分與存取權管理」(IAM) 功能，可讓您以更精細的方式授予使用者特定 Google Cloud 資源的存取權，避免其他資源遭到未經授權者擅自存取。本頁面說明 Vertex AI Search for commerce 的 IAM 角色和權限。如需 Google CloudIAM 的詳細說明，請參閱 IAM 說明文件。

Vertex AI Search for Commerce 提供一組預先定義的角色，可快速控管 Vertex AI Search for Commerce 資源的存取權。如果預先定義的角色未提供您需要的權限集，您也可以建立自己的自訂角色。您仍可使用先前的基礎角色 (編輯者、檢視者和擁有者)，但這些角色無法提供與商家適用的 Vertex AI Search 角色相同的完善控管能力。尤其基本角色提供的是跨 Google Cloud 的資源存取權，而非僅限於 Vertex AI Search 電子商務套件。詳情請參閱基本角色說明文件。

預先定義的角色

Vertex AI Search for Commerce 提供一些預先定義的角色，可為主體提供更精細的權限。您授予主體的角色會控管主體可採取的動作。主體可以是個人、群組或服務帳戶。

您可以為相同的主體授予多個角色，並且隨時變更授予主體的角色 (前提是您具備相關權限)。

權限範圍越廣的角色會包含定義較為狹隘的角色。舉例來說，Retail Editor 角色包含 Retail Viewer 角色的所有權限，再加上 Retail Editor 角色的額外權限。同樣地，零售管理員角色包含零售編輯者角色的所有權限，以及額外權限。

基本角色 (擁有者、編輯者、檢視者) 提供跨Google Cloud的權限。Vertex AI Search for Commerce 專用角色只提供 Vertex AI Search for Commerce 權限，但以下 Google Cloud(Google Cloud) 權限例外，因為這些權限是一般Google Cloud 使用所需：

• resourcemanager.projects.get
• resourcemanager.projects.list
• serviceusage.services.list
• serviceusage.services.get

下表列出商家適用的 Vertex AI Search 預先定義角色，以及其 Vertex AI Search 權限：

查看資料表

名稱	商家適用的 Vertex AI Search 權限	說明
[專案] > [擁有者]	All retail permissions	對於所有 Google Cloud 資源具有完整存取權與控管、可管理使用者存取權並設定專案計費。
Project (專案) > Editor (編輯者)	所有 retail 權限 (零售管理員角色中的權限除外)。	具備所有 Google Cloud 和 Vertex AI Search for Commerce 資源的讀取/寫入權限 (但無法修改權限和計費)。
[Project] (專案) > [Viewer] (檢視者)	retail.*.get retail.*.list	具備所有 Google Cloud 資源的唯讀存取權，包括 Vertex AI Search for commerce 資源。
Retail 管理員	retail.retailProjects.acceptDataTerms retail.solutions.enroll retail.products.purge retail.places.purge retail.places.purgeInventoryActivities retail.places.purgeProductPrices retail.places.purgeProductSettings retail.orders.purge retail.products.setSponsorship retail.userEvents.purge retail.userEvents.rejoin retail.attributesConfigs.removeCatalogAttribute retail.attributesConfigs.batchRemoveCatalogAttributes retail.merchantConfigs.get retail.merchantConfigs.update retail.merchantControls.approverDelete retail.merchantControls.approverGet retail.merchantControls.approverList retail.merchantControls.approverUpdate retail.merchantControls.creatorCreate retail.merchantControls.creatorDelete retail.merchantControls.creatorGet retail.merchantControls.creatorList retail.merchantControls.creatorSubmit retail.merchantControls.creatorUpdate automlrecommendations.events.purge automlrecommendations.events.rejoin 這個角色也包含 Retail Editor 和 Retail Viewer 角色的所有權限。	可完整控制所有 Vertex AI Search for Commerce 資源。
Retail 編輯者	retail.catalogs.import retail.catalogs.update retail.products.create retail.products.delete retail.products.update retail.products.import retail.userEvents.create retail.userEvents.import retail.servingConfigs.create retail.servingConfigs.update retail.servingConfigs.delete retail.controls.create retail.controls.update retail.controls.delete retail.controls.import retail.controls.export retail.attributesConfigs.update retail.attributesConfigs.addCatalogAttribute retail.attributesConfigs.importCatalogAttributes retail.attributesConfigs.exportCatalogAttributes retail.attributesConfigs.replaceCatalogAttribute retail.completionConfigs.update retail.models.create retail.models.delete retail.models.update retail.models.pause retail.models.resume retail.loggingConfigs.update retail.alertConfigs.update rretail.merchantCenterAccountLinks.create retail.merchantCenterAccountLinks.delete retail.metrics.writeMetricValue retail.merchantConfigs.get retail.merchantConfigs.update retail.merchantControls.approverDelete retail.merchantControls.approverGet retail.merchantControls.approverList retail.merchantControls.approverUpdate retail.merchantControls.creatorCreate retail.merchantControls.creatorDelete retail.merchantControls.creatorGet retail.merchantControls.creatorList retail.merchantControls.creatorSubmit retail.merchantControls.creatorUpdate automlrecommendations.apiKeys.create automlrecommendations.apiKeys.delete automlrecommendations.catalogItems.create automlrecommendations.catalogItems.delete automlrecommendations.catalogItems.update automlrecommendations.catalogs.update automlrecommendations.events.create automlrecommendations.placements.create automlrecommendations.placements.delete automlrecommendations.recommendations.create automlrecommendations.recommendations.delete automlrecommendations.recommendations.pause automlrecommendations.recommendations.resume automlrecommendations.recommendations.update 這個角色也包含零售檢視者角色的所有權限。	可讀取所有 Vertex AI Search for Commerce 資源，並寫入 products、events 和其他資源。
Retail 檢視者	retail.retailProjects.get retail.attributesConfigs.exportCatalogAttributes retail.catalogs.completeQuery retail.catalogs.listProductAttributes retail.controls.export retail.merchantConfigs.get retail.placements.search retail.placements.predict retail.products.export retail.userEvents.export retail.*.get retail.*.list	具備所有 Vertex AI Search for commerce 資源的唯讀存取權。
零售商家核准者	retail.attributesConfigs.get retail.controls.get retail.controls.list retail.merchantConfigs.get retail.merchantConfigs.update retail.merchantControls.approverDelete retail.merchantControls.approverGet retail.merchantControls.approverList retail.merchantControls.approverUpdate retail.merchantControls.creatorCreate retail.merchantControls.creatorDelete retail.merchantControls.creatorGet retail.merchantControls.creatorList retail.merchantControls.creatorSubmit retail.merchantControls.creatorUpdate retail.products.get retail.servingConfigs.list retail.servingConfigs.search	可在行銷控制台中核准內容。
零售商家建立者	retail.attributesConfigs.get retail.controls.get retail.controls.list retail.merchantConfigs.get retail.merchantControls.creatorCreate retail.merchantControls.creatorDelete retail.merchantControls.creatorGet retail.merchantControls.creatorList retail.merchantControls.creatorSubmit retail.merchantControls.creatorUpdate retail.products.get retail.servingConfigs.list retail.servingConfigs.search	可以在 Merchandising 控制台中建立內容。

遷移 Recommendations API 的權限

如果您要從先前的 Recommendations Engine API 遷移至 Vertex AI Search for commerce，請注意，下列預先定義的角色也包含先前 API 的權限。

• 零售管理員：包含「推薦內容管理員」的所有權限，但不含 apiKeys 權限。
• Retail Editor：包含「Recommendations Editor」的所有權限，以及 catalog.update，但不包含 apiKeys 權限。
• Retail 檢視者：包含「Recommendations Viewer」的所有權限。

管理商家適用的 Vertex AI Search IAM

您可以使用 Google Cloud控制台、API 的 IAM 方法或 Vertex AI Search for commerce 取得及設定 IAM 政策和 IAM 角色。詳情請參閱「授予、變更及撤銷存取權」。

後續步驟

• 瞭解如何授予及撤銷存取權。
• 進一步瞭解身分與存取權管理。
• 進一步瞭解基本角色。
• 進一步瞭解自訂角色。