Répertorier les associations

Plusieurs associations peuvent être signalées entre les comptes des partenaires Shopping et les comptes marchands individuels et d'autres comptes. La méthode listlinks renvoie une liste de toutes ces associations pour le compte Merchant Center qui effectue l'appel d'API. Elle ne nécessite aucun paramètre et est invoquée à l'aide d'une requête GET HTTP.

État du service

Lorsque les associations sont répertoriées, les réponses affichent le paramètre status pour chaque service individuel dans une association. Les marchands ont la possibilité d'approuver tous les services répertoriés ou seulement un sous-ensemble des services proposés dans la requête.

Les services sont à l'état pending jusqu'à ce qu'ils soient explicitement approuvés par un marchand. Une fois approuvés, les services passent à l'état active.

Les services supprimés sont à l'état inactive si d'autres services à l'état pending ou active sont également présents. Une fois que tous les services comportant une association ont été supprimés, l'association n'est plus renvoyée par la méthode listlinks.

Exemple de requête

Pour répertorier la demande d'association envoyée par le partenaire 123456789, envoyez une requête GET sans paramètre à l'aide de la méthode listlinks.

GET https://www.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks

Exemple de réponse

Dans cet exemple, le marchand 98765 n'a pas encore approuvé la requête. Chacun des services est donc à l'état pending.

{
    "linkedAccountId": "98765",
    "services": [
        {
            "service": "shoppingAdsProductManagement",
            "status": "pending"
        },
        {
            "service": "shoppingActionsOrderManagement",
            "status": "pending"
        }
    ]
}

La section suivante explique comment approuver une demande d'association.