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

שיטות

bulkEditAssignedUserRoles

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

create

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

delete

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

get

 משיג משתמש.

list

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

patch

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