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 partenaire ou d'annonceur Display & Video 360

Créez un PartnerLink en envoyant un CreatePartnerLinkRequest.

Construire 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éfini sur un objet ProductAccount.

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

Définissez account_id sur l'ID du compte de l'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éfini sur un objet ProductAccount.

Définissez account_type sur AccountType du compte partenaire. Par exemple, si le lien va d'un compte d'annonceur à un compte de partenaire de 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 de 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 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 d'associer un compte partenaire pour les données à différents types de comptes d'annonceur.

Ouvrir dans APIs 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 APIs 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 APIs 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 les 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'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.

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

Précédent
Aperçu
Suivant
Récupérer les liens de partenaires