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

      // 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
}
필드
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 구성은 Exchange 측의 WSeat 구성을 지정합니다. 다중 좌석 거래를 활용하는 Exchange는 이 필드를 채우고 최신 상태로 유지해야 합니다.
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"입니다.
order.buyerInfo

object (BuyerInfo)

출력 전용입니다. 파트너 및 광고주 세부정보를 포함한 구매자 정보입니다. 인스턴트 딜 시나리오에만 적용됩니다.
updateMask

string (FieldMask format)

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

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

응답 본문

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

승인 범위

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

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

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