REST Resource: users

المورد: مستخدم

مستخدم واحد في "مساحة العرض والفيديو 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 وبحدّ أقصى 240 بايت.
assignedUserRoles[]

object (AssignedUserRole)

أدوار المستخدمين التي تم تعيينها

مطلوبة في users.create. يجب أن يكون الناتج باللغة users.patch فقط. لا يمكن تعديلها إلا من خلال users.bulkEditAssignedUserRoles.
lastLoginTime

string (Timestamp format)

للعرض فقط. الطابع الزمني لآخر مرة سجّل فيها المستخدم الدخول إلى واجهة مستخدم "مساحة العرض والفيديو 360"

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف 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 يمكن للمستخدم الاطّلاع على معلومات الخطة الإعلامية التي يحتاج إليها للتعاون، ولكن لا يمكنه الاطّلاع على البيانات المتعلّقة بالتكلفة أو "السوق". بالإضافة إلى ذلك، يمكنهم إضافة مشرفين أو مستخدمين مبدعين آخرين إلى الكيان.

الطُرق

bulkEditAssignedUserRoles

 تعديل أدوار المستخدمين بشكل مجمّع لمستخدم معيّن

create

 لإنشاء مستخدم جديد

delete

 تحذف هذه الطريقة مستخدمًا.

get

 للحصول على مستخدم

list

 تعرض هذه الطريقة قائمة بالمستخدمين الذين يمكن للمستخدم الحالي الوصول إليهم.

patch

 تعديل مستخدم حالي