Créer ou supprimer un lien de partenaire

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

• Comptes Google Ads
• Comptes de partenaires ou d'annonceurs Display & Video 360
• Comptes Google Ad Manager

Créer une association

Créez un PartnerLink en envoyant un CreatePartnerLinkRequest.

Créer le corps de la requête

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

owning_account

Identifie le compte d'annonceur propriétaire du lien. Définissez un objet ProductAccount.

Définissez account_type sur l'AccountType du compte d'annonceur.

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

Consultez le guide sur les destinations et les en-têtes pour savoir quel ID utiliser pour chaque type d'annonceur.

partner_account

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

Définissez account_type sur l'AccountType du compte partenaire. Par exemple, si le lien provient d'un compte d'annonceur vers un compte de 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 un lien partenaire, créez un CreatePartnerLinkRequest.

1. Définissez parent sur le nom de ressource du compte d'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 correspondent à un compte Google ayant accès à un compte parent du compte d'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 au format JSON permettant de créer une association à un compte de partenaire pour les données dans différents types de comptes d'annonceur.

Google Ads

Ouvrir dans APIs Explorer

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

annonceur DV360

Ouvrir dans APIs Explorer

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

Partenaire DV360

Ouvrir dans APIs Explorer

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

Google Ad Manager

Ouvrir dans APIs Explorer

{
    "owningAccount": {
        "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK",
        "accountId": "INSERT_GAM_AUDIENCE_LINK_ID"
    },
    "partnerAccount": {
        "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 l'élément PartnerLink créé avec les champs 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 un lien

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