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-normalized وسيستخدم 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),

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

الطُرق

bulkEditAssignedUserRoles

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

create

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

delete

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

get

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

list

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

patch

 تعدّل هذه الطريقة مستخدمًا حاليًا.