Aby oznaczyć relację z kontem sprzedawcy, partner Zakupów musi najpierw użyć metody accounts.link w celu wysłania prośby o połączenie.
Prośba o połączenie zawiera element linkedAccountId identyfikujący sprzedawcę, który otrzymuje prośbę, i ma typ action o wartości request. Każdy link powinien też zawierać określony zestaw services określający, które cechy produktu partner udostępnia sprzedawcy. Obsługiwane są poniższe wartości services.
| Usługa | Opis |
|---|---|
shoppingAdsProductManagement |
Zarządzanie danymi produktów w reklamach produktowych |
shoppingActionsProductManagement |
Zarządzanie danymi produktów w usłudze Kup przez Google (dawniej Shopping Actions) |
shoppingActionsOrderManagement |
Zarządzanie zamówieniami w usłudze Kup przez Google (dawniej Shopping Actions) |
Prośba musi też zawierać prawidłowy atrybut linkType opisujący typ partnera Zakupów Google, który wysyła żądanie. Partnerzy ds. Zakupów mają przypisaną jedną z tych etykiet i powinni używać swojej wyznaczonej etykiety w polu linkType podczas wywoływania interfejsu API.
| Prawidłowe typy linków |
|---|
channelPartner |
eCommercePlatform |
Przykład
To wywołanie interfejsu API wysyła prośbę o połączenie z konta partnera 123456789 do sprzedawcy, którego wartość linkedAccountId wynosi "98765".
linkType "eCommercePlatform" identyfikuje partnera jako platformę handlu elektronicznego. Lista services wskazuje, że partner udostępnia funkcje "shoppingAdsProductManagement" (zarządzanie danymi produktów w reklamach produktowych) oraz "shoppingActionsOrderManagement" (zarządzanie zamówieniami w usłudze Kup przez Google, wcześniej znane jako Shopping Actions).
POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
"linkedAccountId": "98765",
"linkType": "eCommercePlatform",
"services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
"action": "request"
}
W następnej sekcji opisano, jak uzyskać listę istniejących linków.