Method: exchanges.auctionPackages.patch

입찰 패키지를 업데이트합니다.

HTTP 요청

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

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

경로 매개변수

매개변수
auctionPackage.name

string

이 입찰 패키지의 상대 경로 이름입니다. 형식은 'exchanges/{seller_id}/auctionpackages/{auction_package_id}'여야 합니다(예: 'exchanges/1234/auctionPackage/5678'). 출력 전용입니다.

요청 본문

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

JSON 표현 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
필드
auctionPackage.displayName

string

이 입찰 패키지의 표시 이름입니다. UTF-8로 인코딩되어야 하며 최대 크기는 240자(영문 기준)입니다. 필수 항목입니다.
auctionPackage.status

enum (DiscoveryObjectStatus)

이 입찰 패키지의 상태입니다. '일시중지됨' 또는 '삭제됨' 상태의 패키지는 DV3 광고주에게 표시되지 않습니다. 필수 항목입니다.
auctionPackage.description

string

이 패키지의 설명 텍스트입니다. UTF-8로 인코딩되어야 하며 최대 크기는 2,000자(영문 기준)입니다. 필수 항목입니다.
auctionPackage.format

enum (Format)

기본 광고 형식 유형입니다. 필수 항목입니다. 생성 후에는 업데이트할 수 없습니다.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

이 입찰 패키지의 인벤토리에 대한 예측 분석입니다. DV3 광고주는 이러한 분류를 보고 필터링할 수 있습니다. 선택사항입니다.
auctionPackage.externalDealId

string

입찰 요청에 사용된 거래소 거래 ID입니다. 영문 기준 최대 100자 영숫자, 밑줄, 대시, 마침표만 사용할 수 있습니다. 필수 항목입니다. 필수 항목입니다. 생성 후 업데이트를 허용하지 않습니다.
auctionPackage.logoUrl

string

출력 전용입니다. 이 입찰 패키지의 로고 URL입니다.

출력 전용입니다.
auctionPackage.floorPrice

object (Money)

이 입찰 패키지의 가격 하한선입니다. 필수 항목입니다.
auctionPackage.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"입니다.
auctionPackage.endTime

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"입니다.
auctionPackage.mediumType

enum (MediumType)

필수 항목입니다. 입찰 패키지의 매체 유형입니다.
auctionPackage.urgOwners[]

enum (UnderRepresentedGroup)

선택사항입니다. 소유자가 소속된 소수자 집단(있는 경우)
updateMask

string (FieldMask format)

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

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

string

출력 전용입니다. 마켓플레이스의 입찰 패키지용 DV360 링크입니다.

응답 본문

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

승인 범위

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

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

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