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

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสดีลของ Exchange ที่ใช้ในคำขอราคาเสนอ สูงสุด 100 อักขระ อักขระที่อนุญาตคือตัวอักษรและตัวเลข ขีดล่าง ขีดกลาง และจุด ไม่อนุญาตให้อัปเดตหลังจากสร้าง
auctionPackage.logoUrl

string

เอาต์พุตเท่านั้น URL สำหรับโลโก้ของแพ็กเกจการประมูลนี้
auctionPackage.floorPrice

object (Money)

ต้องระบุ ราคาพื้นของแพ็กเกจการประมูลนี้
auctionPackage.startTime

string (Timestamp format)

ต้องระบุ เวลาที่ผลิตภัณฑ์นี้เริ่มใช้งาน ต้องก่อนเวลาสิ้นสุด เวลาเริ่มต้นต้องไม่เกิน 1 ปีนับจากปัจจุบัน

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
auctionPackage.endTime

string (Timestamp format)

ต้องระบุ เวลาที่ผลิตภัณฑ์นี้สิ้นสุดการใช้งาน

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "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