REST Resource: users

משאב: משתמש

משתמש יחיד ב-Display & Video 360.

ייצוג JSON 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ]
}
שדות
name

string

פלט בלבד. שם המשאב של המשתמש.
userId

string (int64 format)

פלט בלבד. המזהה הייחודי של המשתמש. הוקצה על ידי המערכת.
email

string

חובה. לא משתנה. כתובת האימייל ששימשה לזיהוי המשתמש.
displayName

string

חובה. השם המוצג של המשתמש.

חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים.
assignedUserRoles[]

object (AssignedUserRole)

תפקידי המשתמש שהוקצו.

חובה בusers.create. פלט רק ב-users.patch. ניתן לעדכן רק דרך users.bulkEditAssignedUserRoles.

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

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