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 کدبندی شده باشد و حداکثر اندازه آن ۲۴۰ بایت باشد.
assignedUserRoles[]

object (AssignedUserRole)

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

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

string (Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولیدشده همیشه Z-نرمال‌شده است و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «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

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

شمارشی‌ها
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

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