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),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "partnerId": string,
  "advertiserId": string
  // End of mutually exclusive fields.
}
שדות
assignedUserRoleId

string

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

enum (UserRole)

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

חובה.

המזהה של הישות שתפקיד המשתמש שהוקצה חל עליה. זו רשימה של שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
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

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