Gestão de identidade e de acesso (IAM)

Esta página descreve como pode controlar o acesso e as autorizações do Vertex AI Search for commerce através da gestão de identidade e de acesso (IAM).

Vista geral

Google Cloud oferece a gestão de identidade e de acesso (IAM), que lhe permite conceder acesso mais detalhado a recursos Google Cloud específicos e impede o acesso indesejado a outros recursos. Esta página descreve as funções e as autorizações da IAM do Vertex AI Search for commerce. Para uma descrição detalhada do Google Cloud IAM, consulte a documentação do IAM.

O Vertex AI Search para comércio oferece um conjunto de funções predefinidas concebidas para um controlo rápido do acesso aos seus recursos do Vertex AI Search para comércio. Também pode criar as suas próprias funções personalizadas, se as funções predefinidas não oferecerem os conjuntos de autorizações de que precisa. As funções básicas anteriores (Editor, Leitor e Proprietário) também continuam disponíveis, embora não ofereçam o mesmo controlo detalhado que as funções do Vertex AI Search for commerce. Em particular, as funções básicas fornecem acesso a recursos em todos os serviços do Google Cloud, em vez de apenas para o Vertex AI Search para comércio. Google Cloud Consulte a documentação sobre funções básicas para mais informações.

Funções predefinidas

O Vertex AI Search for commerce oferece algumas funções predefinidas que pode usar para fornecer autorizações mais detalhadas aos responsáveis. A função que concede a um principal controla as ações que o principal pode realizar. Os principais podem ser indivíduos, grupos ou contas de serviço.

Pode conceder várias funções ao mesmo principal e alterar as funções concedidas a um principal em qualquer altura, desde que tenha as autorizações para o fazer.

As funções mais amplas incluem as funções definidas de forma mais restrita. Por exemplo, a função de editor de retalho inclui todas as autorizações da função de leitor de retalho, juntamente com as autorizações adicionais da função de editor de retalho. Da mesma forma, a função de administrador de retalho inclui todas as autorizações da função de editor de retalho, juntamente com as respetivas autorizações adicionais.

As funções básicas (proprietário, editor e leitor) concedem autorizações em todas as Google Cloud. As funções específicas do Vertex AI Search para comércio fornecem apenas autorizações do Vertex AI Search para comércio, exceto as seguintes autorizações Google Cloud (Google Cloud), que são necessárias para a utilizaçãoGoogle Cloud geral:

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

A tabela seguinte apresenta as funções predefinidas disponíveis para o Vertex AI Search for commerce, juntamente com as respetivas autorizações do Vertex AI Search for commerce:

Ver tabela

Nome	Autorizações do Vertex AI Search for commerce	Descrição
Projeto > Proprietário	All retail permissions	Acesso e controlo total de todos os Google Cloud recursos; gerir o acesso dos utilizadores e configurar a faturação de um projeto.
Projeto > Editor	Todas as autorizações, exceto as autorizações na função de administrador de retalho.retail	Acesso de leitura e escrita a todos os recursos do Google Cloud Vertex AI Search para comércio (exceto a capacidade de modificar autorizações e faturação).
Projeto > Leitor	retail.*.get retail.*.list	Acesso só de leitura a todos os Google Cloud recursos, incluindo recursos do Vertex AI Search para comércio.
Administrador de retalho	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 Esta função também inclui todas as autorizações das funções de editor de retalho e visitante de retalho.	Controlo total de todos os recursos do Vertex AI Search for commerce.
Editor de retalho	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 Esta função também inclui todas as autorizações da função de visitante de retalho.	Pode ler todos os recursos do Vertex AI Search for commerce e escrever products, events e outros recursos.
Visualizador de retalho	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	Acesso só de leitura a todos os recursos do Vertex AI Search para comércio.
Aprovador de comerciante de retalho	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	Pode aprovar conteúdo na consola de merchandising.
Criador de comerciantes de retalho	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	Pode criar conteúdo na consola de merchandising.

Migre autorizações da API Recommendations

Se estiver a migrar da API Recommendations Engine anterior para o Vertex AI Search for commerce, tenha em atenção que as seguintes funções predefinidas também incluem autorizações para a API anterior.

• Administrador de retalho: inclui todas as autorizações do administrador de recomendações, exceto as autorizações apiKeys.
• Editor de retalho: inclui todas as autorizações do editor de recomendações, bem como as autorizações catalog.update, e exclui as autorizações apiKeys.
• Visitante de retalho: inclui todas as autorizações do visitante de recomendações.

Faça a gestão do IAM do Vertex AI Search for commerce

Pode obter e definir políticas e funções do IAM através da Google Cloud consola, dos métodos do IAM da API ou da Vertex AI Search for commerce. Para mais informações, consulte o artigo Conceder, alterar e revogar o acesso.

O que se segue?

• Saiba como conceder e revogar o acesso.
• Saiba mais sobre a IAM.
• Saiba mais acerca das funções básicas.
• Saiba mais acerca das funções personalizadas.