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

الطُرق

bulkEditAssignedUserRoles

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

create

 إنشاء مستخدم جديد

delete

 حذف مستخدم.

get

 الحصول على مستخدم.

list

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

patch

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