REST Resource: users

משאב: User

משתמש יחיד ב-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

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