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

الطُرق

bulkEditAssignedUserRoles

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

create

 تنشئ هذه الطريقة مستخدمًا جديدًا.

delete

 يحذف هذا الإجراء مستخدمًا.

get

 تعرض هذه الطريقة معلومات عن مستخدم.

list

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

patch

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