Cómo crear o borrar un vínculo de socio

A continuación, se explica cómo crear o borrar un recurso PartnerLink. La API de Data Manager admite la creación de vínculos de socio para los siguientes tipos de cuentas:

  • Cuentas de Google Ads
  • Cuentas de socio o de anunciante de Display & Video 360

Envía un CreatePartnerLinkRequest para crear un PartnerLink.

Crea el cuerpo de la solicitud

Crea un recurso PartnerLink. Estos son los campos que debes configurar.

owning_account

Identifica la cuenta de anunciante propietaria de la vinculación. Se establece en un objeto ProductAccount.

Establece el account_type en el AccountType de la cuenta de anunciante.

Establece account_id en el ID de la cuenta de anunciante.

Consulta la guía de destinos y encabezados para obtener instrucciones sobre el ID que debes usar para cada tipo de anunciante.

partner_account

Identifica la cuenta del socio. Se establece en un objeto ProductAccount.

Establece account_type en AccountType de la cuenta de socio. Por ejemplo, si el vínculo es de una cuenta de anunciante a una cuenta de socio de datos, establece este campo en DATA_PARTNER.

Establece account_id en el ID de la cuenta de socio.

Crea la solicitud

Para crear un vínculo de socio, construye un objeto CreatePartnerLinkRequest.

  1. Establece parent en el nombre del recurso de la cuenta de anunciante. Usa el siguiente formato:

    accountTypes/{account_type}/accounts/{account}

  2. Establece partner_link en el recurso PartnerLink que creaste.

  3. Si tus credenciales son para una Cuenta de Google con acceso a una cuenta principal de la cuenta del anunciante, como una cuenta de administrador de Google Ads o una cuenta de socio de Display & Video 360, configura el encabezado login-account como se describe en Configura destinos y encabezados.

A continuación, se muestran solicitudes de ejemplo en formato JSON para crear una vinculación a una cuenta de socio de datos en diferentes tipos de cuentas de anunciantes.

Abrir en el Explorador de APIs 
{
    "parent": "accountTypes/GOOGLE_ADS/accounts/INSERT_GOOGLE_ADS_CUSTOMER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "GOOGLE_ADS",
            "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

Anunciante de DV360

Abrir en el Explorador de APIs 
{
    "parent": "accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/INSERT_DISPLAY_VIDEO_ADVERTISER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_ADVERTISER",
            "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

Socio de DV360

Abrir en el Explorador de APIs 
{
    "parent": "accountTypes/DISPLAY_VIDEO_PARTNER/accounts/INSERT_DISPLAY_VIDEO_PARTNER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_PARTNER",
            "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

Envía la solicitud

Envía la solicitud y, si es necesario, incluye encabezados de solicitud. Usa las credenciales de una Cuenta de Google con acceso a owning_account.

Si la solicitud se completa correctamente, la respuesta contendrá el objeto PartnerLink creado con los campos id y name completados.

Si la solicitud falla, inspecciona los errores para determinar la causa de la falla, actualiza la solicitud y los encabezados para corregir cualquier problema y, luego, envía la solicitud y los encabezados actualizados.

Para borrar un PartnerLink, envía un DeletePartnerLinkRequest con el name establecido en el nombre del recurso. Configura los encabezados si es necesario.

Anterior
Descripción general
Siguiente
Recupera vínculos de socios