Administra el acceso de los usuarios

Como administrador, puedes administrar los niveles de acceso y los roles de los usuarios en tus cuentas de Google Ads. Puedes recuperar y actualizar los roles de los usuarios, enviar invitaciones a los usuarios y cancelar 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 deben tener acceso de tipo ADMIN a la cuenta de destino.

Invitar a usuarios

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

Recupera los roles de los usuarios

Para obtener la lista de usuarios con acceso a una cuenta, crea una sentencia del lenguaje de consulta 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

Modifica los roles de los usuarios

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

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

Quitar usuarios

Para cancelar 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:

• El objeto MutateCustomerUserAccessResult (contenido 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 completará.
• Un segundo administrador puede aprobar o rechazar la solicitud de revisión pendiente con el método MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Consulta la guía de aprobación de varias partes para obtener más información.