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 ( |
Pola | |
---|---|
name |
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 |
Wyświetlana nazwa tego pakietu aukcji. Musi być zakodowany w formacie UTF-8 i mieć maksymalnie 240 znaków. Wymagane. |
status |
Stan tego pakietu aukcji. Pakiety o stanie WSTRZÓWNA lub USUNIĘTA nie są wyświetlane reklamodawcom DV3. Wymagane. |
description |
Tekst opisu tego pakietu. Musi być zakodowany w formacie UTF-8 i mieć maksymalnie 2000 znaków. Wymagane. |
format |
Podstawowy typ formatu reklamy. Wymagane. Po utworzeniu nie można go zmienić. |
forecast |
Prognozy dotyczące zasobów reklamowych tego pakietu aukcji. Reklamodawcy w DV3 mogą wyświetlać te zestawienia i je filtrować. Opcjonalnie. |
externalDealId |
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 |
Tylko dane wyjściowe. Adres URL logo tego pakietu aukcji. Tylko dane wyjściowe. |
floorPrice |
Cena minimalna tego pakietu aukcji. Wymagane. |
startTime |
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: |
endTime |
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: |
mediumType |
Wymagane. Typ medium pakietu aukcji. |
urgOwners[] |
Opcjonalnie. Grupy reprezentowane przez właściciela, jeśli takie istnieją. |
dv3MarketplaceUri |
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 |
|
---|---|
|
Tworzy nowy pakiet aukcji. |
|
Pobiera pakiet aukcji. |
|
Wyświetla listę pakietów aukcji. |
|
Aktualizuje pakiet aukcji. |
|
Prześlij logo określonego pakietu. |