REST Resource: users

משאב: משתמש

משתמש יחיד ברשת המדיה וידאו 360

ייצוג JSON 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
שדות
name

string

פלט בלבד. שם המשאב של המשתמש.
userId

string (int64 format)

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

string

חובה. קבוע. כתובת האימייל שמשמש לזיהוי המשתמש.
displayName

string

חובה. השם המוצג של המשתמש.

הקידוד חייב להיות UTF-8 והגודל המקסימלי הוא 240 בייטים.
assignedUserRoles[]

object (AssignedUserRole)

תפקידי המשתמשים שהוקצו.

חובה ב-users.create. פלט רק ב-users.patch. אפשר לעדכן אותו רק דרך users.bulkEditAssignedUserRoles.
lastLoginTime

string (Timestamp format)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

AssignedUserRole

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

ייצוג JSON 
{
  "assignedUserRoleId": string,
  "userRole": enum (UserRole),

  // Union field entity_id can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field entity_id.
}
שדות
assignedUserRoleId

string

פלט בלבד. המזהה של תפקיד המשתמש שהוקצה.
userRole

enum (UserRole)

חובה. תפקיד המשתמש שצריך להקצות למשתמש בישות.

שדה איחוד entity_id. חובה.

המזהה של הישות שאליה חל תפקיד המשתמש שהוקצה. entity_id יכול להיות רק אחת מהאפשרויות הבאות:
partnerId

string (int64 format)

המזהה של השותף שעליו חל תפקיד המשתמש שהוקצה.
advertiserId

string (int64 format)

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

UserRole

תפקידי משתמש אפשריים.

טיפוסים בני מנייה (enum)
USER_ROLE_UNSPECIFIED ערך ברירת המחדל כשתפקיד המשתמש לא מצוין או לא ידוע בגרסה הזו.
ADMIN המשתמש יכול לנהל קמפיינים, נכסי קריאייטיב, הזמנות קמפיין, פריטים ודוחות עבור הישות. הם יכולים להציג ולערוך את נתוני החיוב, ליצור או לשנות משתמשים ולהפעיל או להשבית חילופי מטבעות. אפשר להקצות את התפקיד הזה רק לישות שותפה.
ADMIN_PARTNER_CLIENT המשתמש יכול לנהל קמפיינים, נכסי קריאייטיב, הזמנות קמפיין, פריטים ודוחות עבור הישות. הם יכולים ליצור ולשנות משתמשי ADMIN_PARTNER_CLIENT אחרים ולהציג נתוני חיוב. הם לא יכולים לצפות במודלים של הכנסות, בתגי עיצוב או בשדות אחרים שרגישים למפיצים. אפשר להקצות את התפקיד הזה רק לישות שותפה.
STANDARD המשתמש יכול לנהל את הקמפיינים, נכסי הקריאייטיב, הזמנות הקמפיינים, הפריטים והדוחות של הישות. הם לא יכולים ליצור ולשנות משתמשים או לצפות בנתוני חיוב.
STANDARD_PLANNER המשתמש יכול לראות את כל הקמפיינים, נכסי הקריאייטיב, הזמנות הקמפיין, הפריטים והדוחות של הישות, כולל כל נתוני העלות. הם יכולים ליצור ולשנות תכונות שקשורות לתכנון, כולל תוכניות ומלאי שטחי פרסום.
STANDARD_PLANNER_LIMITED המשתמש יכול לראות את כל הקמפיינים, הקריאייטיבים, הזמנות הקמפיינים, הפריטים והדוחות של הישות. הם יכולים ליצור או לשנות תכונות שקשורות לתכנון, כולל תוכניות ומלאי שטחי פרסום. אין להם גישה לנתוני עלות, והם לא יכולים להתחיל, לקבל או לנהל משא ומתן על שיתופי פעולה.
STANDARD_PARTNER_CLIENT המשתמש יכול לנהל קמפיינים, נכסי קריאייטיב, הזמנות קמפיין, פריטים ודוחות עבור הישות. הם לא יכולים ליצור או לשנות משתמשים אחרים או להציג את נתוני החיוב. הם לא יכולים לראות מודלים של הכנסות, סימוני מחיר או שדות רגישים אחרים של המפיץ. אפשר להקצות את התפקיד הזה רק לישות של מפרסם.
READ_ONLY המשתמש יכול רק ליצור דוחות ולהציג נתונים של הישות.
REPORTING_ONLY המשתמש יכול רק ליצור ולנהל דוחות.
LIMITED_REPORTING_ONLY המשתמש יכול ליצור ולנהל רק את הדוחות הבאים ללא סיכון ללקוח: 'כללי', 'ביצועים לפי קהל', 'בקרב שותפים שונים', 'מילות מפתח', 'מזהה הזמנה', 'קטגוריה' ו'ספק נתונים של צד שלישי'.
CREATIVE המשתמש יכול לראות את המידע בתוכנית המדיה שנחוץ לו כדי לשתף פעולה, אבל לא יכול לראות נתונים שקשורים לעלויות או את Marketplace.
CREATIVE_ADMIN המשתמש יכול לראות את המידע בתוכנית המדיה שנחוץ לשיתוף פעולה, אבל לא יכול לראות נתונים שקשורים לעלויות או את Marketplace. בנוסף, הם יכולים להוסיף לישות אדמינים אחרים של נכסי קריאייטיב או משתמשים אחרים בנכסי קריאייטיב.

שיטות

bulkEditAssignedUserRoles

 עריכת כמות גדולה של תפקידי משתמש עבור משתמש.

create

 יצירת משתמש חדש.

delete

 מוחק משתמש.

get

 משיג משתמש.

list

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

patch

 עדכון של משתמש קיים.