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

Aquí se muestra cómo crear o borrar un recurso PartnerLink. 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 anunciante de Display & Video 360
• Cuentas de Google Ad Manager

Cómo crear una vinculación

Crea un PartnerLink enviando un CreatePartnerLinkRequest.

Crea el cuerpo de la solicitud

Crea un recurso PartnerLink. Estos son los campos que puedes establecer.

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 el 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 de socio. Se establece en un objeto ProductAccount.

Establece el account_type en el AccountType de la cuenta de socio. Por ejemplo, si la vinculación es de una cuenta de anunciante a una cuenta de socio de datos, establece este campo en DATA_PARTNER.

Establece el account_id en el ID de la cuenta de socio.

Crea la solicitud

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

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

   accountTypes/{account_type}/accounts/{account}
   

2. Establece el partner_link en el recurso PartnerLink que creaste.

3. Si tus credenciales corresponden a 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, establece el encabezado login-account como se describe en Configura destinos y encabezados.

Aquí se muestran ejemplos de solicitudes en JSON para crear una vinculación a una cuenta de socio de datos en diferentes tipos de cuentas de anunciante.

Google Ads

Abrir en el Explorador de APIs

{
    "owningAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Anunciante de DV360

Abrir en el Explorador de APIs

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_ADVERTISER",
        "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Socio de DV360

Abrir en el Explorador de APIs

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_PARTNER",
        "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Google Ad Manager

Abrir en el Explorador de APIs

{
    "owningAccount": {
        "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK",
        "accountId": "INSERT_GAM_AUDIENCE_LINK_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Envía la solicitud

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

Si la solicitud se completa de forma correcta, la respuesta contendrá el PartnerLink creado con los campos id y name propagados.

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.

Cómo borrar una vinculación

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