REST Resource: users

منبع: کاربر

یک کاربر در Display & Video 360.

نمایندگی JSON 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
فیلدها
name

string

فقط خروجی نام منبع کاربر

user Id

string ( int64 format)

فقط خروجی شناسه منحصر به فرد کاربر توسط سیستم تعیین شده است.

email

string

مورد نیاز. تغییرناپذیر. آدرس ایمیلی که برای شناسایی کاربر استفاده می شود.

display Name

string

مورد نیاز. نام نمایشی کاربر

باید UTF-8 با حداکثر اندازه 240 بایت کدگذاری شود.

assigned User Roles[]

object ( AssignedUserRole )

نقش های کاربر اختصاص داده شده

مورد نیاز در users.create . خروجی فقط در users.patch . فقط از طریق users.bulkEditAssignedUserRoles قابل به روز رسانی است.

last Login Time

string ( Timestamp format)

فقط خروجی مهر زمانی آخرین باری که کاربر به DV360 UI وارد شده است.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "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.
}
فیلدها
assigned User Role Id

string

فقط خروجی شناسه نقش کاربر اختصاص داده شده.

user Role

enum ( UserRole )

مورد نیاز. نقش کاربر برای اختصاص دادن به یک کاربر برای موجودیت.

فیلد اتحادیه entity_id . مورد نیاز.

شناسه نهادی که نقش کاربر اختصاص داده شده برای آن اعمال می شود. entity_id فقط می تواند یکی از موارد زیر باشد:

partner Id

string ( int64 format)

شناسه شریکی که نقش کاربر اختصاص داده شده به آن اعمال می شود.

advertiser Id

string ( int64 format)

شناسه تبلیغ‌کننده‌ای که نقش کاربر اختصاصی برای آن اعمال می‌شود.

نقش کاربر

نقش های احتمالی کاربر

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 را مشاهده کند. علاوه بر این، آنها می توانند ادمین های خلاق یا کاربران خلاق دیگری را به موجودیت اضافه کنند.

روش ها

bulk Edit Assigned User Roles

 انبوه نقش های کاربر را برای یک کاربر ویرایش می کند.

create

 یک کاربر جدید ایجاد می کند.

delete

 یک کاربر را حذف می کند.

get

 کاربر می گیرد.

list

 کاربرانی را که برای کاربر فعلی قابل دسترسی هستند فهرست می کند.

patch

 یک کاربر موجود را به روز می کند.