REST Resource: customers.configurations

المورد: الإعدادات

تجمع الإعدادات خيارات إدارة الحسابات لأجهزة Android. ويضم كل إعداد مما يلي:

  • وحدة التحكم في سياسات الأجهزة لإدارة الخدمات الجوّالة للمؤسسات المثبَّتة على الأجهزة
  • سياسات إدارة الخدمات الجوّالة للمؤسسات (EMM) المفروضة على الأجهزة.
  • البيانات الوصفية المعروضة على الجهاز لمساعدة المستخدمين أثناء الإعداد

يمكن للعملاء إضافة العديد من الإعدادات. إلا أن برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" يعمل بشكل أفضل عندما يحدّد العميل إعدادًا تلقائيًا مطبّقًا على أي أجهزة جديدة تشتريها المؤسسة.

تمثيل JSON 
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
الحقول
name

string

الإخراج فقط. اسم مورد واجهة برمجة التطبيقات بالتنسيق customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] تم تحديده من خلال الخادم.
configurationId

string (int64 format)

الإخراج فقط. رقم تعريف الإعداد. تم تحديده من خلال الخادم.
configurationName

string

مطلوبة. هو اسم مختصر يصف غرض الإعدادات. على سبيل المثال فريق المبيعات أو الموظفون المؤقتون. تعرض بوابة برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" هذا الاسم لمشرفي تكنولوجيا المعلومات.
dpcResourcePath

string

مطلوبة. اسم المورد لوحدة التحكّم بسياسة الجهاز (DPC) المحددة بالتنسيق customers/[CUSTOMER_ID]/dpcs/*. لإدراج وحدات التحكّم بسياسة الجهاز المتوافقة، عليك الاتصال بـ customers.dpcs.list.
dpcExtras

string

إضافات إدارة الخدمات الجوّالة للمؤسسات (EMM) بتنسيق JSON التي يتم تمريرها إلى وحدة التحكّم بسياسة الجهاز.
companyName

string

مطلوبة. اسم المؤسسة يعرض برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" اسم المؤسسة هذا لمستخدمي الأجهزة أثناء إدارة الأجهزة.
contactEmail

string

مطلوبة. عنوان البريد الإلكتروني الذي يمكن لمستخدمي الأجهزة التواصل من خلاله مع الفريق المناسب لطلب المساعدة. ويعرض برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" هذا العنوان لمستخدمي الأجهزة قبل إدارة الأجهزة. يتم التحقق من القيمة عند الإدخال.
contactPhone

string

مطلوبة. رقم الهاتف الذي يمكن لمستخدمي الأجهزة الاتصال به، من جهاز آخر، لطلب المساعدة. ويعرض برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" هذا الرقم لمستخدمي الأجهزة قبل إدارة الأجهزة. تقبل الأرقام والمسافات وعلامة الجمع والواصلة والأقواس.
customMessage

string

رسالة تحتوي على جملة أو جملتين لمساعدة مستخدمي الجهاز في الحصول على المساعدة أو منحهم المزيد من التفاصيل حول ما يجري على أجهزتهم. ويعرض برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" هذه الرسالة لمستخدمي الأجهزة قبل إدارة الأجهزة.
isDefault

boolean

مطلوبة. تحديد ما إذا كانت هذه هي الإعدادات التلقائية التي يتم تطبيقها في برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" على الأجهزة التي تشتريها المؤسسة في المستقبل يمكن أن يكون إعداد عميل واحد فقط هو الإعداد التلقائي. يؤدي ضبط هذه القيمة على true إلى تغيير قيمة isDefault للإعداد التلقائي السابق إلى false.
forcedResetTime

string (Duration format)

اختياريّ. المهلة التي تسبق فرض إعادة ضبط الجهاز على الإعدادات الأصلية في حال لم يعمل الجهاز خلال معالج الإعداد، وعادةً ما يكون ذلك بسبب عدم الاتصال بالشبكة أثناء معالج الإعداد. تتراوح النسبة المئوية من 0 إلى 6 ساعات، حيث يتم تحديد ساعتَين تلقائيًا في حال عدم ضبطهما.

مدة بالثواني بعدد يصل إلى تسعة أرقام كسور، تنتهي بالأرقام "s". مثال: "3.5s".

الطُرق

create

 إنشاء إعداد جديد

delete

 حذف الإعدادات غير المستخدَمة

get

 الحصول على تفاصيل الإعداد

list

 يعرض إعدادات العميل.

patch

 يتم تعديل قيم حقول الإعدادات.