Identity and Access Management (IAM)

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Nesta página, descrevemos como controlar o acesso e as permissões da Pesquisa do Vertex AI para comércio usando o Identity and Access Management (IAM).

Visão geral

OGoogle Cloud oferece o Gerenciamento de acesso e identidade (IAM), que permite a concessão de acesso mais granular a recursos Google Cloud específicos e impede o acesso indesejado a outros recursos. Nesta página, descrevemos os papéis e as permissões do IAM da Vertex AI para Pesquisa para Commerce. Para uma descrição detalhada do IAM, consulte a documentação do IAM. Google Cloud

A Vertex AI para Pesquisa de Comércio oferece um conjunto de papéis predefinidos projetados para ajudar você a controlar facilmente o acesso aos recursos da Vertex AI para Pesquisa de Comércio. Você também pode criar papéis personalizados próprios, caso os predefinidos não forneçam os conjuntos de permissões necessários. Além disso, os papéis primários mais antigos (Editor, Leitor e Proprietário) também estão disponíveis, mas não fornecem o mesmo controle granular que os papéis da Vertex AI Search for Commerce. Em particular, os papéis básicos fornecem acesso a recursos no Google Cloud , e não apenas para a Vertex AI Search for commerce. Consulte a documentação sobre papéis básicos para mais informações.

Papéis predefinidos

A Vertex AI para Pesquisa para Commerce oferece alguns papéis predefinidos que podem ser usados para fornecer permissões mais granulares aos participantes. O papel concedido a um principal controla quais ações ele pode tomar. Os principais podem ser indivíduos, grupos ou contas de serviço.

Conceda diversos papéis ao mesmo principal. Também é possível alterar os papéis concedidos a um principal a qualquer momento, desde que você tenha permissões para isso.

Os papéis mais amplos incluem os definidos de maneira mais restrita. Por exemplo, no papel de editor de varejo, estão incluídas todas as permissões do papel de leitor de varejo, além das permissões de adição do papel de editor de varejo. Da mesma forma, no papel de administrador, estão todas as permissões do papel de editor, além das respectivas permissões adicionais.

Os papéis básicos (proprietário, editor, leitor) fornecem permissões em Google Cloud. Os papéis específicos da Pesquisa da Vertex AI para Commerce fornecem apenas as permissões da Pesquisa da Vertex AI para Commerce, exceto as seguintes permissões de Google Cloud (Google Cloud), que são necessárias para o uso geral deGoogle Cloud :

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

A tabela a seguir lista os papéis predefinidos disponíveis para a Vertex AI Search for commerce e as permissões dela:

Visualizar tabela

Nome	Permissões da Vertex AI para Pesquisa para comércio	Descrição
Projeto > Proprietário	All retail permissions	Acesso e controle total de todos os recursos Google Cloud , gerenciar o acesso de usuários e configurar o faturamento de um projeto.
Projeto > Editor	Todas as permissões retail, exceto as da função de administrador de varejo.	Acesso de leitura e gravação a todos os recursos da Google Cloud e da Vertex AI Search for Commerce, exceto a capacidade de modificar permissões e faturamento.
Projeto > Leitor	retail.*.get retail.*.list	Acesso somente leitura a todos os recursos Google Cloud , incluindo recursos da Pesquisa da Vertex AI para comércio.
Administrador de varejo	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 automlrecommendations.events.purge automlrecommendations.events.rejoin Esse papel também inclui todas as permissões dos papéis de editor e visualizador do Retail Search.	Controle total de todos os recursos da Vertex AI para Pesquisa para Commerce.
Editor de varejo	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 automlrecommendations.apiKeys.create automlrecommendations.apiKeys.delete retail.alertConfigs.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 Essa função também inclui todas as permissões do papel de leitor de varejo. automlrecommendations.catalogItems.createautomlrecommendations.catalogItems.deleteautomlrecommendations.catalogItems.update	Pode ler todos os recursos da Vertex AI para Pesquisa para comércio e gravar products, events e outros recursos.
Leitor de Varejo	retail.retailProjects.get retail.attributesConfigs.exportCatalogAttributes retail.catalogs.completeQuery retail.catalogs.listProductAttributes retail.controls.export retail.placements.search retail.placements.predict retail.products.export retail.userEvents.export retail.*.get retail.*.list	Acesso somente leitura a todos os recursos da Pesquisa da Vertex AI para comércio.

Migrar permissões da API Recommendations AI

Se você estiver migrando da API Recommendations Engine anterior para a Vertex AI para Pesquisa para comércio, observe que os papéis predefinidos a seguir também incluem permissões para a API anterior.

• Administrador de varejo: inclui todas as permissões de Administrador de recomendações, exceto as permissões apiKeys.
• Editor de varejo: inclui todas as permissões do editor de recomendações, bem como catalog.update, e exclui permissões apiKeys.
• Leitor de varejo: inclui todas as permissões do visualizador de recomendações.

Gerenciar o IAM da Vertex AI para Pesquisa para comércio

É possível receber e definir políticas de permissão e papéis do IAM usando o Console Google Cloud, os métodos do IAM da API ou a Pesquisa da Vertex AI para comércio. Para mais informações, consulte Como conceder, alterar e revogar acesso.

A seguir

• Saiba como conceder e revogar acesso.
• Saiba mais sobre IAM.
• Saiba mais sobre papéis básicos.
• Saiba mais sobre papéis personalizados.