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

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