REST Resource: partners.inventorySources

משאב: InventorySource

מקור מלאי.

ייצוג ב-JSON 
{
  "name": string,
  "inventorySourceId": string,
  "displayName": string,
  "inventorySourceType": enum (InventorySourceType),
  "inventorySourceProductType": enum (InventorySourceProductType),
  "commitment": enum (InventorySourceCommitment),
  "deliveryMethod": enum (InventorySourceDeliveryMethod),
  "dealId": string,
  "status": {
    object (InventorySourceStatus)
  },
  "exchange": enum (Exchange),
  "updateTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "publisherName": string,
  "timeRange": {
    object (TimeRange)
  },
  "creativeConfigs": [
    {
      object (CreativeConfig)
    }
  ],
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}
שדות
name

string

פלט בלבד. שם המשאב של מקור המלאי.
inventorySourceId

string (int64 format)

פלט בלבד. המזהה הייחודי של מקור המלאי. מוקצה על ידי המערכת.
displayName

string

השם המוצג של מקור המלאי.

הערך חייב להיות מקודד ב-UTF-8 ובגודל של עד 240 בייטים.
inventorySourceType

enum (InventorySourceType)

מציין את הסוג של מקור המלאי.
inventorySourceProductType

enum (InventorySourceProductType)

פלט בלבד. סוג המוצר של מקור מלאי שטחי הפרסום, שמציין את הדרך שבה הוא מוכר מלאי.
commitment

enum (InventorySourceCommitment)

אם מקור המלאי כולל אספקה מובטחת או לא מובטחת.
deliveryMethod

enum (InventorySourceDeliveryMethod)

שיטת הצגת המודעות של מקור מלאי שטחי הפרסום.

  • במקורות מלאי שטחי פרסום לא מובטחים, הערך הקביל היחיד הוא INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
  • במקורות מלאי מובטח, הערכים הקבילים הם INVENTORY_SOURCE_DELIVERY_METHOD_TAG ו-INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
dealId

string

המזהה במרחב של הבורסה שמזהה באופן ייחודי את מקור מלאי שטחי הפרסום.

המזהה חייב להיות ייחודי לכל קונה בכל בורסה, אבל לא בהכרח ייחודי בכל הבורסות.
status

object (InventorySourceStatus)

הגדרות הסטטוס של מקור המלאי.
exchange

enum (Exchange)

בורסת הפרסום שאליה שייך מקור מלאי שטחי הפרסום.
updateTime

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".
rateDetails

object (RateDetails)

חובה. פרטי התעריף של מקור מלאי שטחי הפרסום.
publisherName

string

שם בעל התוכן הדיגיטלי או המפיץ של מקור מלאי שטחי הפרסום.
timeRange

object (TimeRange)

טווח התאריכים שבו המקור הזה של מלאי שטחי הפרסום מתחיל ומפסיק להציג מודעות.
creativeConfigs[]

object (CreativeConfig)

הדרישות לגבי נכסי הקריאייטיב של מקור המלאי.

לא רלוונטי לחבילות מכרזים.
guaranteedOrderId

string

לא ניתן לשינוי. המזהה של ההזמנה המובטחת שמקור המלאי הזה שייך אליה.

רלוונטי רק כש-commitment הוא INVENTORY_SOURCE_COMMITMENT_GUARANTEED.
readWriteAccessors

object (InventorySourceAccessors)

השותף או המפרסמים שיש להם גישת קריאה/כתיבה למקור מלאי שטחי הפרסום.

פלט רק כש-commitment הוא INVENTORY_SOURCE_COMMITMENT_GUARANTEED, ובמקרה כזה פונקציות ה-accessor לקריאה/כתיבה עוברות בירושה מההזמנה המובטחת ברמה ההורה.

חובה כשהערך של commitment הוא INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED.

אם commitment הוא INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED ומוגדר שותף בשדה הזה, לכל המפרסמים שמשויכים לשותף הזה תהיה באופן אוטומטי הרשאת קריאה בלבד למקור המלאי. המפרסמים האלה לא ייכללו בreadAdvertiserIds.
readAdvertiserIds[]

string (int64 format)

פלט בלבד. המזהים של המפרסמים שיש להם הרשאת קריאה בלבד למקור מלאי שטחי הפרסום.
readPartnerIds[]

string (int64 format)

פלט בלבד. המזהים של השותפים שיש להם הרשאת קריאה בלבד למקור המלאי.

כל המפרסמים של השותפים בשדה הזה מקבלים הרשאת קריאה בלבד למקור המלאי.

Methods

get

 מקבלת עסקה של מקור מלאי שטחי פרסום.

list

 הצגת רשימה של עסקאות במקור של מלאי שטחי פרסום.