Aprobaciones de varias partes en la API de Google Ads

Jueves, 25 de junio de 2026

Como parte de nuestras iniciativas para mejorar la seguridad de las cuentas de Google Ads, la API de Google Ads comenzará a requerir aprobaciones de varias partes cuando se realicen acciones sensibles de la API. Esto forma parte de un cambio más amplio en Google Ads que requiere aprobaciones de varias partes para realizar acciones sensibles en tu cuenta de Google Ads. Estas importantes actualizaciones de seguridad comenzarán a implementarse a partir del 27 de julio de 2026 y se habilitarán para todos los usuarios en las próximas semanas.

¿Qué cambiará?

Cuando este cambio entre en vigencia, las siguientes llamadas a la API cambiarán su comportamiento.

Cómo invitar a un usuario

Si usas el método CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation para invitar a un usuario nuevo a administrar una cuenta de Google Ads, la API de Google Ads ahora evalúa si es necesaria la aprobación de varias partes. En los casos en que nuestros servidores determinen que se requiere una revisión, el sistema pausará el flujo de trabajo estándar y no generará de inmediato un CustomerUserAccessInvitation ni enviará el correo electrónico de invitación. En su lugar, se inicia un recurso MultiPartyAuthReview, con su nombre de recurso proporcionado en la respuesta. Una vez que un segundo administrador de la cuenta apruebe la revisión pendiente, se creará el CustomerUserAccessInvitation y el usuario invitado recibirá su correo electrónico. No se pueden crear invitaciones nuevas para el usuario hasta que se resuelva la revisión pendiente.

Cómo actualizar o rescindir el acceso de un usuario

Si usas el método CustomerUserAccessService.MutateCustomerUserAccess para ajustar los permisos de un usuario con la operación de actualización o revocar el acceso con la operación de eliminación, la API de Google Ads ahora evalúa si es necesaria la aprobación de varias partes. En los casos en que nuestros servidores determinen que se requiere una revisión, la API generará un recurso MultiPartyAuthReview en estado pendiente y devolverá su nombre de recurso. Las modificaciones solicitadas permanecerán pendientes y solo se aplicarán una vez que un segundo administrador de la cuenta apruebe correctamente la revisión de varias partes. No se puede mutar el recurso CustomerUserAccess que está en revisión hasta que se resuelva la revisión pendiente.

¿Cómo apruebo una solicitud de aprobación de varias partes?

Puedes recuperar un MultiPartyAuthReview pendiente con los métodos GoogleAdsService.Search o GoogleAdsService.SearchStream, usando la siguiente consulta de GAQL. 

SELECT
    multi_party_auth_review.resource_name,
    multi_party_auth_review.multi_party_auth_review_id,
    multi_party_auth_review.creation_date_time,
    multi_party_auth_review.request_user_email,
    multi_party_auth_review.operation_type,
    multi_party_auth_review.justification,
    multi_party_auth_review.target_resource,
    multi_party_auth_review.customer_user_access_review.old_customer_user_access,
    multi_party_auth_review.customer_user_access_review.new_customer_user_access,
    multi_party_auth_review.customer_user_access_invitation_review.new_customer_user_access_invitation
FROM multi_party_auth_review
WHERE multi_party_auth_review.review_status = 'PENDING'

Una solicitud de MultiPartyAuthReview pendiente se puede aprobar o rechazar con una solicitud a la API de MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. La revisión debe realizarla un segundo administrador que no haya creado la solicitud original. Puede ser una persona o una cuenta de servicio con privilegios de administrador. El solicitante original puede revocar la revisión pendiente.

¿Qué tengo que hacer?

Si tu aplicación usa estos métodos, asegúrate de actualizarla para que administre los flujos de trabajo de aprobación de varias partes antes del 27 de julio de 2026. Agregamos compatibilidad para las aprobaciones de varias partes a todas las versiones principales de la API (v24.2, v23.3, v22.2 y v21.2). Si usas una biblioteca cliente oficial, asegúrate de descargar su versión más reciente. Puedes consultar las siguientes guías para obtener más información sobre estos cambios, en las que se incluyen detalles sobre lo siguiente:

Si tienes alguna pregunta o quieres debatir sobre esta actualización, comunícate con nosotros en el servidor de Discord de la "Comunidad de publicidad y medición de Google". Si tienes problemas de asistencia técnica, comunícate con https://support.google.com/google-ads/contact/google_ads_api.

Retrato del autor - , equipo de la API de Google Ads

Etiquetas: authorization, google-ads-api