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

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

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

Para crear un PartnerLink, envía una CreatePartnerLinkRequest.

Crea el cuerpo de la solicitud

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

owning_account

Identifica la cuenta de anunciante que posee el vínculo. Configúralo como un ProductAccount objeto.

Configura el account_type como el AccountType de la cuenta de anunciante.

Configura account_id como el ID de la cuenta de anunciante.

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

partner_account

Identifica la cuenta del socio. Configúralo como un ProductAccount objeto.

Configura el account_type como el AccountType de la cuenta del socio. Por ejemplo, si el vínculo es de una cuenta de anunciante a una cuenta de socio de datos cuenta, configura este campo como DATA_PARTNER.

Configura account_id como el ID de la cuenta del socio.

Crea la solicitud

Para crear un vínculo de socio, crea un CreatePartnerLinkRequest.

  1. Configura parent como el nombre del recurso de la cuenta de anunciante. Usa el siguiente formato:

    accountTypes/{account_type}/accounts/{account}

  2. Configura partner_link como el recurso PartnerLink que creaste.

  3. Si tus credenciales son para una Cuenta de Google con acceso a una cuenta superior de la cuenta de 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 JSON para crear un vínculo a una cuenta de socio de datos en diferentes tipos de cuentas de anunciante.

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 los encabezados de solicitud. Usa credenciales para una Cuenta de Google con acceso a owning_account.

Si la solicitud se realiza correctamente, la respuesta contendrá el PartnerLink 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 solucionar cualquier problema y, luego, envía la solicitud y los encabezados actualizados.

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

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