نظرة عامة

تحكم إمكانية وصول المستخدم العمليات التي يمكن للأفراد تنفيذها ضمن منتج "مساحة العرض والفيديو 360". يتم تحديد المستخدمين من خلال حساب Google الذي يتم استخدامه أثناء المصادقة. يتم تحديد مدى وصول المستخدم حسب الأدوار التي تم إسنادها إليه، والتي تكون مرتبطة بمراجع Partner أو Advertiser على "مساحة العرض والفيديو 360 ".

يوضِّح هذا الدليل كيفية العثور على المستخدِمين وإنشائهم، بالإضافة إلى تخصيص أدوار لهم من خلال واجهة برمجة التطبيقات "مساحة العرض والفيديو 360".

المتطلبات الأساسية

قبل البدء باستخدام خدمات مستخدمي "مساحة العرض والفيديو 360 API"، عليك إكمال الخطوات التالية: تواصل مع مستخدم مشرف حالي في فريقك لتفعيل أدوار المستخدمين اللازمة في "مساحة العرض والفيديو 360"، إذا لزم الأمر:

1. أنشئ مشروع واجهة برمجة التطبيقات ووافق عليه على النحو الموضَّح في دليل البدء.

2. تأكد من اتباع تدفق حساب الخدمة للتفويض. يمكن لحسابات الخدمة فقط الوصول إلى خدمة "مساحة العرض والفيديو 360 API" users. يجب أيضًا استخدام نطاق OAuth الخاص بخدمة users في عملية المصادقة.

3. تأكَّد من أن حساب الخدمة هو مستخدم في "مساحة العرض والفيديو 360"، ويشتمل على أدوار المستخدم المطلوبة للموارد الضرورية. لا يسمح لك سوى دور المشرف بإجراء تغييرات على مستخدم وأدوار المستخدمين التي تم إسنادها إليه. يمنحك أي دور عادي آخر فقط إذن الوصول للقراءة إلى موارد المستخدم.

فهم أدوار المستخدمين

تُحدِّد أدوار المستخدِمِين مستوى الوصول الذي يتمتع به المستخدِمون إلى موارد عرض الإعلانات المختلفة على "مساحة العرض والفيديو 360". تتضمن الأشياء المهمة التي يجب معرفتها حول أدوار المستخدمين ما يلي:

• يمكن منح دور المستخدِم لنوعَين مختلفَين من الموارد: Advertiser وPartner.

• ولا يمكن تعيين بعض أدوار المستخدمين إلا لنوع مورد محدّد.

• يمنح دور المستخدم الذي تم إسناده لشريك مستوى الوصول هذا تلقائيًا إلى جميع المعلنين ضمن هذا الشريك.

تتحكّم أدوار المستخدِمِين أيضًا في المستخدِمين الآخرين الذين يمكنك الوصول إليهم، وما إذا كان بإمكانك إنشاء مستخدِمين أو تعديل الأدوار التي تمّ إسنادها إلى الآخرين. بصفتك مستخدمًا، يمكنك فقط الاطّلاع على المستخدمين الذين يشاركون الوصول إلى المورد نفسه. على سبيل المثال، إذا كان لديك إذن وصول عادي إلى مورد شريك، سيتم تضمين جميع المستخدمين الذين لديهم إمكانية الوصول إلى هذا الشريك أو أي من المعلنين بموجبه في استجابة طريقة users.list.