REST Resource: users

משאב: משתמש

משתמש יחיד ברשת המדיה וידאו 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

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

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

שיטות

bulkEditAssignedUserRoles

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

create

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

delete

 מוחק משתמש.

get

 משיג משתמש.

list

 בתיבת הדו-שיח הזו מפורטים משתמשים שנגישים למשתמש הנוכחי.

patch

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