Permissions: create

Requiere autorización

Crea los permisos de los recursos Account y Container de un usuario. Pruébalo ahora o consulta un ejemplo.

Solicitud

Solicitud HTTP

POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/permissions

Parámetros

Nombre de parámetro Valor Descripción
Parámetros de ruta
accountId string ID de recurso Account de GTM

Autorización

Esta solicitud requiere autorización con el siguiente ámbito. Consulta más información sobre la autenticación y la autorización.

Ámbito
https://www.googleapis.com/auth/tagmanager.manage.users

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona un recurso Permissions con las siguientes propiedades:

Nombre de la propiedad Valor Descripción Notas
Propiedades obligatorias
accountAccess nested object Permisos de acceso del recurso Account de GTM. editable
accountAccess.permission[] list Lista de permisos del recurso Account. Los permisos válidos son read y manage. editable
emailAddress string Dirección de correo electrónico del usuario. editable
Propiedades opcionales
containerAccess[] list Permisos de acceso del recurso Container de GTM. editable
containerAccess[].containerId string ID de recurso Container de GTM. editable
containerAccess[].permission[] list Lista de permisos del recurso Container. Los permisos válidos son: read, edit, delete, publish. editable

Respuesta

Si se realiza correctamente, este método devuelve un recurso Permissions en el cuerpo de la respuesta.

Ejemplos

Nota: Los ejemplos de código de este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas de cliente para obtener una lista de los lenguajes admitidos).

Java

Utiliza la biblioteca de cliente Java.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request authorizes a new user to access a GTM account.
 */

// Construct the container access object.
ContainerAccess container = new ContainerAccess();
container.setContainerId("54321");
container.setPermission(Arrays.asList("read"));

// Construct the account access object.
AccountAccess account = new AccountAccess();
account.setPermission(Arrays.asList("read"));

// Construct the user access object.
UserAccess userAccess = new UserAccess();
userAccess.setEmailAddress("username@example.com");
userAccess.setAccountAccess(account);
userAccess.setContainerAccess(Arrays.asList(container));

try {
  UserAccess response = tagmanager.accounts().
      permissions().create("12345", userAccess).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the create method are stored in the response object.
 * The following code shows how to access the created id.
 */
System.out.println("Permissions Id = " + response.getPermissionId());

Python

Utiliza la biblioteca de cliente Python.

# Note: This code assumes you have an authorized tagmanager service object.

# This request authorizes a new user to access a GTM account.
try:
  permissions = tagmanager.accounts().permissions().create(
      accountId='123456',
      body={
          'emailAddress': 'username@example.com',
          'accountAccess': {
              'permission': [
                  'read'
              ]
          },
          'containerAccess': {
              'containerId': '54321',
              'permission': [
                  'read'
              ]
          }
      }
  ).execute()
except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))

Pruébalo

Utiliza el siguiente explorador de APIs para llamar a este método con datos en tiempo real y ver la respuesta.