Administra el acceso de los usuarios

Como administrador, puedes administrar los niveles de acceso y los roles de los usuarios para tus cuentas de Google Ads. Puedes recuperar y actualizar los roles de los usuarios, enviar invitaciones a los usuarios y finalizar el acceso de los usuarios a una cuenta con la API de Google Ads. Obtén más información sobre los niveles de acceso a la cuenta.

Para administrar el acceso de los usuarios, el usuario o la cuenta de servicio que realiza la llamada debe tener acceso ADMIN a la cuenta de destino.

Invitar a usuarios

Para invitar a un usuario nuevo a acceder a una cuenta, usa CustomerUserAccessInvitationService para crear y enviar una invitación (consulta Administrar invitaciones de acceso de usuarios). Una vez que el usuario acepte la invitación, aparecerá como usuario confirmado en CustomerUserAccess.

Recuperar roles de usuarios

Para obtener la lista de usuarios con acceso a una cuenta, crea una instrucción del lenguaje de consultas de Google Ads para consultar todas las entidades CustomerUserAccess asociadas con un ID de cliente. Esta es una consulta típica:

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

Modificar roles de usuarios

Para actualizar un rol de usuario existente, llama a CustomerUserAccessService.MutateCustomerUserAccess con la operación UPDATE. Cuando modificas un rol de usuario, debes proporcionar lo siguiente:

• El nombre del recurso de la entidad CustomerUserAccess que se modificará, en el formato customers/{customer_id}/customerUserAccesses/{user_id}.
• El nuevo rol de usuario en access_role.
• Una update_mask (FieldMask) que especifique access_role.

Quitar usuarios

Para finalizar el acceso de un usuario a la cuenta, llama a CustomerUserAccessService.MutateCustomerUserAccess con una operación REMOVE que especifique el nombre del recurso (customers/{customer_id}/customerUserAccesses/{user_id}).

Aprobación de varias partes para cambios de acceso

Si se activa una solicitud de aprobación de varias partes cuando se llama a MutateCustomerUserAccess, sucede lo siguiente:

• El objeto MutateCustomerUserAccessResult (que se encuentra en el campo result de MutateCustomerUserAccessResponse) propagará el campo multi_party_auth_review con el nombre del recurso de la revisión pendiente que requiere aprobación.
• El campo resource_name de MutateCustomerUserAccessResult no se propagará.
• Un segundo administrador puede aprobar o rechazar la solicitud de revisión pendiente con el MultiPartyAuthReviewService.ResolveMultiPartyAuthReview método. Consulta la guía de aprobación de varias partes para obtener más información.