Cómo vincular cuentas de productos

La API de Google Ads admite la vinculación de cuentas de Google Ads con cuentas de otros productos. En esta guía, se explica cómo usar la API para vincular tus cuentas.

Formas de vincular cuentas

Cuando vinculas una cuenta de Google Ads a otra cuenta de producto, hay dos formas diferentes en las que se puede realizar la vinculación.

Nota: En los siguientes pasos, se describe el proceso general para vincular una cuenta de Google Ads con una cuenta de producto. En el caso de las cuentas de Merchant Center, las solicitudes de vinculación nuevas se deben iniciar con la interfaz de Merchant Center o la API de Merchant. La API de Google Ads se puede usar para administrar (aprobar, rechazar y quitar) y generar informes sobre las vinculaciones y las invitaciones de Merchant Center.

Flujo de invitación

Usa el flujo de invitación cuando tengas acceso de administrador a la cuenta de Google Ads, pero no a la cuenta del producto. Este flujo funciona en dos situaciones:

1. Quieres vincular las dos cuentas y crear una invitación para un administrador de la cuenta de producto. El administrador de la cuenta de producto acepta la invitación para completar el proceso de vinculación de cuentas.
2. El administrador de la cuenta de producto quiere vincular las dos cuentas, pero no tiene acceso a la cuenta de Google Ads. El administrador de la cuenta del producto crea una invitación, y tú la aceptas y completas el proceso de vinculación.

Usa los siguientes métodos en esta situación:

Situación	Acción	Observaciones
Situación 1	Crea una invitación	Usa el método ProductLinkInvitationService.CreateProductLinkInvitation para crear una invitación. No se debe establecer el campo status de ProductLinkInvitation, ya que el servidor de la API de Google Ads lo establecerá en REQUESTED cuando se complete correctamente la llamada a la API. Cuando crees una invitación para un socio publicitario (AdvertisingPartnerLinkInvitationIdentifier), advertising_partner_properties.allowed_domain será obligatorio a partir de la versión 25 (y opcional en la versión 24 y anteriores).
	Inspecciona el estado de una invitación	Usa GoogleAdsService.Search o GoogleAdsService.SearchStream para consultar el recurso product_link_invitation y, luego, inspeccionar su estado.
Situación 2	Recupera una invitación	Usa GoogleAdsService.Search o GoogleAdsService.SearchStream para consultar el recurso product_link_invitation. Filtra por status = PENDING_APPROVAL para aceptar o rechazar una invitación pendiente.
	Cómo aceptar o rechazar una invitación	Usa el método ProductLinkInvitationService.UpdateProductLinkInvitation para actualizar el estado de ProductLinkInvitation a ACCEPTED o REJECTED.
	Cómo revocar una invitación	Usa el método ProductLinkInvitationService.RemoveProductLinkInvitation para revocar un ProductLinkInvitation existente.

En este flujo de trabajo, se pueden producir los siguientes errores comunes:

Código de error	Explicación
ProductLinkInvitationError.PERMISSION_DENIED	El cliente no tiene permiso para realizar esta acción.
ProductLinkInvitationError.NO_INVITATION_REQUIRED	No se pudo crear una invitación, ya que el usuario ya tiene acceso de administrador a la cuenta invitada. El usuario debe usar ProductLinkService para crear directamente una vinculación activa.

Flujo de vinculación directa

Usa el flujo de vinculación directa cuando tengas acceso de administrador a la cuenta de Google Ads y a la cuenta del producto. En este caso, vincula directamente la cuenta de Google Ads a la cuenta de productos en lugar de enviar una invitación.

Usa los siguientes métodos en esta situación:

Acción	Observaciones
Crea un vínculo activo	Usa ProductLinkService.CreateProductLink para crear un ProductLink.
Inhabilita un vínculo activo	Usa ProductLinkService.RemoveProductLink para quitar un ProductLink activo.
Recupera vínculos activos	Usa GoogleAdsService.Search o GoogleAdsService.SearchStream para consultar el recurso product_link.

Es posible que se produzcan los siguientes errores comunes en este flujo de trabajo:

Código de error	Explicación
ProductLinkError.CREATION_NOT_PERMITTED	Se intentó vincular una cuenta con el flujo de vínculo directo, pero no se admite debido a la falta de permisos. En su lugar, el usuario debe usar ProductLinkInvitationService para realizar el flujo de invitación.
ProductLinkError.INVITATION_EXISTS	No se puede crear un vínculo porque ya existe una invitación pendiente.

Cómo recuperar vínculos de productos existentes

Puedes recuperar todos los productos vinculados asociados a tu cuenta de Google Ads con una consulta de GAQL en el recurso product_link.

SELECT
  product_link.product_link_id,
  product_link.type
FROM product_link

El campo product_link.type indica el tipo de producto o servicio vinculado. Según el type, se completarán otros campos dentro del recurso product_link, lo que proporcionará más detalles sobre el vínculo. Por ejemplo, si el tipo es DATA_PARTNER, el campo data_partner contendrá información sobre la cuenta de socio de datos vinculada.

Esto te permite obtener una lista de servicios externos y cuentas de productos vinculadas directamente a tu cuenta de Google Ads, como Merchant Center, Google Ads, socios publicitarios o socios de datos.

Cambios en AccountLinkService

Si usas AccountLinkService para vincular una cuenta de Google Ads a otra cuenta de producto, debes migrar tu aplicación existente a uno de los flujos de trabajo que se mencionaron anteriormente. Para los siguientes tipos de vínculos, migra desde AccountLinkService y usa ProductLinkService:

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier
• DataPartnerIdentifier

Para ThirdPartyAppAnalyticsLinkIdentifier, sigue usando AccountLinkService.