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 versión v16 de la API para vincular tus cuentas.
Formas de vincular cuentas
Cuando vinculas una cuenta de Google Ads a otra cuenta de productos, hay dos formas diferentes de realizar la vinculación.
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:
- Deseas 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 cuentas.
- El administrador de la cuenta de productos desea 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, la aceptas y completas el proceso de vinculación.
En este caso, se usan los siguientes métodos:
| 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 status de
ProductLinkInvitation. El servidor de la API de Google Ads lo establecerá en REQUESTED cuando se complete correctamente la llamada a la API. |
| Cómo inspeccionar 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. |
Se pueden generar los siguientes errores comunes en este flujo de trabajo:
| 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 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
El flujo de vinculación directa se utiliza cuando tienes 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 con la cuenta del producto, en lugar de enviar una invitación.
En este caso, se usan los siguientes métodos:
| Acción | Observaciones |
|---|---|
| Cómo crear una vinculación activa | Usa
ProductLinkService.createProductLink para crear un ProductLink. |
| Cómo inhabilitar un vínculo activo | Usa
ProductLinkService.removeProductLink para quitar un ProductLink activo. |
| Recuperar vínculos activos | Usa
GoogleAdsService.Search o GoogleAdsService.SearchStream para consultar el recurso
product_link. |
Es posible que se muestren los siguientes errores comunes en este flujo de trabajo:
| Código de error | Explicación |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Se intentó vincular una cuenta mediante el flujo de vínculo directo, pero no se admite debido a la falta de permisos. En su lugar, el usuario deberá usar ProductLinkInvitationService para completar el flujo de invitación.
|
ProductLinkError.INVITATION_EXISTS |
No se puede crear un vínculo porque ya existe una invitación pendiente. |
Cambios en AccountLinkService y MerchantCenterLinkService
Si usaste MerchantCenterLinkService o AccountLinkService en el pasado 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 mencionados anteriormente. En la siguiente tabla, se muestra el estado de migración:
| Tipo de vínculo | ¿Se admite en servicios nuevos? | Asistencia disponible a partir del | Observaciones |
|---|---|---|---|
DataPartnerIdentifier |
Sí | v15 | Cómo realizar la migración fuera de MerchantCenterLinkService |
GoogleAdsIdentifier |
Sí | v16 | Migración fuera de AccountLinkService |
MerchantCenterIdentifier |
Sí | v16 | Migración fuera de AccountLinkService |
AdvertisingPartnerIdentifier |
Sí | v16 | Migración fuera de AccountLinkService |
ThirdPartyAppAnalyticsLinkIdentifier |
No | – | Seguir usando AccountLinkService |