REST Resource: users

משאב: משתמש

משתמש יחיד ב-Display & Video 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.

הפונקציה משתמשת ב-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".

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. בנוסף, הם יכולים להוסיף לישות אדמינים או משתמשים אחרים של קריאייטיב.

Methods

bulkEditAssignedUserRoles

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

create

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

delete

 מחיקת משתמש.

get

 קבלת משתמש.

list

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

patch

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