Method: exchanges.orders.products.patch

Aktualizuje produkt.

Żądanie HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{product.name=exchanges/*/orders/*/products/*}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
product.name

string

Nazwa względna trasy dla produktu. Wygenerowano przez serwer. Przykład: „exchanges/1234/orders/5678/products/abc”. Tylko dane wyjściowe.

Treść żądania

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

Zapis JSON 
{
  "product": {
    "name": string,
    "displayName": string,
    "externalDealId": string,
    "transactionType": enum (TransactionType),
    "pricingType": enum (PricingType),
    "updateTime": string,
    "startTime": string,
    "endTime": string,
    "rateDetails": {
      "rateType": enum (RateType),
      "rate": {
        object (Money)
      },
      "unitsPurchasedCount": string
    },
    "creativeConfig": [
      {
        "creativeType": enum (CreativeType),
        "dimensionCreativeConfig": {
          object (DimensionCreativeConfig)
        },
        "durationCreativeConfig": {
          object (DurationCreativeConfig)
        }
      }
    ],
    "makegood": boolean,
    "makegoodDetails": {
      "originalExternalDealId": string,
      "reason": string
    },
    "creativeSource": enum (CreativeSource),
    "mediumType": enum (MediumType),
    "audienceTargetingConfig": {
      "audienceType": enum (AudienceType)
    },
    "targetingCriteria": {
      "selectedTargetingOptions": [
        {
          object (SelectedTargetingOption)
        }
      ]
    },
    "forecastResult": {
      "forecasts": [
        {
          object (Forecast)
        }
      ]
    },
    "errorDetails": {
      "message": string,
      "instantDealErrorStatus": enum (InstantDealErrorStatus)
    },
    "frequencyCap": {
      "timeUnit": enum (TimeUnit),
      "maxImpressions": string
    },
    "etag": string
  },
  "updateMask": string
}
Pola
product.displayName

string

Wyświetlana nazwa produktu.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów. Wymagane.
product.externalDealId

string

Identyfikator zewnętrzny. Jest to identyfikator umowy w systemie giełdy. Maksymalnie 100 znaków. Dozwolone znaki to znaki alfanumeryczne, podkreślenia, łączniki i kropki. Musi być niepowtarzalna we wszystkich usługach. Wymagane.
product.transactionType

enum (TransactionType)

Typ transakcji dotyczącej produktu. Wymagane.
product.pricingType

enum (PricingType)

Typ ceny produktu. Wymagane.
product.updateTime
(deprecated)

string (Timestamp format)

Sygnatura czasowa określająca, kiedy produkt został ostatnio zaktualizowany.

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".
product.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".
product.endTime

string (Timestamp format)

Czas, w którym produkt przestaje być aktywny. Obecnie nie może być późniejsza niż 2036 r. 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".
product.rateDetails

object (RateDetails)

Szczegóły stawki. Wymagane.
product.creativeConfig[]

object (CreativeConfig)

Wymagania dotyczące kreacji dla produktu. Wymagane w przypadku produktu typu zarezerwowana transakcja.
product.makegood
(deprecated)

boolean

Określa, czy produkt jest produktem w ramach rekompensaty.
product.makegoodDetails
(deprecated)

object (MakegoodDetails)

Szczegóły rekompensaty za produkt. Wymagany, gdy produkt jest przedmiotem rekompensaty.
product.creativeSource

enum (CreativeSource)

Źródło kreacji produktu. Opcjonalny, domyślnie CREATIVE_SOURCE_ADVERTISER. Po utworzeniu produktu nie można tego zmienić.
product.mediumType

enum (MediumType)

Typ nośnika produktu. Jeśli nie zostanie podany, domyślnie przyjmuje się DIGITAL na potrzeby zgodności wstecznej. Po utworzeniu produktu nie można tego zmienić.
product.audienceTargetingConfig

object (AudienceTargetingConfig)

Opcjonalnie. Konfiguracja kierowania na odbiorców wybrana na poziomie umowy na giełdzie.
product.targetingCriteria

object (TargetingCriteria)

Tylko dane wyjściowe. Odwołania do kryteriów kierowania na produkt Dotyczy tylko scenariuszy umów błyskawicznych.
product.forecastResult

object (ForecastResult)

Wyniki prognozy dotyczącej produktów. Wymagany, gdy kryteria kierowania nie są puste i nie ma prognozy. Dotyczy tylko scenariuszy umów błyskawicznych.
product.errorDetails

object (ErrorDetails)

W przypadku, gdy nie można zaktualizować określonych pól produktu, należy podać szczegóły błędu. Wymagane, gdy nie można podać wyniku prognozy z powodu kryterium kierowania lub gdy nie można zaktualizować produktu. Dotyczy tylko scenariuszy umów błyskawicznych.
product.frequencyCap

object (FrequencyCap)

Tylko dane wyjściowe. Limit wyświetleń na użytkownika wybrany przez kupującego. Dotyczy tylko scenariuszy umów błyskawicznych.
product.etag

string

Tag, który musi zostać podany podczas aktualizowania produktu. Musisz go podać tylko wtedy, gdy pole etag nie jest puste. Dotyczy tylko scenariuszy umów błyskawicznych.
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".

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.