Interfejs API Marketplace

Opis

Interfejs API Marketplace w Authorized Buyers to zbiór zasobów, za pomocą którego kupujący mogą automatycznie zarządzać tymi elementami:

  • Negocjacje z wydawcami
  • Pakiety aukcji
  • Dostęp klientów do interfejsu platformy handlowej Authorized Buyers

W tym przewodniku omawiamy interfejs Marketplace API i wyjaśniamy, w jaki sposób zasoby interfejsu Marketplace API są mapowane na funkcje Marketplace w Authorized Buyers.

Licytujący i kupujący

Interfejs Marketplace API ma spójność ze strukturą interfejsu API do określania stawek w czasie rzeczywistym. Oba interfejsy API używają bidders i buyers jako zasobów najwyższego poziomu na potrzeby działań licytujących i kupujących. W ścieżkach zasobów związanych z określaniem stawek w czasie rzeczywistym i interfejsami API Marketplace możesz używać tych samych nazw licytujących i kupujących.

Klienci i ich użytkownicy

Interfejs Marketplace API umożliwia tworzenie klientów i użytkowników klientów oraz zarządzanie nimi. Umożliwia też automatyczne przyznawanie agencjom i reklamodawcom dostępu do karty Rynek w interfejsie Authorized Buyers.

Client reprezentuje klienta, agencję lub reklamodawcę powiązanego z Twoim kontem Authorized Buyers.

ClientUser oznacza konkretną osobę, która ma dostęp do interfejsu na poziomie Client. Użytkownicy klientów nie mają dostępu do interfejsu Marketplace API. Użytkownicy klientów mają ograniczony dostęp do karty Rynek na Twoim koncie. Uprawnienia użytkownika klienta są określane przez role podany w jego nadrzędnym Client.

Inne zasoby w interfejsie Marketplace API odwołują się do klientów za pomocą nazwy podanej w zasobie Clients.

Więcej informacji o klientach i użytkownikach w interfejsie Marketplace w Authorized Buyers znajdziesz w tych artykułach w Centrum pomocy:

Pakiety aukcji

Interfejs Marketplace API umożliwia subskrybowanie i anulowanie subskrypcji kupujących i klientów w pakietach aukcji oraz wyświetlanie pakietów aukcji, które subskrybujesz.

Element AuctionPackage jest podobny do pakietu kierowania w przypadku zasobów reklamowych na Rynku. Pakiet aukcji może na przykład być kierowany na zbiór adresów URL i identyfikatorów aplikacji mobilnych, które są zgodne z interesami biznesowymi kupującego.

Nie możesz tworzyć nowych pakietów aukcji za pomocą interfejsu Marketplace API. Pakiety aukcji możesz tworzyć w interfejsie platformy handlowej Authorized Buyers. Interfejs Marketplace API nie zawiera konkretnych informacji o kierowaniu powiązanych z pakietami aukcji.

Możesz udostępniać pakiety aukcji innym kupującym i klientom oraz udostępniać Ci pakiety aukcji utworzone przez Google lub innych kupujących.

Więcej informacji znajdziesz w artykule Pakiety aukcji.

Profile wydawcy

Za pomocą interfejsu Marketplace API możesz wyświetlać profile wydawców, z którymi możesz negocjować.

PublisherProfile reprezentuje wydawcę w interfejsie Marketplace API. Inne zasoby w interfejsie Marketplace API odnoszą się do wydawców, których nazwa została określona w polu PublisherProfile.

Profile wydawców na karcie Odkrywanie w interfejsie Marketplace w Authorized Buyers zawierają podobne informacje jak informacje na temat wydawców.

Więcej informacji znajdziesz w artykule Jak znaleźć wydawców.

Oferty pakietowe i umowy

Do negocjowania umów z wydawcami możesz używać interfejsu Marketplace API. Oto kilka sposobów wykorzystania interfejsu Marketplace API do zarządzania umowami:

Oferty pakietowe przedstawiają najnowszy stan negocjacji co najmniej jednej umowy między kupującym lub klientem a wydawcą i są podobne do karty Negocjacje w interfejsie platformy Authorized Buyers Marketplace.

Umowy to najnowsze warunki umowy negocjowanej w ramach danej oferty pakietowej i są porównywalne z listą umów w interfejsie platformy handlowej Authorized Buyers, które w przypadku danej oferty pakietowej są oznaczone etykietą CURRENT NEGOTIATION.

Sfinalizowane umowy to umowy, które zostały zakończone fazę negocjacji i są gotowe do wyświetlenia. Dotyczy to też umów, które są już realizowane. Sfinalizowane umowy są podobne do karty Umowy w interfejsie platformy handlowej Authorized Buyers.

W zależności od typu negocjowanego umowy zachowanie może się różnić w zależności od zasobu interfejsu Marketplace API. Kupujący nie mogą na przykład inicjować negocjacji w przypadku wszystkich typów umów. Więcej informacji o wdrażaniu interfejsu Marketplace API na potrzeby negocjacji znajdziesz w tych materiałach:

Więcej informacji o negocjacjach w interfejsie Marketplace w Authorized Buyers znajdziesz w tych artykułach: