Créer ou supprimer un lien de partenaire

Voici comment créer ou supprimer une PartnerLink ressource. L'API Data Manager permet de créer des associations de partenaires pour les types de comptes suivants :

• Comptes Google Ads
• Comptes partenaire Display &Video 360 ou annonceur Display &Video 360

Créer une association

Créez un PartnerLink en envoyant une CreatePartnerLinkRequest.

Créer le corps de la requête

Créez une PartnerLink ressource. Voici les champs à définir.

owning_account

Identifie le compte annonceur propriétaire de l'association. Définissez-le sur un ProductAccount objet.

Définissez le account_type sur le AccountType du compte annonceur.

Définissez account_id sur l'ID du compte annonceur.

Pour savoir quel ID utiliser pour chaque type d'annonceur, consultez le guide sur les destinations et les en-têtes pour obtenir des instructions.

partner_account

Identifie le compte partenaire. Définissez-le sur un ProductAccount objet.

Définissez le account_type sur le AccountType du compte partenaire. Par exemple, si l'association va d'un compte annonceur à un compte partenaire pour les données, définissez ce champ sur DATA_PARTNER.

Définissez account_id sur l'ID du compte partenaire.

Créer la requête

Pour créer une association de partenaires, créez un CreatePartnerLinkRequest.

1. Définissez parent sur le nom de ressource du compte annonceur. Utilisez le format suivant :

   accountTypes/{account_type}/accounts/{account}
   

2. Définissez partner_link sur la ressource PartnerLink que vous avez créée.

3. Si vos identifiants concernent un compte Google ayant accès à un compte parent du compte annonceur, tel qu'un compte administrateur Google Ads ou un compte partenaire Display & Video 360, définissez l'en-tête login-account comme décrit dans Configurer les destinations et les en-têtes.

Voici des exemples de requêtes JSON permettant de créer une association avec un compte partenaire pour les données dans différents types de comptes annonceur.

Google Ads

Ouvrir dans l'API Explorer

{
    "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"
        }
    }
}

Annonceur DV360

Ouvrir dans l'API Explorer

{
    "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"
        }
    }
}

Partenaire DV360

Ouvrir dans l'API Explorer

{
    "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"
        }
    }
}

Envoyer la requête

Envoyez la requête et, si nécessaire, incluez des en-têtes de requête. Utilisez les identifiants d'un compte Google ayant accès à owning_account.

Si la requête aboutit, la réponse contient le PartnerLink avec les id et name renseignés.

Si la requête échoue, examinez les erreurs pour déterminer la cause de l'échec, mettez à jour la requête et les en-têtes pour résoudre les problèmes, puis envoyez la requête et les en-têtes mis à jour.

Supprimer une association

Pour supprimer un PartnerLink, envoyez une DeletePartnerLinkRequest avec le name défini sur le nom de ressource. Définissez les en-têtes si nécessaire.