Asignaciones de campo

Usa las asignaciones de campos para actualizar cada paso de los flujos de trabajo de vínculos de socios de la API de Google Ads a la API de Data Manager:

Asignaciones de campos de objetos

Usa las asignaciones de las tablas para asignar un objeto ProductLink en la API de Google Ads a su equivalente PartnerLink en la API de Data Manager.

ProductLink (API de Google Ads) PartnerLink (API de Data Manager) Notas
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account La API de Data Manager no tiene campos separados para cada tipo de cuenta vinculada. Para todos los tipos de cuentas, establece el campo partner_account en un ProductAccount y configura sus campos account_type y account_id para identificar la cuenta vinculada.
product_link_id partner_link_id
resource_name name

En la API de Google Ads, el customer_id del objeto resource_name de un objeto ProductLink indica qué cuenta es propietaria de una vinculación existente. Cuando creas un ProductLink, indicas el propietario del vínculo configurando el customer_id de un CreateProductLinkRequest.

En la API de Data Manager, la combinación de accountType y accountId del objeto owning_account indica qué cuenta es propietaria de un vínculo existente. Cuando creas un PartnerLink, indicas el propietario del vínculo configurando el name en el nombre del recurso del propietario.

Consulta Nombres de recursos y Crea una solicitud para obtener más detalles.

type owning_account.account_type

Nombres de recursos

La API de Data Manager usa un formato de nombre de recurso diferente al de la API de Google Ads.

API de Google Ads

En la API de Google Ads, un nombre de recurso ProductLink usa el siguiente formato:

customers/{customer_id}/productLinks/{product_link_id}

API de Data Manager

En la API de Data Manager, un nombre de recurso PartnerLink usa el siguiente formato:

accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

Asignaciones de solicitudes de administración de vinculaciones

Usa las asignaciones de solicitudes de esta sección para convertir las solicitudes de creación, eliminación y recuperación de vínculos de socios.

Crear solicitud

A continuación, se muestran las asignaciones de campos para convertir un objeto CreateProductLinkRequest en la API de Google Ads a su objeto CreatePartnerLinkRequest equivalente en la API de Data Manager.

CreateProductLinkRequest (API de Google Ads) CreatePartnerLinkRequest (API de Data Manager) Notas
customer_id parent Se establece en el nombre del recurso de la cuenta de anunciante propietaria.
product_link partner_link Se establece en el recurso PartnerLink. Consulta Asignaciones de campos de objetos

Borrar solicitud

A continuación, se muestran las asignaciones de campos para convertir un objeto RemoveProductLinkRequest en la API de Google Ads a su objeto DeletePartnerLinkRequest equivalente en la API de Data Manager.

RemoveProductLinkRequest (API de Google Ads) DeletePartnerLinkRequest (API de Data Manager) Notas
customer_id No hay equivalente El campo name encapsula las cuentas propietarias y de socios, por lo que no se necesita este campo adicional.
resource_name name Se establece en el nombre del recurso del PartnerLink que deseas quitar.
validate_only No hay equivalente

Asignaciones de solicitudes de recuperación de vínculos

El enfoque para recuperar los vínculos de socios difiere entre la API de Google Ads y la API del Administrador de datos.

API de Google Ads

Envía un SearchGoogleAdsRequest que contenga un query. La cláusula WHERE opcional de la consulta define qué recursos se deben devolver. La cláusula SELECT de la consulta define qué campos se deben completar en los recursos parciales que se muestran.

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...
API de Data Manager

Envía un SearchPartnerLinkRequest. El campo de solicitud filter opcional define qué recursos se devolverán. La respuesta contiene recursos completos, con todos los campos completados.

A continuación, se muestran las asignaciones de campos para convertir un objeto SearchGoogleAdsRequest en la API de Google Ads a su objeto SearchPartnerLinksRequest equivalente en la API de Data Manager.

SearchGoogleAdsRequest (API de Google Ads) SearchPartnerLinksRequest (API de Data Manager) Notas
customer_id parent Se establece en el nombre del recurso de la cuenta que se buscará.
page_size page_size
page_token page_token
query filter Establece filter para definir qué recursos se devolverán. La API de Data Manager devuelve recursos completos, por lo que no hay un equivalente a la cláusula SELECT.
search_settings No hay equivalente
validate_only No hay equivalente

Consulta Cómo recuperar vínculos de socios para obtener más información, incluido cómo construir el filter de una solicitud SearchPartnerLinksRequest y establecer encabezados de solicitud para diferentes situaciones.

Anterior
Pasos para la actualización