Administre el acceso de los usuarios

Como administrador, puedes administrar los niveles de acceso y los roles de los usuarios de tus cuentas de Google Ads. La API de Google Ads puede recuperar y actualizar los roles de los usuarios, así como finalizar el acceso de los usuarios a una cuenta. Obtén más información sobre los niveles de acceso a la cuenta.

Cómo recuperar los roles de los usuarios

Para obtener la lista de usuarios con acceso a una cuenta, compila 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

Cómo modificar los roles de los usuarios

Para actualizar un rol de usuario existente, debes llamar a CustomerUserAccessService.MutateCustomerUserAccess. Usa la operación UPDATE y asegúrate de proporcionar el nombre de recurso de CustomerUserAccess que se modificará, así como el nuevo rol de usuario.

Si Google determina que se requiere una MPA, sucederá lo siguiente:

• El MutateCustomerUserAccessResponse propagará el multi_party_auth_review campo que contiene el nombre de recurso de la revisión pendiente que requiere aprobación.
• El campo resource_name 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.

Quitar usuarios

Para finalizar el acceso de un usuario a la cuenta, llama a CustomerUserAccessService.MutateCustomerUserAccess con una operación REMOVE.

Al igual que la actualización de los roles de los usuarios, la eliminación de un usuario es una acción sensible que puede activar una MPA a partir del 30 de julio de 2026. Si se activa una MPA, sucederá lo siguiente:

• El MutateCustomerUserAccessResponse propagará el multi_party_auth_review campo que contiene el nombre de recurso de la revisión pendiente que requiere aprobación.
• El campo resource_name 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.