Method: exchanges.orders.patch

주문을 업데이트합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
order.name

string

주문의 상대 리소스 이름입니다. 서버에서 생성됩니다. 예: 'exchanges/1234/orders/5678' 출력 전용입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

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
  },
  "updateMask": string
}
필드
order.displayName

string

구매자에게 표시되는 주문 이름입니다. 최대 250자(영문 기준) 선택사항입니다.
order.partnerId[]

string (int64 format)

이전 명칭이 Doubleclick Bid Manager(DBM)인 Google Display & Video 360의 파트너 ID입니다. 단일 파트너 ID만 허용합니다. 필수 항목입니다.
order.publisherEmail

string

게시자의 이메일입니다. 유효한 이메일 형식이어야 합니다. 최대 250자(영문 기준) 선택사항입니다.
order.publisherName

string

게시자 이름입니다. 최대 250자(영문 기준) 필수 항목입니다.
order.budget

object (Budget)

예산 인스턴트 거래 시나리오에만 적용됩니다. 출력 전용입니다.
order.status

enum (OrderStatus)

주문 상태. DV3 사용자가 주문을 수락, 취소 또는 보관처리하면 상태가 변경될 수 있습니다. 또한 API에서 생성 후 'CANCELLED'로 업데이트하여 이 주문이 Exchange에서 취소되었음을 알립니다.
order.wseatConfig

object (WSeatConfig)

선택사항입니다. WSeat 구성 교환 측의 WSeat 구성을 지정합니다. 다중 좌석 거래를 사용하는 거래소는 이 필드를 채우고 최신 상태로 유지해야 합니다.
order.updateTime

string (Timestamp format)

출력 전용입니다. 주문 또는 기본 제품이 업데이트된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateMask

string (FieldMask format)

업데이트할 필드를 제어하는 마스크입니다. 필수 항목입니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"

응답 본문

성공한 경우 응답 본문에 Order의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 Overview를 참조하세요.