La API de Google Ads admite la vinculación de cuentas de Google Ads con 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 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 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.