REST Resource: curators.dataSegments

משאב: DataSegment

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

ייצוג ב-JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
  "userListId": string
}
שדות
name

string

לא ניתן לשינוי. מזהה. המזהה הייחודי של פלח הנתונים. מזהה החשבון תואם למזהה החשבון שבו נוצר הפלח. פורמט: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

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

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

state

enum (State)

פלט בלבד. מצב פלח הנתונים.

העמלה תחויב כשחשבונות אחרים ישתמשו בפלח הנתונים הזה. לדוגמה, כשחשבונות אחרים מוסיפים את פלח הנתונים הזה לעסקה או לחבילת מכרזים. אחרי שמגדירים את סוג העמלה של פלח הנתונים, אי אפשר לשנות אותו. ברשימה הבאה מופיעים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
cpmFee

object (Money)

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

millipercentOfMediaFee

string (int64 format)

אופציונלי. העמלה תחויב כאחוז מעלות החשיפה, והיא מיוצגת באלפיות האחוז. לדוגמה, 1% מיוצג כ-1000.

סוף השדות שמוציאים זה את זה.
userListId

string

אופציונלי. לא ניתן לשינוי. המזהה של רשימת המשתמשים שכלולה בפלח הנתונים הזה.

אוצרי נתונים עם חשבון מקושר של שותף נתונים יכולים ליצור פלח נתונים שכולל רשימת משתמשים שבבעלות החשבון המקושר של שותף הנתונים. אפשר להעלות ולנהל רשימות משתמשים באמצעות Data Manager API. קישור של רשימת משתמשים לפלח נתונים מאפשר לכם להגדיר פלח של מלאי שטחי פרסום שמבוסס על קהל שאתם יוצרים.

מדינה (State)

פלט בלבד. כדי לשנות את המצב, משתמשים בשיטה activate ו-deactivate.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED ערך ברירת המחדל.
ACTIVE פלח הנתונים פעיל.
INACTIVE פלח הנתונים לא פעיל.
SUSPENDED פלח הנתונים מושעה ואי אפשר להפעיל אותו.

Methods

activate

מפעיל פלח נתונים.

create

יוצרת פלח נתונים בבעלות האוצר שמופיע ברשימה.

deactivate

השבתה של פלח נתונים.

get

הפונקציה מקבלת פלח נתונים לפי השם שלו.

list

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

patch

עדכון של פלח נתונים.