Identity and Access Management (IAM)

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa pagina descrive come puoi controllare l'accesso e le autorizzazioni di Vertex AI Search per il commercio utilizzando Identity and Access Management (IAM).

Panoramica

Google Cloud offre Identity and Access Management (IAM), che ti consente di concedere un accesso più granulare a risorse specifiche e di impedire l'accesso indesiderato ad altre risorse. Google Cloud Questa pagina descrive i ruoli e le autorizzazioni IAM di Vertex AI Search for Commerce. Per una descrizione dettagliata di Google Cloud IAM, consulta la documentazione di IAM.

Vertex AI Search for Commerce fornisce un insieme di ruoli predefiniti progettati per aiutarti a controllare facilmente l'accesso alle risorse di Vertex AI Search for Commerce. Puoi anche creare i tuoi ruoli personalizzati, se i ruoli predefiniti non forniscono gli insiemi di autorizzazioni di cui hai bisogno. Inoltre, sono ancora disponibili anche i ruoli di base precedenti (Editor, Visualizzatore e Proprietario), anche se non offrono lo stesso controllo granulare dei ruoli di Vertex AI Search per il commercio. In particolare, i ruoli di base forniscono accesso alle risorse Google Cloud non solo per Vertex AI Search per il commercio. Per ulteriori informazioni, consulta la documentazione relativa ai ruoli di base.

Ruoli predefiniti

Vertex AI Search for Commerce fornisce alcuni ruoli predefiniti che puoi utilizzare per fornire alle entità autorizzazioni più granulari. Il ruolo concesso a un'entità controlla le azioni che può eseguire. Le entità possono essere persone fisiche, gruppi o account di servizio.

Puoi concedere più ruoli alla stessa entità e puoi modificare i ruoli concessi a un'entità in qualsiasi momento, a condizione di disporre delle autorizzazioni necessarie.

I ruoli più ampi includono i ruoli definiti in modo più limitato. Ad esempio, il ruolo Editor per la vendita al dettaglio include tutte le autorizzazioni del ruolo Visualizzatore per la vendita al dettaglio, oltre alle autorizzazioni aggiuntive del ruolo Editor per la vendita al dettaglio. Analogamente, il ruolo Amministratore vendita al dettaglio include tutte le autorizzazioni del ruolo Editor vendita al dettaglio, oltre alle autorizzazioni aggiuntive.

I ruoli di base (Proprietario, Editor, Visualizzatore) forniscono autorizzazioni per Google Cloud. I ruoli specifici di Vertex AI Search for Commerce forniscono solo le autorizzazioni di Vertex AI Search for Commerce, ad eccezione delle seguenti autorizzazioni Google Cloud (Google Cloud), necessarie per l'utilizzoGoogle Cloud generale:

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

La tabella seguente elenca i ruoli predefiniti disponibili per Vertex AI Search per il commercio, insieme alle relative autorizzazioni:

Visualizza tabella

Nome	Autorizzazioni di Vertex AI Search for Commerce	Descrizione
Progetto > Proprietario	All retail permissions	Accesso e controllo completi per tutte le Google Cloud risorse; gestione dell'accesso degli utenti e configurazione della fatturazione per un progetto.
Progetto > Editor	Tutte le autorizzazioni retail, ad eccezione di quelle nel ruolo Amministratore vendita al dettaglio.	Accesso in lettura/scrittura a tutte le risorse Google Cloud e Vertex AI Search for Commerce (tranne la possibilità di modificare le autorizzazioni e la fatturazione).
Progetto > Visualizzatore	retail.*.get retail.*.list	Accesso di sola lettura a tutte le Google Cloud risorse, incluse le risorse di Vertex AI Search per il commercio.
Retail Admin	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 Questo ruolo include anche tutte le autorizzazioni dei ruoli Editor di Retail e Visualizzatore di Retail.	Controllo completo di tutte le risorse di Vertex AI Search for Commerce.
Retail Editor	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 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 Questo ruolo include anche tutte le autorizzazioni del ruolo Visualizzatore di vendita al dettaglio.	Può leggere tutte le risorse di Vertex AI Search for Commerce e scrivere products, events e altre risorse.
Retail Viewer	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	Accesso di sola lettura a tutte le risorse di Vertex AI Search for Commerce.

Esegui la migrazione delle autorizzazioni dall'API Recommendations AI

Se esegui la migrazione dall'API Recommendations Engine precedente a Vertex AI Search for Commerce, tieni presente che i seguenti ruoli predefiniti includono anche le autorizzazioni per l'API precedente.

• Amministratore di vendita al dettaglio: include tutte le autorizzazioni di Amministrazione dei consigli, ad eccezione delle autorizzazioni apiKeys.
• Editor di negozi: include tutte le autorizzazioni di Recommendations Editor, nonché catalog.update, ed esclude le autorizzazioni apiKeys.
• Retail Viewer: include tutte le autorizzazioni di Recommendations Viewer.

Gestire l'IAM di Vertex AI Search per il commercio

Puoi ottenere e impostare i criteri di autorizzazione IAM e i ruoli IAM utilizzando la Google Cloud console, i metodi IAM dell'API o Vertex AI Search for Commerce. Per ulteriori informazioni, consulta Concedere, modificare e revocare l'accesso.

Passaggi successivi

• Scopri come concedere e revocare l'accesso.
• Scopri di più su IAM.
• Scopri di più sui ruoli di base.
• Scopri di più sui ruoli personalizzati.