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 à leur accès à 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 appelant ou le compte de service doit disposer d'un accès ADMIN au compte cible.

Inviter des utilisateurs

Pour inviter un nouvel utilisateur à accéder à un compte, utilisez les CustomerUserAccessInvitationService afin de créer et d'envoyer une invitation (consultez 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 du langage de requête Google Ads 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, appelez CustomerUserAccessService.MutateCustomerUserAccess à l'aide de l'opération UPDATE. Lorsque vous modifiez un rôle utilisateur, vous devez fournir les éléments suivants :

• Le nom de ressource de l'entité CustomerUserAccess à modifier, au format customers/{customer_id}/customerUserAccesses/{user_id}.
• Le 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 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) remplira le champ multi_party_auth_review avec le nom de ressource de l'examen en attente nécessitant une 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 MultiPartyAuthReviewService.ResolveMultiPartyAuthReview méthode. Pour en savoir plus, consultez le guide sur l'approbation multipartite.