Method: exchanges.auctionPackages.patch

Aktualizuje pakiet aukcji.

Żądanie HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
auctionPackage.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.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
Pola
auctionPackage.displayName

string

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

enum (DiscoveryObjectStatus)

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

string

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

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

Prognozy dotyczące zasobów reklamowych tego pakietu aukcji. Reklamodawcy w DV3 mogą wyświetlać te zestawienia i je filtrować. Opcjonalnie.
auctionPackage.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.
auctionPackage.logoUrl

string

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

Tylko dane wyjściowe.
auctionPackage.floorPrice

object (Money)

Cena minimalna tego pakietu aukcji. Wymagane.
auctionPackage.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".
auctionPackage.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".
auctionPackage.mediumType

enum (MediumType)

Wymagane. Typ medium pakietu aukcji.
auctionPackage.urgOwners[]

enum (UnderRepresentedGroup)

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

string (FieldMask format)

Maska określająca, które pola mają zostać zaktualizowane. Wymagane.

Jest to lista pełnych nazw pól rozdzielona przecinkami. Przykład: "user.displayName,photo".
auctionPackage.dv3MarketplaceUri

string

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

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu AuctionPackage.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Więcej informacji znajdziesz w OAuth 2.0 Overview.