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".

طابع زمني بتنسيق 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.
}
الحقول
assignedUserRoleId

string

النتائج فقط. رقم تعريف دور المستخدِم الذي تم إسناده.
userRole

enum (UserRole)

مطلوبة. دور المستخدم الذي سيتم منحه إلى مستخدم في الكيان.

حقل الاتحاد entity_id مطلوبة.

رقم تعريف الكيان الذي ينطبق عليه دور المستخدِم الذي تم إسناده. يمكن أن يكون الحقل "entity_id" واحدًا فقط مما يلي:
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

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