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

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