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.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

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

טיפוסים בני מנייה (enums)
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

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