Gérer l'accès des utilisateurs

En tant qu'administrateur, vous pouvez gérer les niveaux d'accès et les rôles des utilisateurs pour vos comptes Google Ads. Vous pouvez récupérer et modifier les rôles utilisateur, envoyer des invitations aux utilisateurs et mettre fin à l'accès d'un utilisateur à un compte à l'aide de l'API Google Ads. En savoir plus sur les niveaux d'accès aux comptes

Pour gérer l'accès des utilisateurs, l'utilisateur ou le compte de service appelant doit disposer d'un accès ADMIN au compte cible.

Inviter des utilisateurs

Pour inviter un nouvel utilisateur à accéder à un compte, utilisez CustomerUserAccessInvitationService pour créer et envoyer une invitation (voir Gérer les invitations d'accès utilisateur). Une fois que l'utilisateur a accepté l'invitation, il apparaît comme utilisateur confirmé sous CustomerUserAccess.

Récupérer les rôles utilisateur

Vous pouvez obtenir la liste des utilisateurs ayant accès à un compte en créant une instruction en langage de requête Google Ads pour interroger toutes les entités CustomerUserAccess associées à un numéro 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 mettre à jour un rôle utilisateur existant, appelez CustomerUserAccessService.MutateCustomerUserAccess à l'aide de l'opération UPDATE. Lorsque vous modifiez un rôle utilisateur, vous devez fournir les éléments suivants :

• Nom de ressource de l'entité CustomerUserAccess à modifier, au format customers/{customer_id}/customerUserAccesses/{user_id}.
• Nouveau rôle utilisateur dans access_role.
• Un update_mask (FieldMask) spécifiant access_role.

Supprimer des utilisateurs

Pour mettre fin à l'accès d'un utilisateur au compte, appelez CustomerUserAccessService.MutateCustomerUserAccess avec une opération REMOVE spécifiant le nom de la ressource (customers/{customer_id}/customerUserAccesses/{user_id}).

Approbation multipartite pour les modifications d'accès

Si une demande d'approbation multipartite est déclenchée lors de l'appel de MutateCustomerUserAccess :

• L'objet MutateCustomerUserAccessResult (contenu dans le champ result de MutateCustomerUserAccessResponse) renseignera le champ multi_party_auth_review avec le nom de ressource de l'examen en attente d'approbation.
• Le champ resource_name de MutateCustomerUserAccessResult 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 méthode MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Pour en savoir plus, consultez le guide sur l'approbation multipartite.