Method: exchanges.auctionPackages.patch

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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.