Gérer les accès utilisateur

En tant qu'administrateur, vous pouvez gérer les rôles et les niveaux d'accès des utilisateurs pour vos comptes Google Ads. L'API Google Ads est capable de récupérer et de mettre à jour les rôles utilisateur, ainsi que de supprimer l'accès d'un utilisateur à un compte. En savoir plus sur les niveaux d'accès aux comptes.

Récupérer les rôles utilisateur

Vous pouvez obtenir la liste des utilisateurs ayant accès à un compte en créant une instruction Google Ads Query Language pour interroger toutes les CustomerUserAccess entités associées à un ID client. Voici une requête type :

SELECT
  customer_user_access.user_id,
  customer_user_access.email_address,
  customer_user_access.access_role,
  customer_user_access.access_creation_date_time,
  customer_user_access.inviter_user_email_address
FROM customer_user_access

Modifier les rôles utilisateur

Pour modifier un rôle utilisateur existant, vous devez appeler CustomerUserAccessService.MutateCustomerUserAccess. Utilisez l'opération UPDATE et veillez à fournir le nom de ressource de l'élément CustomerUserAccess à modifier, ainsi que le nouveau rôle utilisateur.

Si Google détermine qu'une approbation multipartite est requise :

• Le champ multi_party_auth_review de MutateCustomerUserAccessResponse sera renseigné avec le nom de ressource de l'examen en attente nécessitant une approbation.
• Le champ resource_name ne sera pas renseigné.
• La demande d'examen en attente peut être approuvée ou refusée par un deuxième administrateur à l'aide de la MultiPartyAuthReviewService.ResolveMultiPartyAuthReview méthode. Pour en savoir plus, consultez le guide sur l'approbation multipartite.

Supprimer des utilisateurs

Pour supprimer l'accès d'un utilisateur au compte, appelez CustomerUserAccessService.MutateCustomerUserAccess avec une opération REMOVE.

Comme pour la modification des rôles utilisateur, la suppression d'un utilisateur est une action sensible qui peut déclencher une approbation multipartite à partir du 30 juillet 2026. Si une approbation multipartite est déclenchée :

• Le champ multi_party_auth_review de MutateCustomerUserAccessResponse sera renseigné avec le nom de ressource de l'examen en attente nécessitant une approbation.
• Le champ resource_name ne sera pas renseigné.
• La demande d'examen en attente peut être approuvée ou refusée par un deuxième administrateur à l'aide de la MultiPartyAuthReviewService.ResolveMultiPartyAuthReview méthode. Pour en savoir plus, consultez le guide sur l'approbation multipartite.