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

필수 항목입니다. 이 입찰 패키지의 표시 이름입니다. 최대 크기가 240자인 UTF-8로 인코딩되어야 합니다.
auctionPackage.status

enum (DiscoveryObjectStatus)

필수 항목입니다. 이 입찰 패키지의 상태입니다. 상태가 PAUSED 또는 REMOVED인 패키지는 DV3 광고주에게 표시되지 않습니다.
auctionPackage.description

string

필수 항목입니다. 이 패키지의 설명 텍스트입니다. 최대 크기가 2,000자인 UTF-8로 인코딩되어야 합니다.
auctionPackage.format

enum (Format)

필수 항목입니다. 변경할 수 없습니다. 기본 광고 형식 유형입니다. 생성 후에는 업데이트가 허용되지 않습니다.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

필수 항목입니다. 변경할 수 없습니다. 입찰 요청에 사용되는 Exchange 거래 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를 참고하세요.