Method: exchanges.orders.products.patch

제품을 업데이트합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
product.name

string

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

요청 본문

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

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
    },
    "program": string,
    "buyerCustomParameters": {
      string: string,
      ...
    },
    "etag": string
  },
  "updateMask": string
}
필드
product.displayName

string

제품의 표시 이름입니다.

최대 크기가 240바이트인 UTF-8로 인코딩되어야 합니다. 필수 항목입니다.
product.externalDealId

string

외부 ID 거래소 시스템의 거래 ID입니다. 영문 기준 최대 100자 허용되는 문자는 영숫자, 밑줄, 대시, 마침표입니다. 모든 제품에서 고유해야 합니다. 필수 항목입니다.
product.transactionType

enum (TransactionType)

제품 거래 유형입니다. 필수 항목입니다.
product.pricingType

enum (PricingType)

제품의 가격 책정 유형입니다. 필수 항목입니다.
product.updateTime
(deprecated)

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"입니다.
product.startTime

string (Timestamp format)

이 제품이 활성화되는 시간입니다. endTime 이전이어야 합니다. 시작 시간은 1년 이내여야 합니다. 필수 항목입니다.

생성된 출력은 항상 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"입니다.
product.endTime

string (Timestamp format)

이 제품이 비활성 상태가 되는 시간입니다. 2036년 이후일 수 없습니다. 필수 항목입니다.

생성된 출력은 항상 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"입니다.
product.rateDetails

object (RateDetails)

요금 세부정보 필수 항목입니다.
product.creativeConfig[]

object (CreativeConfig)

제품의 광고 소재 요구사항입니다. 예약된 거래 유형 제품에 필요합니다.
product.makegood
(deprecated)

boolean

제품이 보상 게재 제품인지 여부를 나타냅니다.
product.makegoodDetails
(deprecated)

object (MakegoodDetails)

제품의 보상 게재 세부정보입니다. 제품이 보상 게재인 경우 필수입니다.
product.creativeSource

enum (CreativeSource)

제품의 광고 소재 소스입니다. 선택사항이며 기본값은 CREATIVE_SOURCE_ADVERTISER입니다. 제품을 만든 후에는 변경할 수 없습니다.
product.mediumType

enum (MediumType)

제품의 매체 유형입니다. 이전 버전과의 호환성을 위해 지정하지 않으면 기본적으로 DIGITAL입니다. 제품을 만든 후에는 변경할 수 없습니다.
product.audienceTargetingConfig

object (AudienceTargetingConfig)

선택사항입니다. 거래소의 거래 수준에서 적용되는 잠재고객 타겟팅 구성입니다.
product.targetingCriteria

object (TargetingCriteria)

출력 전용입니다. 제품 타겟팅 기준 참조입니다. 즉시 거래 시나리오에만 적용됩니다.
product.forecastResult

object (ForecastResult)

제품 예측 결과 타겟팅 기준이 비어 있지 않고 예측이 제공되지 않는 경우에 필요합니다. 즉시 거래 시나리오에만 적용됩니다.
product.errorDetails

object (ErrorDetails)

특정 제품 필드를 업데이트할 수 없는 경우 오류 세부정보를 지정해야 합니다. 타겟팅 기준 때문에 예측 결과를 제공할 수 없거나 제품을 업데이트할 수 없는 경우에 필요합니다. 즉시 거래 시나리오에만 적용됩니다.
product.frequencyCap

object (FrequencyCap)

출력 전용입니다. 구매자가 선택한 최대 게재빈도입니다. 즉시 거래 시나리오에만 적용됩니다.
product.program

string

출력 전용입니다. 구매자가 즉시 거래를 만든 프로그램입니다. 교환의 일반적인 흐름에서는 비어 있습니다. 즉시 거래 시나리오에만 적용됩니다.
product.buyerCustomParameters

map (key: string, value: string)

출력 전용입니다. 구매자가 즉시 거래 요청에 설정한 맞춤 키/값 매개변수입니다. 즉시 거래 시나리오에만 적용됩니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
product.etag

string

제품을 업데이트할 때 지정해야 하는 ETag입니다. etag 필드가 비어 있지 않은 경우에만 업데이트를 위해 지정해야 합니다. 즉시 거래 시나리오에만 적용됩니다.
updateMask

string (FieldMask format)

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

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

응답 본문

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

승인 범위

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

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

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