Retail API roles and permissions
Stay organized with collections Save and categorize content based on your preferences.

This page lists the IAM roles and permissions for Retail API. To search through all roles and permissions, see the role and permission index.

Retail API roles

Role Permissions

Role	Permissions
Retail Admin (`roles/retail.admin`) Full access to Retail api resources.	`automlrecommendations.apiKeys.create` `automlrecommendations.apiKeys.delete` `automlrecommendations.catalogItems.` `automlrecommendations.catalogItems.create` `automlrecommendations.catalogItems.delete` `automlrecommendations.catalogItems.get` `automlrecommendations.catalogItems.list` `automlrecommendations.catalogItems.update` `automlrecommendations.catalogs.` `automlrecommendations.catalogs.getStats` `automlrecommendations.catalogs.list` `automlrecommendations.catalogs.update` `automlrecommendations.eventStores.getStats` `automlrecommendations.events.create` `automlrecommendations.events.list` `automlrecommendations.events.purge` `automlrecommendations.events.rejoin` `automlrecommendations.placements.` `automlrecommendations.placements.create` `automlrecommendations.placements.delete` `automlrecommendations.placements.getStats` `automlrecommendations.placements.list` `automlrecommendations.recommendations.` `automlrecommendations.recommendations.create` `automlrecommendations.recommendations.delete` `automlrecommendations.recommendations.list` `automlrecommendations.recommendations.pause` `automlrecommendations.recommendations.resume` `automlrecommendations.recommendations.update` `retail.alertConfigs.` `retail.alertConfigs.get` `retail.alertConfigs.update` `retail.attributesConfigs.` `retail.attributesConfigs.addCatalogAttribute` `retail.attributesConfigs.batchRemoveCatalogAttributes` `retail.attributesConfigs.exportCatalogAttributes` `retail.attributesConfigs.get` `retail.attributesConfigs.importCatalogAttributes` `retail.attributesConfigs.removeCatalogAttribute` `retail.attributesConfigs.replaceCatalogAttribute` `retail.attributesConfigs.update` `retail.branches.` `retail.branches.get` `retail.branches.list` `retail.catalogs.` `retail.catalogs.completeQuery` `retail.catalogs.exportAnalyticsMetrics` `retail.catalogs.get` `retail.catalogs.import` `retail.catalogs.list` `retail.catalogs.update` `retail.controls.` `retail.controls.create` `retail.controls.delete` `retail.controls.export` `retail.controls.get` `retail.controls.import` `retail.controls.list` `retail.controls.update` `retail.experiments.` `retail.experiments.create` `retail.experiments.delete` `retail.experiments.get` `retail.experiments.list` `retail.experiments.loadExperimentLookerDashboard` `retail.experiments.queryTrafficMetrics` `retail.experiments.update` `retail.models.` `retail.models.create` `retail.models.delete` `retail.models.get` `retail.models.list` `retail.models.pause` `retail.models.resume` `retail.models.tune` `retail.models.update` `retail.operations.` `retail.operations.get` `retail.operations.list` `retail.placements.` `retail.placements.predict` `retail.placements.search` `retail.products.` `retail.products.create` `retail.products.delete` `retail.products.export` `retail.products.get` `retail.products.import` `retail.products.list` `retail.products.purge` `retail.products.setSponsorship` `retail.products.update` `retail.retailProjects.` `retail.retailProjects.acceptDataTerms` `retail.retailProjects.get` `retail.servingConfigs.` `retail.servingConfigs.create` `retail.servingConfigs.delete` `retail.servingConfigs.get` `retail.servingConfigs.list` `retail.servingConfigs.predict` `retail.servingConfigs.search` `retail.servingConfigs.update` `retail.userEvents.*` `retail.userEvents.create` `retail.userEvents.import` `retail.userEvents.purge` `retail.userEvents.rejoin`
Retail Editor (`roles/retail.editor`) Full access to Retail api resources except purge, rejoin, and setSponsorship.	`automlrecommendations.apiKeys.create` `automlrecommendations.apiKeys.delete` `automlrecommendations.catalogItems.` `automlrecommendations.catalogItems.create` `automlrecommendations.catalogItems.delete` `automlrecommendations.catalogItems.get` `automlrecommendations.catalogItems.list` `automlrecommendations.catalogItems.update` `automlrecommendations.catalogs.` `automlrecommendations.catalogs.getStats` `automlrecommendations.catalogs.list` `automlrecommendations.catalogs.update` `automlrecommendations.eventStores.getStats` `automlrecommendations.events.create` `automlrecommendations.events.list` `automlrecommendations.placements.` `automlrecommendations.placements.create` `automlrecommendations.placements.delete` `automlrecommendations.placements.getStats` `automlrecommendations.placements.list` `automlrecommendations.recommendations.` `automlrecommendations.recommendations.create` `automlrecommendations.recommendations.delete` `automlrecommendations.recommendations.list` `automlrecommendations.recommendations.pause` `automlrecommendations.recommendations.resume` `automlrecommendations.recommendations.update` `retail.alertConfigs.` `retail.alertConfigs.get` `retail.alertConfigs.update` `retail.attributesConfigs.addCatalogAttribute` `retail.attributesConfigs.exportCatalogAttributes` `retail.attributesConfigs.get` `retail.attributesConfigs.importCatalogAttributes` `retail.attributesConfigs.replaceCatalogAttribute` `retail.attributesConfigs.update` `retail.branches.` `retail.branches.get` `retail.branches.list` `retail.catalogs.` `retail.catalogs.completeQuery` `retail.catalogs.exportAnalyticsMetrics` `retail.catalogs.get` `retail.catalogs.import` `retail.catalogs.list` `retail.catalogs.update` `retail.controls.` `retail.controls.create` `retail.controls.delete` `retail.controls.export` `retail.controls.get` `retail.controls.import` `retail.controls.list` `retail.controls.update` `retail.experiments.` `retail.experiments.create` `retail.experiments.delete` `retail.experiments.get` `retail.experiments.list` `retail.experiments.loadExperimentLookerDashboard` `retail.experiments.queryTrafficMetrics` `retail.experiments.update` `retail.models.` `retail.models.create` `retail.models.delete` `retail.models.get` `retail.models.list` `retail.models.pause` `retail.models.resume` `retail.models.tune` `retail.models.update` `retail.operations.` `retail.operations.get` `retail.operations.list` `retail.placements.` `retail.placements.predict` `retail.placements.search` `retail.products.create` `retail.products.delete` `retail.products.export` `retail.products.get` `retail.products.import` `retail.products.list` `retail.products.update` `retail.retailProjects.get` `retail.servingConfigs.*` `retail.servingConfigs.create` `retail.servingConfigs.delete` `retail.servingConfigs.get` `retail.servingConfigs.list` `retail.servingConfigs.predict` `retail.servingConfigs.search` `retail.servingConfigs.update` `retail.userEvents.create` `retail.userEvents.import`
Retail Merchant Approver ^Beta (`roles/retail.merchantApprover`) Grants access and approval rights to MerchantControls in the merchant console.	`retail.attributesConfigs.get` `retail.merchantControls.*` `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.servingConfigs.list` `retail.servingConfigs.search`
Retail Merchant Creator ^Beta (`roles/retail.merchantCreator`) Grants access to own MerchantControls in the merchant console.	`retail.attributesConfigs.get` `retail.merchantControls.creatorCreate` `retail.merchantControls.creatorDelete` `retail.merchantControls.creatorGet` `retail.merchantControls.creatorList` `retail.merchantControls.creatorSubmit` `retail.merchantControls.creatorUpdate` `retail.servingConfigs.search`
Retail Service Agent (`roles/retail.serviceAgent`) Retail service uploads product feeds and user events from Cloud Storage and BigQuery, reports results to the customer Cloud Storage bucket, writes logs to customer projects, and writes and reads Google Cloud Observability metrics for customer projects. Warning: Do not grant service agent roles to any principals except service agents.	`bigquery.datasets.create` `bigquery.datasets.get` `bigquery.jobs.create` `bigquery.jobs.get` `bigquery.jobs.list` `bigquery.jobs.update` `bigquery.tables.create` `bigquery.tables.export` `bigquery.tables.get` `bigquery.tables.getData` `bigquery.tables.list` `bigquery.tables.update` `bigquery.tables.updateData` `cloudnotifications.activities.list` `dataflow.jobs.` `dataflow.jobs.cancel` `dataflow.jobs.create` `dataflow.jobs.get` `dataflow.jobs.list` `dataflow.jobs.snapshot` `dataflow.jobs.updateContents` `dataflow.messages.list` `dataflow.metrics.get` `logging.logEntries.create` `logging.logEntries.route` `monitoring.alertPolicies.get` `monitoring.alertPolicies.list` `monitoring.alertPolicies.listEffectiveTags` `monitoring.alertPolicies.listTagBindings` `monitoring.dashboards.get` `monitoring.dashboards.list` `monitoring.groups.get` `monitoring.groups.list` `monitoring.metricDescriptors.create` `monitoring.metricDescriptors.get` `monitoring.metricDescriptors.list` `monitoring.monitoredResourceDescriptors.` `monitoring.monitoredResourceDescriptors.get` `monitoring.monitoredResourceDescriptors.list` `monitoring.notificationChannelDescriptors.` `monitoring.notificationChannelDescriptors.get` `monitoring.notificationChannelDescriptors.list` `monitoring.notificationChannels.get` `monitoring.notificationChannels.list` `monitoring.services.get` `monitoring.services.list` `monitoring.slos.get` `monitoring.slos.list` `monitoring.snoozes.get` `monitoring.snoozes.list` `monitoring.timeSeries.` `monitoring.timeSeries.create` `monitoring.timeSeries.list` `monitoring.uptimeCheckConfigs.get` `monitoring.uptimeCheckConfigs.list` `opsconfigmonitoring.resourceMetadata.list` `resourcemanager.projects.get` `resourcemanager.projects.list` `stackdriver.projects.get` `stackdriver.resourceMetadata.list` `storage.buckets.create` `storage.buckets.get` `storage.objects.create` `storage.objects.delete` `storage.objects.get` `storage.objects.list` `storage.objects.update`
Retail Viewer (`roles/retail.viewer`) Grants access to read all resources in Retail.	`automlrecommendations.catalogItems.get` `automlrecommendations.catalogItems.list` `automlrecommendations.catalogs.getStats` `automlrecommendations.catalogs.list` `automlrecommendations.eventStores.getStats` `automlrecommendations.events.list` `automlrecommendations.placements.getStats` `automlrecommendations.placements.list` `automlrecommendations.recommendations.list` `retail.alertConfigs.get` `retail.attributesConfigs.exportCatalogAttributes` `retail.attributesConfigs.get` `retail.branches.` `retail.branches.get` `retail.branches.list` `retail.catalogs.completeQuery` `retail.catalogs.exportAnalyticsMetrics` `retail.catalogs.get` `retail.catalogs.list` `retail.controls.export` `retail.controls.get` `retail.controls.list` `retail.experiments.get` `retail.experiments.list` `retail.experiments.loadExperimentLookerDashboard` `retail.experiments.queryTrafficMetrics` `retail.models.get` `retail.models.list` `retail.operations.` `retail.operations.get` `retail.operations.list` `retail.placements.*` `retail.placements.predict` `retail.placements.search` `retail.products.export` `retail.products.get` `retail.products.list` `retail.retailProjects.get` `retail.servingConfigs.get` `retail.servingConfigs.list` `retail.servingConfigs.predict` `retail.servingConfigs.search`

Retail Admin

(roles/retail.admin)

Full access to Retail api resources.

automlrecommendations.apiKeys.create

automlrecommendations.apiKeys.delete

automlrecommendations.catalogItems.*

automlrecommendations.catalogItems.create
automlrecommendations.catalogItems.delete
automlrecommendations.catalogItems.get
automlrecommendations.catalogItems.list
automlrecommendations.catalogItems.update

automlrecommendations.catalogs.*

automlrecommendations.catalogs.getStats
automlrecommendations.catalogs.list
automlrecommendations.catalogs.update

automlrecommendations.eventStores.getStats

automlrecommendations.events.create

automlrecommendations.events.list

automlrecommendations.events.purge

automlrecommendations.events.rejoin

automlrecommendations.placements.*

automlrecommendations.placements.create
automlrecommendations.placements.delete
automlrecommendations.placements.getStats
automlrecommendations.placements.list

automlrecommendations.recommendations.*

automlrecommendations.recommendations.create
automlrecommendations.recommendations.delete
automlrecommendations.recommendations.list
automlrecommendations.recommendations.pause
automlrecommendations.recommendations.resume
automlrecommendations.recommendations.update

retail.alertConfigs.*

retail.alertConfigs.get
retail.alertConfigs.update

retail.attributesConfigs.*

retail.attributesConfigs.addCatalogAttribute
retail.attributesConfigs.batchRemoveCatalogAttributes
retail.attributesConfigs.exportCatalogAttributes
retail.attributesConfigs.get
retail.attributesConfigs.importCatalogAttributes
retail.attributesConfigs.removeCatalogAttribute
retail.attributesConfigs.replaceCatalogAttribute
retail.attributesConfigs.update

retail.branches.*

retail.branches.get
retail.branches.list

retail.catalogs.*

retail.catalogs.completeQuery
retail.catalogs.exportAnalyticsMetrics
retail.catalogs.get
retail.catalogs.import
retail.catalogs.list
retail.catalogs.update

retail.controls.*

retail.controls.create
retail.controls.delete
retail.controls.export
retail.controls.get
retail.controls.import
retail.controls.list
retail.controls.update

retail.experiments.*

retail.experiments.create
retail.experiments.delete
retail.experiments.get
retail.experiments.list
retail.experiments.loadExperimentLookerDashboard
retail.experiments.queryTrafficMetrics
retail.experiments.update

retail.models.*

retail.models.create
retail.models.delete
retail.models.get
retail.models.list
retail.models.pause
retail.models.resume
retail.models.tune
retail.models.update

retail.operations.*

retail.operations.get
retail.operations.list

retail.placements.*

retail.placements.predict
retail.placements.search

retail.products.*

retail.products.create
retail.products.delete
retail.products.export
retail.products.get
retail.products.import
retail.products.list
retail.products.purge
retail.products.setSponsorship
retail.products.update

retail.retailProjects.*

retail.retailProjects.acceptDataTerms
retail.retailProjects.get

retail.servingConfigs.*

retail.servingConfigs.create
retail.servingConfigs.delete
retail.servingConfigs.get
retail.servingConfigs.list
retail.servingConfigs.predict
retail.servingConfigs.search
retail.servingConfigs.update

retail.userEvents.*

retail.userEvents.create
retail.userEvents.import
retail.userEvents.purge
retail.userEvents.rejoin

Retail Editor

(roles/retail.editor)

Full access to Retail api resources except purge, rejoin, and setSponsorship.

automlrecommendations.apiKeys.create

automlrecommendations.apiKeys.delete

automlrecommendations.catalogItems.*

automlrecommendations.catalogItems.create
automlrecommendations.catalogItems.delete
automlrecommendations.catalogItems.get
automlrecommendations.catalogItems.list
automlrecommendations.catalogItems.update

automlrecommendations.catalogs.*

automlrecommendations.catalogs.getStats
automlrecommendations.catalogs.list
automlrecommendations.catalogs.update

automlrecommendations.eventStores.getStats

automlrecommendations.events.create

automlrecommendations.events.list

automlrecommendations.placements.*

automlrecommendations.placements.create
automlrecommendations.placements.delete
automlrecommendations.placements.getStats
automlrecommendations.placements.list

automlrecommendations.recommendations.*

automlrecommendations.recommendations.create
automlrecommendations.recommendations.delete
automlrecommendations.recommendations.list
automlrecommendations.recommendations.pause
automlrecommendations.recommendations.resume
automlrecommendations.recommendations.update

retail.alertConfigs.*

retail.alertConfigs.get
retail.alertConfigs.update

retail.attributesConfigs.addCatalogAttribute

retail.attributesConfigs.exportCatalogAttributes

retail.attributesConfigs.get

retail.attributesConfigs.importCatalogAttributes

retail.attributesConfigs.replaceCatalogAttribute

retail.attributesConfigs.update

retail.branches.*

retail.branches.get
retail.branches.list

retail.catalogs.*

retail.catalogs.completeQuery
retail.catalogs.exportAnalyticsMetrics
retail.catalogs.get
retail.catalogs.import
retail.catalogs.list
retail.catalogs.update

retail.controls.*

retail.controls.create
retail.controls.delete
retail.controls.export
retail.controls.get
retail.controls.import
retail.controls.list
retail.controls.update

retail.experiments.*

retail.experiments.create
retail.experiments.delete
retail.experiments.get
retail.experiments.list
retail.experiments.loadExperimentLookerDashboard
retail.experiments.queryTrafficMetrics
retail.experiments.update

retail.models.*

retail.models.create
retail.models.delete
retail.models.get
retail.models.list
retail.models.pause
retail.models.resume
retail.models.tune
retail.models.update

retail.operations.*

retail.operations.get
retail.operations.list

retail.placements.*

retail.placements.predict
retail.placements.search

retail.products.create

retail.products.delete

retail.products.export

retail.products.get

retail.products.import

retail.products.list

retail.products.update

retail.retailProjects.get

retail.servingConfigs.*

retail.servingConfigs.create
retail.servingConfigs.delete
retail.servingConfigs.get
retail.servingConfigs.list
retail.servingConfigs.predict
retail.servingConfigs.search
retail.servingConfigs.update

retail.userEvents.create

retail.userEvents.import

Retail Merchant Approver ^Beta

(roles/retail.merchantApprover)

Grants access and approval rights to MerchantControls in the merchant console.

retail.attributesConfigs.get

retail.merchantControls.*

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.servingConfigs.list

retail.servingConfigs.search

Retail Merchant Creator ^Beta

(roles/retail.merchantCreator)

Grants access to own MerchantControls in the merchant console.

retail.attributesConfigs.get

retail.merchantControls.creatorCreate

retail.merchantControls.creatorDelete

retail.merchantControls.creatorGet

retail.merchantControls.creatorList

retail.merchantControls.creatorSubmit

retail.merchantControls.creatorUpdate

retail.servingConfigs.search

Retail Service Agent

(roles/retail.serviceAgent)

Retail service uploads product feeds and user events from Cloud Storage and BigQuery, reports results to the customer Cloud Storage bucket, writes logs to customer projects, and writes and reads Google Cloud Observability metrics for customer projects.

bigquery.datasets.create

bigquery.datasets.get

bigquery.jobs.create

bigquery.jobs.get

bigquery.jobs.list

bigquery.jobs.update

bigquery.tables.create

bigquery.tables.export

bigquery.tables.get

bigquery.tables.getData

bigquery.tables.list

bigquery.tables.update

bigquery.tables.updateData

cloudnotifications.activities.list

dataflow.jobs.*

dataflow.jobs.cancel
dataflow.jobs.create
dataflow.jobs.get
dataflow.jobs.list
dataflow.jobs.snapshot
dataflow.jobs.updateContents

dataflow.messages.list

dataflow.metrics.get

logging.logEntries.create

logging.logEntries.route

monitoring.alertPolicies.get

monitoring.alertPolicies.list

monitoring.alertPolicies.listEffectiveTags

monitoring.alertPolicies.listTagBindings

monitoring.dashboards.get

monitoring.dashboards.list

monitoring.groups.get

monitoring.groups.list

monitoring.metricDescriptors.create

monitoring.metricDescriptors.get

monitoring.metricDescriptors.list

monitoring.monitoredResourceDescriptors.*

monitoring.monitoredResourceDescriptors.get
monitoring.monitoredResourceDescriptors.list

monitoring.notificationChannelDescriptors.*

monitoring.notificationChannelDescriptors.get
monitoring.notificationChannelDescriptors.list

monitoring.notificationChannels.get

monitoring.notificationChannels.list

monitoring.services.get

monitoring.services.list

monitoring.slos.get

monitoring.slos.list

monitoring.snoozes.get

monitoring.snoozes.list

monitoring.timeSeries.*

monitoring.timeSeries.create
monitoring.timeSeries.list

monitoring.uptimeCheckConfigs.get

monitoring.uptimeCheckConfigs.list

opsconfigmonitoring.resourceMetadata.list

resourcemanager.projects.get

resourcemanager.projects.list

stackdriver.projects.get

stackdriver.resourceMetadata.list

storage.buckets.create

storage.buckets.get

storage.objects.create

storage.objects.delete

storage.objects.get

storage.objects.list

storage.objects.update

Retail Viewer

(roles/retail.viewer)

Grants access to read all resources in Retail.

automlrecommendations.catalogItems.get

automlrecommendations.catalogItems.list

automlrecommendations.catalogs.getStats

automlrecommendations.catalogs.list

automlrecommendations.eventStores.getStats

automlrecommendations.events.list

automlrecommendations.placements.getStats

automlrecommendations.placements.list

automlrecommendations.recommendations.list

retail.alertConfigs.get

retail.attributesConfigs.exportCatalogAttributes

retail.attributesConfigs.get

retail.branches.*

retail.branches.get
retail.branches.list

retail.catalogs.completeQuery

retail.catalogs.exportAnalyticsMetrics

retail.catalogs.get

retail.catalogs.list

retail.controls.export

retail.controls.get

retail.controls.list

retail.experiments.get

retail.experiments.list

retail.experiments.loadExperimentLookerDashboard

retail.experiments.queryTrafficMetrics

retail.models.get

retail.models.list

retail.operations.*

retail.operations.get
retail.operations.list

retail.placements.*

retail.placements.predict
retail.placements.search

retail.products.export

retail.products.get

retail.products.list

retail.retailProjects.get

retail.servingConfigs.get

retail.servingConfigs.list

retail.servingConfigs.predict

retail.servingConfigs.search

Retail API permissions

Permission	Included in roles
`retail.alertConfigs.get`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.alertConfigs.update`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.attributesConfigs.addCatalogAttribute`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.attributesConfigs.batchRemoveCatalogAttributes`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`)
`retail.attributesConfigs.exportCatalogAttributes`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.attributesConfigs.get`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Merchant Approver (`roles/retail.merchantApprover`) Retail Merchant Creator (`roles/retail.merchantCreator`) Retail Viewer (`roles/retail.viewer`)
`retail.attributesConfigs.importCatalogAttributes`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.attributesConfigs.removeCatalogAttribute`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`)
`retail.attributesConfigs.replaceCatalogAttribute`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.attributesConfigs.update`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.branches.get`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.branches.list`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Security Admin (`roles/iam.securityAdmin`) Security Reviewer (`roles/iam.securityReviewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.catalogs.completeQuery`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.catalogs.exportAnalyticsMetrics`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.catalogs.get`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.catalogs.import`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.catalogs.list`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Admin Viewer (`roles/automlrecommendations.adminViewer`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Recommendations AI Viewer (`roles/automlrecommendations.viewer`) Security Admin (`roles/iam.securityAdmin`) Security Reviewer (`roles/iam.securityReviewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.catalogs.update`	Owner (`roles/owner`) Editor (`roles/editor`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.controls.create`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.controls.delete`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.controls.export`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.controls.get`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.controls.import`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.controls.list`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Security Admin (`roles/iam.securityAdmin`) Security Reviewer (`roles/iam.securityReviewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.controls.update`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.experiments.create`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.experiments.delete`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.experiments.get`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.experiments.list`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Security Admin (`roles/iam.securityAdmin`) Security Reviewer (`roles/iam.securityReviewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.experiments.loadExperimentLookerDashboard`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.experiments.queryTrafficMetrics`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.experiments.update`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.merchantControls.approverDelete`	Owner (`roles/owner`) Retail Merchant Approver (`roles/retail.merchantApprover`)
`retail.merchantControls.approverGet`	Owner (`roles/owner`) Retail Merchant Approver (`roles/retail.merchantApprover`)
`retail.merchantControls.approverList`	Owner (`roles/owner`) Retail Merchant Approver (`roles/retail.merchantApprover`)
`retail.merchantControls.approverUpdate`	Owner (`roles/owner`) Retail Merchant Approver (`roles/retail.merchantApprover`)
`retail.merchantControls.creatorCreate`	Owner (`roles/owner`) Retail Merchant Approver (`roles/retail.merchantApprover`) Retail Merchant Creator (`roles/retail.merchantCreator`)
`retail.merchantControls.creatorDelete`	Owner (`roles/owner`) Retail Merchant Approver (`roles/retail.merchantApprover`) Retail Merchant Creator (`roles/retail.merchantCreator`)
`retail.merchantControls.creatorGet`	Owner (`roles/owner`) Retail Merchant Approver (`roles/retail.merchantApprover`) Retail Merchant Creator (`roles/retail.merchantCreator`)
`retail.merchantControls.creatorList`	Owner (`roles/owner`) Retail Merchant Approver (`roles/retail.merchantApprover`) Retail Merchant Creator (`roles/retail.merchantCreator`)
`retail.merchantControls.creatorSubmit`	Owner (`roles/owner`) Retail Merchant Approver (`roles/retail.merchantApprover`) Retail Merchant Creator (`roles/retail.merchantCreator`)
`retail.merchantControls.creatorUpdate`	Owner (`roles/owner`) Retail Merchant Approver (`roles/retail.merchantApprover`) Retail Merchant Creator (`roles/retail.merchantCreator`)
`retail.models.create`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.models.delete`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.models.get`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.models.list`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Security Admin (`roles/iam.securityAdmin`) Security Reviewer (`roles/iam.securityReviewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.models.pause`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.models.resume`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.models.tune`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.models.update`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.operations.get`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Admin Viewer (`roles/automlrecommendations.adminViewer`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Recommendations AI Viewer (`roles/automlrecommendations.viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.operations.list`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Admin Viewer (`roles/automlrecommendations.adminViewer`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Recommendations AI Viewer (`roles/automlrecommendations.viewer`) Security Admin (`roles/iam.securityAdmin`) Security Reviewer (`roles/iam.securityReviewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.placements.predict`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Admin Viewer (`roles/automlrecommendations.adminViewer`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Recommendations AI Viewer (`roles/automlrecommendations.viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.placements.search`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Admin Viewer (`roles/automlrecommendations.adminViewer`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Recommendations AI Viewer (`roles/automlrecommendations.viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.products.create`	Owner (`roles/owner`) Editor (`roles/editor`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.products.delete`	Owner (`roles/owner`) Editor (`roles/editor`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.products.export`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Admin Viewer (`roles/automlrecommendations.adminViewer`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Recommendations AI Viewer (`roles/automlrecommendations.viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.products.get`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Admin Viewer (`roles/automlrecommendations.adminViewer`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Recommendations AI Viewer (`roles/automlrecommendations.viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.products.import`	Owner (`roles/owner`) Editor (`roles/editor`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.products.list`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Admin Viewer (`roles/automlrecommendations.adminViewer`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Recommendations AI Viewer (`roles/automlrecommendations.viewer`) Security Admin (`roles/iam.securityAdmin`) Security Reviewer (`roles/iam.securityReviewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.products.purge`	Owner (`roles/owner`) Editor (`roles/editor`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Retail Admin (`roles/retail.admin`)
`retail.products.setSponsorship`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`)
`retail.products.update`	Owner (`roles/owner`) Editor (`roles/editor`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.retailProjects.acceptDataTerms`	Owner (`roles/owner`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Retail Admin (`roles/retail.admin`)
`retail.retailProjects.get`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Admin Viewer (`roles/automlrecommendations.adminViewer`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Recommendations AI Viewer (`roles/automlrecommendations.viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.servingConfigs.create`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.servingConfigs.delete`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.servingConfigs.get`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.servingConfigs.list`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Security Admin (`roles/iam.securityAdmin`) Security Reviewer (`roles/iam.securityReviewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Merchant Approver (`roles/retail.merchantApprover`) Retail Viewer (`roles/retail.viewer`)
`retail.servingConfigs.predict`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Viewer (`roles/retail.viewer`)
`retail.servingConfigs.search`	Owner (`roles/owner`) Editor (`roles/editor`) Viewer (`roles/viewer`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`) Retail Merchant Approver (`roles/retail.merchantApprover`) Retail Merchant Creator (`roles/retail.merchantCreator`) Retail Viewer (`roles/retail.viewer`)
`retail.servingConfigs.update`	Owner (`roles/owner`) Editor (`roles/editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.userEvents.create`	Owner (`roles/owner`) Editor (`roles/editor`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.userEvents.import`	Owner (`roles/owner`) Editor (`roles/editor`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Recommendations AI Editor (`roles/automlrecommendations.editor`) Retail Admin (`roles/retail.admin`) Retail Editor (`roles/retail.editor`)
`retail.userEvents.purge`	Owner (`roles/owner`) Editor (`roles/editor`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Retail Admin (`roles/retail.admin`)
`retail.userEvents.rejoin`	Owner (`roles/owner`) Editor (`roles/editor`) Recommendations AI Admin (`roles/automlrecommendations.admin`) Retail Admin (`roles/retail.admin`)

Retail API roles and permissions Stay organized with collections Save and categorize content based on your preferences.

Retail API roles

Retail Admin

Retail Editor

Retail Merchant Approver Beta

Retail Merchant Creator Beta

Retail Service Agent

Retail Viewer

Retail API permissions

retail.alertConfigs.get

retail.alertConfigs.update

retail.attributesConfigs.addCatalogAttribute

retail.attributesConfigs.batchRemoveCatalogAttributes

retail.attributesConfigs.exportCatalogAttributes

retail.attributesConfigs.get

retail.attributesConfigs.importCatalogAttributes

retail.attributesConfigs.removeCatalogAttribute

retail.attributesConfigs.replaceCatalogAttribute

retail.attributesConfigs.update

retail.branches.get

retail.branches.list

retail.catalogs.completeQuery

retail.catalogs.exportAnalyticsMetrics

retail.catalogs.get

retail.catalogs.import

retail.catalogs.list

retail.catalogs.update

retail.controls.create

retail.controls.delete

retail.controls.export

retail.controls.get

retail.controls.import

retail.controls.list

retail.controls.update

retail.experiments.create

retail.experiments.delete

retail.experiments.get

retail.experiments.list

retail.experiments.loadExperimentLookerDashboard

retail.experiments.queryTrafficMetrics

retail.experiments.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.models.create

retail.models.delete

retail.models.get

retail.models.list

retail.models.pause

retail.models.resume

retail.models.tune

retail.models.update

retail.operations.get

retail.operations.list

retail.placements.predict

retail.placements.search

retail.products.create

retail.products.delete

retail.products.export

retail.products.get

retail.products.import

retail.products.list

retail.products.purge

retail.products.setSponsorship

retail.products.update

retail.retailProjects.acceptDataTerms

retail.retailProjects.get

retail.servingConfigs.create

retail.servingConfigs.delete

retail.servingConfigs.get

retail.servingConfigs.list

retail.servingConfigs.predict

retail.servingConfigs.search

Retail API roles and permissions
Stay organized with collections Save and categorize content based on your preferences.

Retail Merchant Approver ^Beta

Retail Merchant Creator ^Beta

`retail.alertConfigs.get`

`retail.alertConfigs.update`

`retail.attributesConfigs.addCatalogAttribute`

`retail.attributesConfigs.batchRemoveCatalogAttributes`

`retail.attributesConfigs.exportCatalogAttributes`

`retail.attributesConfigs.get`

`retail.attributesConfigs.importCatalogAttributes`

`retail.attributesConfigs.removeCatalogAttribute`

`retail.attributesConfigs.replaceCatalogAttribute`

`retail.attributesConfigs.update`

`retail.branches.get`

`retail.branches.list`

`retail.catalogs.completeQuery`

`retail.catalogs.exportAnalyticsMetrics`

`retail.catalogs.get`

`retail.catalogs.import`

`retail.catalogs.list`

`retail.catalogs.update`

`retail.controls.create`

`retail.controls.delete`

`retail.controls.export`

`retail.controls.get`

`retail.controls.import`

`retail.controls.list`

`retail.controls.update`

`retail.experiments.create`

`retail.experiments.delete`

`retail.experiments.get`

`retail.experiments.list`

`retail.experiments.loadExperimentLookerDashboard`

`retail.experiments.queryTrafficMetrics`

`retail.experiments.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.models.create`

`retail.models.delete`

`retail.models.get`

`retail.models.list`

`retail.models.pause`

`retail.models.resume`

`retail.models.tune`

`retail.models.update`

`retail.operations.get`

`retail.operations.list`

`retail.placements.predict`

`retail.placements.search`

`retail.products.create`

`retail.products.delete`

`retail.products.export`

`retail.products.get`

`retail.products.import`

`retail.products.list`

`retail.products.purge`

`retail.products.setSponsorship`

`retail.products.update`

`retail.retailProjects.acceptDataTerms`

`retail.retailProjects.get`

`retail.servingConfigs.create`

`retail.servingConfigs.delete`

`retail.servingConfigs.get`

`retail.servingConfigs.list`

`retail.servingConfigs.predict`

`retail.servingConfigs.search`

`retail.servingConfigs.update`

`retail.userEvents.create`

`retail.userEvents.import`

`retail.userEvents.purge`

`retail.userEvents.rejoin`