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

Identyfikator. Względna nazwa trasy dla tego pakietu aukcji. Powinna mieć postać „exchanges/{seller_id}/auctionpackages/{auction_package_id} Przykład: „exchanges/1234/auctionPackage/5678”.

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

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

enum (DiscoveryObjectStatus)

Wymagane. Stan tego pakietu aukcji. Pakiety o stanie PAUSED lub REMOVED nie są widoczne dla reklamodawców DV3.
auctionPackage.description

string

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

enum (Format)

Wymagane. Wartość niezmienna. Podstawowy typ formatu reklamy. Po utworzeniu nie można wprowadzać zmian.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Opcjonalnie. Zestawienie prognozowania dla zasobów reklamowych tego pakietu aukcji. Reklamodawcy DV3 mogą wyświetlać te podziały i filtrować według nich.
auctionPackage.externalDealId

string

Wymagane. Wartość niezmienna. Identyfikator umowy z giełdą używany w pytaniach o stawkę. Maksymalnie 100 znaków. Dopuszczalne znaki to znaki alfanumeryczne, podkreślenia, myślniki i kropki. Po utworzeniu nie można wprowadzać zmian.
auctionPackage.logoUrl

string

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

object (Money)

Wymagane. Cena minimalna tego pakietu aukcji.
auctionPackage.startTime

string (Timestamp format)

Wymagane. Czas, kiedy ten produkt stanie się aktywny. Musi być wcześniejszy niż endTime. Czas rozpoczęcia nie może być późniejszy niż 1 rok.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane 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)

Wymagane. Czas, kiedy ten produkt stanie się nieaktywny.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane 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 mediów pakietu aukcji.
auctionPackage.urgOwners[]

enum (UnderRepresentedGroup)

Opcjonalnie. Niedostatecznie reprezentowane grupy, do których należy właściciel (jeśli dotyczy).
updateMask

string (FieldMask format)

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

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

string

Tylko dane wyjściowe. Link do pakietu aukcji w DV360.

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.