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.

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

Methods

bulkEditAssignedUserRoles

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

create

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

delete

 מחיקה של משתמש.

get

 אחזור משתמש.

list

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

patch

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