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

Nota: Si un cambio en el nivel de acceso del usuario está pendiente de una aprobación de varias partes, no aparecerá cuando se recuperen las listas de acceso de los usuarios con el método GoogleAdsService.Search o SearchStream. La función de aprobación de varias partes está en versión beta y está sujeta a cambios en versiones futuras.

Cómo modificar los roles de los usuarios

Nota: Es posible que la API de Google Ads genere una solicitud de aprobación de varias partes para completar esta acción. Consulta la guía de aprobación de varias partes para obtener más información.

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 se activa una solicitud de aprobación de varias partes, sucederá lo siguiente:

• El MutateCustomerUserAccessResponse propagará el campo multi_party_auth_review 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

Nota: Es posible que la API de Google Ads genere una solicitud de aprobación de varias partes para completar esta acción. Consulta la guía de aprobación de varias partes para obtener más información.

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

Si se activa una solicitud de aprobación de varias partes, sucederá lo siguiente:

• El MutateCustomerUserAccessResponse propagará el campo multi_party_auth_review 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.