Cette page a été traduite par l'API Cloud Translation.

Permissions: update

Met à jour les autorisations du compte et des conteneurs d'un utilisateur. Essayez maintenant ou consultez un exemple.

Requête

Requête HTTP

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

Paramètres

Nom du paramètre	Valeur	Description
Paramètres de chemin d'accès
`accountId`	`string`	ID du compte GTM.
`permissionId`	`string`	L'ID utilisateur GTM.

Autorisation

Une autorisation est requise pour cette requête. Celle-ci doit inclure le champ d'application suivant (en savoir plus sur le processus d'authentification et d'autorisation).

Définition du champ d'application
`https://www.googleapis.com/auth/tagmanager.manage.users`

Corps de la requête

Dans le corps de la requête, indiquez une ressource d'autorisations avec les propriétés suivantes:

Nom de propriété	Valeur	Description	Remarques
Propriétés facultatives
`accountAccess`	`nested object`	Autorisations d'accès au compte GTM.	accessible en écriture
`accountAccess.permission[]`	`list`	Liste des autorisations de compte. Les autorisations de compte valides sont `read` et `manage`.	accessible en écriture
`containerAccess[]`	`list`	Autorisations d'accès aux conteneurs GTM.	accessible en écriture
`containerAccess[].containerId`	`string`	ID de conteneur GTM.	accessible en écriture
`containerAccess[].permission[]`	`list`	Liste des autorisations au niveau du conteneur. Les autorisations de conteneur valides sont les suivantes: `read, edit, delete, publish`.	accessible en écriture

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource "Permissions" dans le corps de réponse.

Exemples

Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).

Java

Utilise la bibliothèque cliente Java.

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

/*
 * This request updates a user's permissions to access a GTM account.
 */

// Construct the container access object.
ContainerAccess container = new ContainerAccess();
container.setContainerId("789443");
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().update("123456", "00123456789", userAccess).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the update method are stored in the response object.
 * The following code shows how to access the updated name and fingerprint.
 */
System.out.println("Updated Name = " + response.getName());
System.out.println("Updated Fingerprint = " + response.getFingerprint());

Python

Utilise la bibliothèque cliente Python.

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

# This request updates a user's permissions to access a GTM account.
try:
  response = tagmanager.accounts().permissions().update(
      accountId='123456',
      permissionId='00123456789',
      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))

# The results of the update method are stored in the response object.
# The following code shows how to access the updated name and fingerprint.
print 'Updated Name = %s' % response.get('name')
print 'Updated Fingerprint = %s' % response.get('fingerprint')

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.