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

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

string

เอาต์พุตเท่านั้น URL ของโลโก้แพ็กเกจการประมูลนี้

เอาต์พุตเท่านั้น
auctionPackage.floorPrice

object (Money)

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

string (Timestamp format)

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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