Identity and Access Management (IAM)

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

總覽

Google Cloud 提供身分與存取權管理 (IAM) 功能，可對特定 Google Cloud 資源授予更精細的存取權，避免未經授權者存取其他資源。本頁面說明 AI Commerce Search 的 IAM 角色和權限。如需 IAM 的詳細說明，請參閱 IAM 說明文件。 Google Cloud

AI Commerce Search 提供一組預先定義的角色，可快速控管 AI Commerce Search 資源的存取權。如果預先定義的角色未提供您需要的權限集，您也可以建立自己的自訂角色。此外，您仍可使用舊版基本角色 (編輯者、檢視者與擁有者)，但這些角色無法提供與 AI 商店搜尋角色相同的完善控管能力。尤其基本角色提供的是跨 Google Cloud 的資源存取，而非針對 AI Commerce Search。詳情請參閱基本角色說明文件。

預先定義的角色

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

您可以將多個角色授予同一個主體，只要有權限，隨時都能變更授予主體的角色。

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

基本角色 (擁有者、編輯者、檢視者) 提供跨Google Cloud的權限。AI Commerce Search 的專屬角色僅提供 AI Commerce Search 權限，除了以下的 Google Cloud(Google Cloud) 權限，這些權限為一般Google Cloud 使用所需：

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

下表列出適用於 AI Commerce Search 的預先定義角色及其 AI Commerce Search 權限：

查看資料表

名稱	AI Commerce Search 權限	說明
[專案] > [擁有者]	All retail permissions	對於所有 Google Cloud 資源具有完整存取權與控管、可管理使用者存取權並設定專案計費。
Project (專案) > Editor (編輯者)	除了零售管理員角色中的權限外，所有 retail 權限。	具備所有 Google Cloud 和 AI Commerce Search 資源的讀寫權限 (但無法修改權限和帳單)。
[Project] (專案) > [Viewer] (檢視者)	retail.*.get retail.*.list	具備所有資源的唯讀存取權，包括 AI Commerce Search 資源。 Google Cloud
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 這個角色也包含零售編輯者和零售檢視者角色中的所有權限。	完全控管所有 AI 商業搜尋資源。
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 <x0A> 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 這個角色也包含零售檢視者角色中的所有權限。	可讀取所有 AI Commerce Search 資源，並寫入 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	具備所有 AI Commerce Search 資源的唯讀存取權。
零售商家核准者	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	可在 Merchandising 控制台中核准內容。
零售商家建立者	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 遷移至 AI Commerce Search，請注意，下列預先定義的角色也包含先前 API 的權限。

• 零售管理員：包含 Recommendations 管理員的所有權限，但 apiKeys 權限除外。
• 零售編輯者：包含建議編輯者的所有權限，以及 catalog.update，但不包含 apiKeys 權限。
• 零售檢視者：包含 Recommendations 檢視者的所有權限。

管理 AI Commerce Search IAM

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

後續步驟

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