REST Resource: exchanges.publishers

משאב: בעל תוכן דיגיטלי

מכיל בעל תוכן דיגיטלי יחיד.

ייצוג ב-JSON 
{
  "name": string,
  "externalPublisherId": string,
  "externalPublisherIds": [
    string
  ],
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "mediumCapability": enum (MediumCapability),
  "description": string,
  "contactInfo": [
    string
  ],
  "commitmentCapability": [
    enum (CommitmentCapability)
  ],
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "ceilingPrice": {
    object (Money)
  },
  "generalCapability": string,
  "tvMetadata": {
    object (TVMetadata)
  },
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ]
}
שדות
name

string

פלט בלבד. שם המסלול היחסי של בעל האפליקציה הזה. צריך להיות בפורמט: exchanges/{seller_id}/publishers/{publisherId}. דוגמה: exchanges/1234/publishers/5678.
externalPublisherId

string

חובה. [DEPRECATED] השדה הזה יוחלף בקרוב ב-externalPublisherIds[]. Exchange provided unique publisher id. חייב להיות תואם למזהה בעל התוכן הדיגיטלי שנשלח בבקשות להצעות מחיר.

עד 100 תווים. התווים החוקיים הם תווים אלפאנומריים, קו תחתון, מקף נקודה.
externalPublisherIds[]

string

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

עד 10 ספירות. עד 100 תווים לכל מזהה. התווים החוקיים הם תווים אלפאנומריים, קו תחתון, מקף נקודה.
displayName

string

חובה. השם המוצג של בעלי האפליקציה. השדה חייב להיות מקודד ב-UTF-8 באורך של עד 30 תווים.
status

enum (DiscoveryObjectStatus)

חובה. הסטטוס של בעל התוכן הדיגיטלי הזה. בעלי תוכן דיגיטלי בסטטוס 'מושהה' או 'הוסר' לא מוצגים למפרסמים ב-DV3.
mediumCapability

enum (MediumCapability)

חובה. אמצעי המדיה שבהם בעל התוכן הדיגיטלי מתכנן לארח את המודעות שלו.
description

string

חובה. טקסט התיאור של המוציא לאור הזה. חייב להיות מקודד ב-UTF-8 בגודל של עד 1,000 תווים. חובה.
contactInfo[]

string

חובה. כתובות אימייל של אנשי קשר שבאמצעותן המפרסמים יכולים ליצור קשר עם בעל התוכן הדיגיטלי. עד 10 אנשי קשר. כל איש קשר יכול להכיל עד 100 תווים. דוגמה: [איש קשר בארה"ב – ג'ון סמית: john.smith@abc.com]. חובה.
commitmentCapability[]

enum (CommitmentCapability)

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

object (SellerProvidedInventoryAvailabilityEstimate)

חובה. פירוט של התחזיות למלאי שטחי הפרסום של בעל התוכן הדיגיטלי הזה. מפרסמים עם DV3 יכולים לראות את פירוטי הנתונים האלה ולסנן אותם. נדרש פירוט של תחזית הדומיין.
logoUrl

string

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

object (Money)

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

object (Money)

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

string

אופציונלי.
tvMetadata

object (TVMetadata)

אופציונלי. מטא-נתונים של בעל תוכן דיגיטלי שיש לו תכנים לטלוויזיה. חובה כשיכולת המדיום מכילה טלוויזיה. לא רלוונטי כשיכולת המדיום לא מכילה טלוויזיה.
urgOwners[]

enum (UnderRepresentedGroup)

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

MediumCapability

Enumeration של יכולות ברמה בינונית. ממשק הקצה של Marketplace (בתוך מודול המלאי של DV360) כולל קטעים שונים של מלאי שטחי פרסום. "דיגיטל: הנתונים האלה כוללים בעלי תוכן דיגיטלי וחבילות מכרזים שכוללות מלאי שטחי פרסום לרשת המדיה, וידאו (כולל CTV ו-OTT) ואודיו". 'טלוויזיה:' זהו הקטע הייעודי החדש שלנו לגילוי מלאי שטחי פרסום ב-CTV וב-OTT. CTV ו-OTT מוגדרים באופן הבא: "טלוויזיה מחוברת (CTV) כוללת את כל המכשירים שתואמים לתיאור הבא: - מכשירים מחוברים או סטרימרים: מכשירים שמתחברים למסך הטלוויזיה כדי להציג שידורי וידאו (Roku,‏ Apple TV וכו'). - טלוויזיה חכמה: טלוויזיות עם חיבורי אינטרנט משולבים (טלוויזיה חכמה של Samsung וכו') - קונסולות משחקים: קונסולות משחקים שמחוברות לאינטרנט (Xbox‏, PlayStation‏, Wii וכו') - ממירים: מכשירים שמספקים תוכן כבלים מסורתי ותוכן וידאו על פי דרישה (VOD)." 'Over the Top (OTT)' (מעבר לפסגה) הוא תוכן וידאו שדומה לתוכן בטלוויזיה, שמסופק על ידי ספק וידאו דרך האינטרנט מחוץ לרשתות הסגורות של ספקי התקשורת והכבלים. אפשר לצפות ב-OTT Video במחשב, בנייד, בטאבלט, ובמכשירי CTV או STB (כל עוד התוכן מועבר דרך IP במכשירים האחרונים). "אודיו: זהו קטע ייעודי חדש שמיועד למלאי שטחי הפרסום של אודיו". 'OOH: בעלי תוכן דיגיטלי מחוץ לבית'.

טיפוסים בני מנייה (enum)
MEDIUM_CAPABILITY_UNSPECIFIED יכולת בינונית לא צוינה. הקלט לא תקין.
MEDIUM_CAPABILITY_DIGITAL יכולת דיגיטלית בינונית.
MEDIUM_CAPABILITY_TV טלוויזיה עם יכולות בינוניות.
MEDIUM_CAPABILITY_AUDIO אודיו עם יכולת בינונית.
MEDIUM_CAPABILITY_OOH יכולת בינונית מחוץ לבית.

CommitmentCapability

טיפוס enum של יכולת ההתחייבות.

טיפוסים בני מנייה (enum)
COMMITMENT_CAPABILITY_UNSPECIFIED לא צוינה יכולת ההתחייבות. הקלט לא תקין.
COMMITMENT_CAPABILITY_GUARANTEED למקור החדשות יש מלאי שטחי פרסום מובטח.
COMMITMENT_CAPABILITY_NON_GUARANTEED למקור החדשות יש מלאי שטחי פרסום לא מובטח.

TVMetadata

מטא-נתונים לבעלי תוכן דיגיטלי שיש להם תכנים לטלוויזיה.

ייצוג ב-JSON 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
שדות
tvDeliveryType

enum (TVDeliveryType)

חובה. סוג ההצגה של מודעות בטלוויזיה.
topShows[]

string

אופציונלי. רשימה של כותרות של תוכניות טלוויזיה מובילות שבבעלות בעל האפליקציה. גודל מקסימלי: 10. הקידוד חייב להיות UTF-8.

TVDeliveryType

טיפוס מנייה (enum) של סוג מסירה לטלוויזיה.

טיפוסים בני מנייה (enum)
TV_DELIVERY_TYPE_UNSPECIFIED סוג ההעברה לטלוויזיה לא צוין. הקלט לא תקין.
TV_DELIVERY_TYPE_CTV סוג העברת הנתונים בטלוויזיה: טלוויזיה מחוברת.
TV_DELIVERY_TYPE_LINEAR_TV סוג העברת המודעות בטלוויזיה: טלוויזיה לינארית.

Methods

create

 יצירת בעל תוכן דיגיטלי חדש.

get

 הפונקציה מקבלת בעל תוכן דיגיטלי.

list

 הצגת רשימת בעלי תוכן דיגיטלי.

patch

 עדכון של בעל תוכן דיגיטלי.
העלאת הלוגו של אתר החדשות.