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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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 يمكن للمستخدم عرض معلومات الخطة الإعلامية التي يحتاج إليها للتعاون، ولكن لا يمكنه عرض البيانات المتعلقة بالتكلفة أو السوق. وبالإضافة إلى ذلك، يمكنهم إضافة مشرفي تصميم إعلان آخرين أو مستخدمي تصميم إعلان آخرين إلى الكيان.

الطُرق

bulkEditAssignedUserRoles

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

create

 ينشئ مستخدمًا جديدًا.

delete

 لحذف مستخدم

get

 يحصل على مستخدم.

list

 يسرد المستخدمين الذين يمكن للمستخدم الحالي الوصول إليه.

patch

 تُستخدَم لتعديل مستخدم حالي.