REST Resource: exchanges.auctionPackages

Zasób: AuctionPackage

Zawiera pojedynczy pakiet aukcji. Reklamodawcy w DV3 mogą przeglądać wszystkie pakiety aukcji w DV3 za pomocą interfejsu wyszukiwania na rynku i wybrać te pakiety bez konieczności podejmowania działań przez sprzedawcę.

Zapis JSON
{
  "name": string,
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "description": string,
  "format": enum (Format),
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "externalDealId": string,
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "startTime": string,
  "endTime": string,
  "mediumType": enum (MediumType),
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ],
  "dv3MarketplaceUri": string
}
Pola
name

string

Nazwa względna trasy dla tego pakietu aukcji. Powinien mieć format: „exchanges/{seller_id}/auctionpackages/{auction_package_id}. Przykład: „exchanges/1234/auctionPackage/5678”. Tylko dane wyjściowe.

displayName

string

Wyświetlana nazwa tego pakietu aukcji. Musi być zakodowany w formacie UTF-8 i mieć maksymalnie 240 znaków. Wymagane.

status

enum (DiscoveryObjectStatus)

Stan tego pakietu aukcji. Pakiety o stanie WSTRZÓWNA lub USUNIĘTA nie są wyświetlane reklamodawcom DV3. Wymagane.

description

string

Tekst opisu tego pakietu. Musi być zakodowany w formacie UTF-8 i mieć maksymalnie 2000 znaków. Wymagane.

format

enum (Format)

Podstawowy typ formatu reklamy. Wymagane. Po utworzeniu nie można go zmienić.

forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Prognozy dotyczące zasobów reklamowych tego pakietu aukcji. Reklamodawcy w DV3 mogą wyświetlać te zestawienia i je filtrować. Opcjonalnie.

externalDealId

string

Identyfikator umowy giełdy używany w pytaniach o stawkę. Maksymalnie 100 znaków. Dozwolone znaki to znaki alfanumeryczne, podkreślenia, łączniki i kropki. Wymagane. Wymagane. Nie zezwalaj na zmiany po utworzeniu.

logoUrl

string

Tylko dane wyjściowe. Adres URL logo tego pakietu aukcji.

Tylko dane wyjściowe.

floorPrice

object (Money)

Cena minimalna tego pakietu aukcji. Wymagane.

startTime

string (Timestamp format)

Czas, w którym produkt staje się aktywny. Musi być wcześniejszy niż endTime. Czas rozpoczęcia nie może być oddalony w przyszłość o więcej niż 1 rok. Wymagane.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Czas, w którym produkt przestaje być aktywny. Wymagane.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

mediumType

enum (MediumType)

Wymagane. Typ medium pakietu aukcji.

urgOwners[]

enum (UnderRepresentedGroup)

Opcjonalnie. Grupy reprezentowane przez właściciela, jeśli takie istnieją.

dv3MarketplaceUri

string

Tylko dane wyjściowe. Link DV360 do pakietu aukcji na platformie Marketplace.

Format

Format reklamy w pakiecie aukcyjnym.

Wartości w polu enum
DEAL_FORMAT_UNSPECIFIED Nieokreślony format umowy. Nieprawidłowe dane wejściowe.
DEAL_FORMAT_DISPLAY Format wyświetlania.
DEAL_FORMAT_VIDEO Format filmu.
DEAL_FORMAT_AUDIO Format audio.

Metody

create

Tworzy nowy pakiet aukcji.

get

Pobiera pakiet aukcji.

list

Wyświetla listę pakietów aukcji.

patch

Aktualizuje pakiet aukcji.
Prześlij logo określonego pakietu.