REST Resource: users

منبع: کاربر

یک کاربر واحد در نمایش و ویدیوی ۳۶۰ درجه.

نمایش 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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

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

یک نقش کاربری واحد که تعامل مجاز کاربر با یک شریک یا تبلیغ‌کننده مشخص را تعریف می‌کند.

نمایش 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)

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

پایان میدان‌های ناسازگار.

نقش کاربری

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

انوم‌ها
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

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