REST Resource: accounts.user_permissions
Stay organized with collections
Save and categorize content based on your preferences.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-06 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-06 UTC."],[],[],null,["- [Resource: UserPermission](#UserPermission)\n - [JSON representation](#UserPermission.SCHEMA_REPRESENTATION)\n- [AccountAccess](#AccountAccess)\n - [JSON representation](#AccountAccess.SCHEMA_REPRESENTATION)\n- [AccountPermission](#AccountPermission)\n- [ContainerAccess](#ContainerAccess)\n - [JSON representation](#ContainerAccess.SCHEMA_REPRESENTATION)\n- [ContainerPermission](#ContainerPermission)\n- [Methods](#METHODS_SUMMARY)\n\nResource: UserPermission Represents a user's permissions to an account and its container.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"path\": string, \"accountId\": string, \"emailAddress\": string, \"accountAccess\": { object (/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions#AccountAccess) }, \"containerAccess\": [ { object (/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions#ContainerAccess) } ] } ``` |\n\n| Fields ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `path` | `string` GTM UserPermission's API relative path. |\n| `accountId` | `string` The Account ID uniquely identifies the GTM Account. |\n| `emailAddress` | `string` User's email address. |\n| `accountAccess` | `object (`[AccountAccess](/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions#AccountAccess)`)` GTM Account access permissions. |\n| `containerAccess[]` | `object (`[ContainerAccess](/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions#ContainerAccess)`)` GTM Container access permissions. |\n\nAccountAccess Defines the Google Tag Manager Account access permissions.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"permission\": enum (/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions#AccountPermission) } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `permission` | `enum (`[AccountPermission](/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions#AccountPermission)`)` Whether the user has no access, user access, or admin access to an account. |\n\nAccountPermission\n\n| Enums ||\n|--------------------------------|---|\n| `accountPermissionUnspecified` | |\n| `noAccess` | |\n| `user` | |\n| `admin` | |\n\nContainerAccess Defines the Google Tag Manager Container access permissions.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"containerId\": string, \"permission\": enum (/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions#ContainerPermission) } ``` |\n\n| Fields ||\n|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `containerId` | `string` GTM Container ID. |\n| `permission` | `enum (`[ContainerPermission](/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions#ContainerPermission)`)` List of Container permissions. |\n\nContainerPermission\n\n| Enums ||\n|----------------------------------|---|\n| `containerPermissionUnspecified` | |\n| `noAccess` | |\n| `read` | |\n| `edit` | |\n| `approve` | |\n| `publish` | |\n\n| Methods ||\n|--------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|\n| [create](/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions/create) | Creates a user's Account \\& Container access. |\n| [delete](/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions/delete) | Removes a user from the account, revoking access to it and all of its containers. |\n| [get](/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions/get) | Gets a user's Account \\& Container access. |\n| [list](/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions/list) | List all users that have access to the account along with Account and Container user access granted to each of them. |\n| [update](/tag-platform/tag-manager/api/reference/rest/v2/accounts.user_permissions/update) | Updates a user's Account \\& Container access. |"]]