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
    },
    "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.etag

string

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

string (FieldMask format)

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

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

응답 본문

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

승인 범위

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

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

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