La API de Google Ads admite la vinculación de cuentas de Google Ads a otras cuentas de productos. En esta guía, se explica cómo usar la API para vincular tus cuentas.
Formas de vincular cuentas
Cuando se vincula una cuenta de Google Ads a otra cuenta de producto, existen dos formas diferentes en las que se puede realizar la vinculación.
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:
- Quieres vincular las dos cuentas y crear una invitación para un administrador de la cuenta del producto. El administrador de la cuenta del producto acepta la invitación para completar el proceso de vinculación de la cuenta.
- El administrador de la cuenta de productos 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.
En esta situación, usa los siguientes métodos:
| Situación | Acción | Observaciones |
|---|---|---|
| Situación 1 | Cómo crear una invitación | Usa el método
ProductLinkInvitationService.CreateProductLinkInvitation
para crear una invitación. No se debe establecer el status del
ProductLinkInvitation. El servidor de la API de Google Ads establecerá este valor en REQUESTED cuando se complete correctamente la llamada a la API. Cuando se crea una invitación para un socio publicitario (AdvertisingPartnerLinkInvitationIdentifier), advertising_partner_properties.allowed_domain es obligatorio a partir de la versión 25 (y opcional en la versión 24 y anteriores). |
| Cómo inspeccionar el estado de una invitación | Usa GoogleAdsService.Search
o GoogleAdsService.SearchStream
para consultar el recurso product_link_invitation
y revisar 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 generar 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 porque el usuario ya tiene acceso de administrador a la cuenta invitada. El usuario debe usar ProductLinkService para crear directamente un vínculo activo. |
Flujo de vinculación directa
Usa el flujo de vinculación directa cuando tengas acceso de administrador tanto a la cuenta de Google Ads como a la cuenta de producto. En este caso, vincula directamente la cuenta de Google Ads a la cuenta de productos en lugar de enviar una invitación.
En esta situación, usa los siguientes métodos:
| Acción | Observaciones |
|---|---|
| Cómo crear 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. |
En este flujo de trabajo, se pueden generar los siguientes errores comunes:
| Código de error | Explicación |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Se intentó una vinculación de cuentas con el flujo de vínculos directos, 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. |
Recupera los vínculos de productos existentes
Puedes recuperar todas las vinculaciones de productos asociadas 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 valor de 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 del socio de datos vinculados.
Esto te permite obtener una lista de los servicios externos y las cuentas de productos vinculados 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:
Para ThirdPartyAppAnalyticsLinkIdentifier, sigue usando AccountLinkService.