Asignaciones de campo

Usa las asignaciones de campos para actualizar cada paso de los flujos de trabajo de vinculación de socios de la API de Google Ads a la API de Data Manager:

• Las asignaciones de campos de objetos contienen asignaciones de campos para el recurso que representa un objeto de vinculación de socios.
• Las asignaciones de solicitudes de administración de vinculaciones contienen asignaciones de campos para las solicitudes de creación y eliminación de una vinculación de socios.
• Las asignaciones de solicitudes de recuperación de vinculaciones contienen asignaciones de campos para recuperar vinculaciones de socios.

Asignaciones de campos de objetos

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

Punto clave: Un ProductLink y un PartnerLink son representaciones diferentes de la misma entidad de vinculación subyacente. Si ya tienes un ProductLink en la API de Google Ads , puedes recuperarlo y administrarlo como un PartnerLink en la API de Data Manager. No intentes crear otro PartnerLink para el mismo par de cuentas.

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 partner_account campo en un ProductAccount, y configura su 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 resource_name de un ProductLink indica qué cuenta posee una vinculación existente. Cuando creas un ProductLink, indicas el propietario de la vinculación configurando el customer_id de un CreateProductLinkRequest. En la API de Data Manager, la combinación de accountType y accountId del owning_account indica qué cuenta posee una vinculación existente. Cuando creas un PartnerLink, indicas el propietario de la vinculación configurando el name en el nombre de recurso del propietario. Consulta Nombres de recursos y Crear 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 solicitudes de creación, eliminación y recuperación de vinculaciones de socios.

Crear solicitud

Estas son las asignaciones de campos para convertir un CreateProductLinkRequest en la API de Google Ads a su equivalente CreatePartnerLinkRequest en la API de Data Manager.

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

Borrar solicitud

Estas son las asignaciones de campos para convertir un RemoveProductLinkRequest en la API de Google Ads a su equivalente DeletePartnerLinkRequest 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	Establece el nombre de recurso del PartnerLink que deseas quitar.
validate_only	No hay equivalente

Asignaciones de solicitudes de recuperación de vinculaciones

El enfoque para recuperar vinculaciones de socios difiere entre la API de Google Ads y la API de Data Manager.

API de Google Ads

Envía un SearchGoogleAdsRequest que contenga un query. La cláusula WHERE opcional de la consulta define qué recursos mostrar. La cláusula SELECT de la consulta define qué campos propagar 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 mostrar. La respuesta contiene recursos completos, con todos los campos propagados.

Estas son las asignaciones de campos para convertir un SearchGoogleAdsRequest en la API de Google Ads a su equivalente SearchPartnerLinksRequest en la API de Data Manager.

SearchGoogleAdsRequest (API de Google Ads)	SearchPartnerLinksRequest (API de Data Manager)	Notas
customer_id	parent	Establece el nombre de recurso de la cuenta que se buscará.
page_size	page_size
page_token	page_token
query	filter	Establece el filter para definir qué recursos mostrar. La API de Data Manager muestra 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 Recupera vinculaciones 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.