Method: exchanges.auctionPackages.patch

עדכון של חבילת מכרז.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
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)

חובה. הסטטוס של חבילת המכרז הזו. חבילות עם הסטטוס PAUSED או REMOVED לא מוצגות למפרסמים ב-DV360.
auctionPackage.description

string

חובה. טקסט התיאור של החבילה. הקידוד חייב להיות UTF-8, והגודל המקסימלי הוא 2,000 תווים.
auctionPackage.format

enum (Format)

חובה. אי אפשר לשנות. סוג פורמט המודעה הבסיסי. אחרי שיוצרים את המרחב, אי אפשר לעדכן את ההגדרה הזו.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

אופציונלי. פירוט התחזית של מלאי שטחי הפרסום בחבילת המכרז הזו. מפרסמים ב-DV360 יכולים לראות את הפירוטים האלה ולסנן אותם.
auctionPackage.externalDealId

string

חובה. אי אפשר לשנות. מזהה הדיל בבורסה שמשמש בבקשות להצעות מחיר. עד 100 תווים. התווים המותרים הם אלפאנומריים, קו תחתון, מקף ונקודה. אחרי שיוצרים את המרחב, אי אפשר לעדכן את ההגדרה הזו.
auctionPackage.logoUrl

string

פלט בלבד. כתובת ה-URL של הלוגו של חבילת המכרז הזו.
auctionPackage.floorPrice

object (Money)

חובה. מחיר המינימום של חבילת המכרז הזו.
auctionPackage.startTime

string (Timestamp format)

חובה. הזמן שבו המוצר הזה הופך לפעיל. התאריך חייב להיות מוקדם יותר מ-endTime. שעת ההתחלה לא יכולה להיות יותר משנה קדימה.

הפלט שנוצר תמיד יהיה בפורמט 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 לחבילת מכירה פומבית ב-marketplace.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של AuctionPackage.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.