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 productos, la vinculación puede ocurrir de dos maneras diferentes.
Flujo de invitación
El flujo de invitación se usa cuando tienes acceso de administrador a la cuenta de Google Ads, pero no a la cuenta de productos. Este flujo funciona en dos situaciones:
- Quieres vincular las dos cuentas y crear una invitación para un administrador de la cuenta de productos. El administrador de la cuenta de productos 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 de productos crea una invitación, y tú la aceptas y completas el proceso de vinculación.
En esta situación, se usan los siguientes métodos:
| Situación | Acción | Observaciones |
|---|---|---|
| Situación 1 | Crea una invitación | Usa el
ProductLinkInvitationService.CreateProductLinkInvitation método
para crear una invitación. No se debe configurar el status
de
ProductLinkInvitation; el servidor de la API de Google Ads
lo establecerá en REQUESTED cuando se complete correctamente
la llamada a la API. |
| Inspecciona 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. |
| Acepta o rechaza una invitación | Usa el
ProductLinkInvitationService.UpdateProductLinkInvitation para
actualizar el estado de
ProductLinkInvitation a ACCEPTED o
REJECTED. |
|
| Revoca una invitación | Usa el
ProductLinkInvitationService.RemoveProductLinkInvitation método para
revocar un existente
ProductLinkInvitation. |
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. |
ProductLinkError.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 un vínculo activo. |
Flujo de vinculación directa
El flujo de vinculación directa se usa cuando tienes acceso de administrador tanto a la cuenta de Google Ads como a la cuenta de productos. En este caso, vinculas directamente la cuenta de Google Ads a la cuenta de productos en lugar de enviar una invitación.
En esta situación, se usan los siguientes métodos:
| 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
activo
ProductLink. |
| 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ó vincular una cuenta con el flujo de vinculación directa, pero esto
no es compatible 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 todos los vínculos de productos asociados con tu cuenta de Google Ads mediante
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 propagarán otros campos dentro del recurso product_link, lo que proporcionará más detalles sobre el vínculo. Por ejemplo, si el tipo es THIRD_PARTY_APP_ANALYTICS, el campo third_party_app_analytics contendrá información sobre el proveedor de estadísticas.
Esto te permite obtener una lista de servicios y aplicaciones externos vinculados directamente a tu cuenta de Google Ads, como Google Play, socios de datos o plataformas de estadísticas de aplicaciones de terceros.
Cambios en AccountLinkService
Si usas AccountLinkService para vincular una cuenta de Google Ads a otra cuenta de productos, 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 de AccountLinkService y usa ProductLinkService:
GoogleAdsIdentifierMerchantCenterIdentifierAdvertisingPartnerIdentifier
Para ThirdPartyAppAnalyticsLinkIdentifier, sigue usando AccountLinkService.