Method: exchanges.orders.patch

Aktualizuje zamówienie.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
order.name

string

Względna nazwa zasobu zamówienia. Generowana przez serwer. Przykład: „exchanges/1234/orders/5678”. Tylko dane wyjściowe.

Treść żądania

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

Zapis JSON 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "budgetType": enum (BudgetType),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string,
    "buyerInfo": {
      "partner": {
        object (PartnerInfo)
      },
      "advertisers": [
        {
          object (AdvertiserInfo)
        }
      ]
    }
  },
  "updateMask": string
}
Pola
order.displayName

string

Nazwa zamówienia wyświetlana kupującemu. Maksymalnie 250 znaków. Opcjonalnie.
order.partnerId[]

string (int64 format)

Identyfikator partnera w Google Display &Video 360, wcześniej znanym jako DoubleClick Bid Manager(DBM). Dozwolony jest tylko 1 identyfikator partnera. Wymagane.
order.publisherEmail

string

Adres e-mail wydawcy. Musi być w prawidłowym formacie. Maksymalnie 250 znaków. Opcjonalnie.
order.publisherName

string

Nazwa wydawcy. Maksymalnie 250 znaków. Wymagane.
order.budget

object (Budget)

Tylko dane wyjściowe. Budżet ustawiony przez kupującego. Dotyczy tylko scenariuszy transakcji natychmiastowych.
order.status

enum (OrderStatus)

Stan zamówienia. Stan może się zmienić, gdy użytkownicy DV3 zaakceptują, anulują lub zarchiwizują zamówienie. Obsługuje też aktualizację do stanu „ANULOWANEGO” po utworzeniu w interfejsie API, aby wskazać, że to zamówienie zostało anulowane w usłudze Exchange.
order.wseatConfig

object (WSeatConfig)

Opcjonalnie. Konfiguracja WSeat określa konfigurację WSeat po stronie giełdy. Oczekuje się, że giełdy korzystające z transakcji wielostanowiskowych będą utrzymywać to pole wypełnione i aktualne.
order.updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa aktualizacji zamówienia lub jego produktów.

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".
order.buyerInfo

object (BuyerInfo)

Tylko dane wyjściowe. Informacje o kupującym, w tym dane partnera i reklamodawcy. Dotyczy tylko scenariuszy transakcji natychmiastowych.
updateMask

string (FieldMask format)

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

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

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.