REST Resource: users

المورد: المستخدِم

مستخدم واحد في الشبكة الإعلانية فيديو 360.

تمثيل JSON 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ]
}
الحقول
name

string

النتائج فقط. اسم المورد للمستخدم.
userId

string (int64 format)

النتائج فقط. المعرّف الفريد للمستخدِم. يحدده النظام.
email

string

مطلوب. غير قابل للتغيير. عنوان البريد الإلكتروني المستخدَم لتحديد هوية المستخدم.
displayName

string

مطلوب. الاسم المعروض للمستخدم.

يجب أن يكون بترميز UTF-8 بحيث لا يزيد حجمه عن 240 بايت.
assignedUserRoles[]

object (AssignedUserRole)

أدوار المستخدِمِين التي تم إسنادها.

مطلوب في users.create. النتائج فقط في users.patch. لا يمكن التعديل إلا من خلال users.bulkEditAssignedUserRoles.

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

الطُرق

bulkEditAssignedUserRoles

 يتم إجراء تعديلات مجمّعة لأدوار المستخدمين لأحد المستخدمين.

create

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

delete

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

get

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

list

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

patch

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