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. Wygenerowany 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),

      // Union field budget can be only one of the following:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of list of possible types for union field budget.
    },
    "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 znany jako DoubleClick Bid Manager(DBM). Umożliwia podanie tylko 1 identyfikatora partnera. Wymagany.
order.publisherEmail

string

Adres e-mail wydawcy. Musi mieć prawidłowy format adresu e-mail. Maksymalnie 250 znaków. Opcjonalnie.
order.publisherName

string

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

object (Budget)

Tylko dane wyjściowe. Budżet ustalony 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 „ANULOWANO” po utworzeniu w interfejsie API, aby zasygnalizować, że to zamówienie zostało anulowane na giełdzie.
order.wseatConfig

object (WSeatConfig)

Opcjonalnie. WSeat Configuration Specifies the WSeat configuration on the exchange side. Giełdy korzystające z umów wielostanowiskowych powinny dbać o to, aby to pole było wypełnione i aktualne.
order.updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa określająca, kiedy zamówienie lub powiązane z nim produkty zostały zaktualizowane.

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 szczegóły dotyczące partnera i reklamodawcy. Dotyczy tylko scenariuszy transakcji natychmiastowych.
updateMask

string (FieldMask format)

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

Jest to lista w pełni kwalifikowanych nazw pól rozdzielonych przecinkami. 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 sekcji OAuth 2.0 Overview.