Devices

للحصول على قائمة بالأساليب لهذا المرجع، يُرجى الاطّلاع على نهاية هذه الصفحة.

تمثيلات الموارد

يمثّل مورد "الأجهزة" جهازًا جوّالاً تديره خدمة إدارة الخدمات الجوّالة للمؤسسات (EMM) وينتمي إلى مستخدم معيّن في المؤسسة.

{
  "kind": "androidenterprise#device",
  "androidId": string,
  "managementType": string,
  "policy": {
    "autoUpdatePolicy": string,
    "productAvailabilityPolicy": string,
    "productPolicy": [
      {
        "productId": string,
        "tracks": [
          string
        ],
        "trackIds": [
          string
        ],
        "managedConfiguration": {
          "kind": string,
          "productId": string,
          "managedProperty": [
            {
              "key": string,
              "valueBool": boolean,
              "valueInteger": integer,
              "valueString": string,
              "valueStringArray": [
                string
              ],
              "valueBundle": {
                "managedProperty": [
                  (ManagedProperty)
                ]
              },
              "valueBundleArray": [
                {
                  "managedProperty": [
                    (ManagedProperty)
                  ]
                }
              ]
            }
          ],
          "configurationVariables": {
            "kind": "androidenterprise#configurationVariables",
            "mcmId": string,
            "variableSet": [
              {
                "kind": "androidenterprise#variableSet",
                "placeholder": string,
                "userValue": string
              }
            ]
          }
        },
        "autoInstallPolicy": {
          "autoInstallMode": string,
          "autoInstallPriority": integer,
          "autoInstallConstraint": [
            {
              "networkTypeConstraint": string,
              "chargingStateConstraint": string,
              "deviceIdleStateConstraint": string
            }
          ],
          "minimumVersionCode": integer
        },
        "autoUpdateMode": string,
        "enterpriseAuthenticationAppLinkConfigs": [
          {
            "uri": string
          }
        ]
      }
    ],
    "maintenanceWindow": {
      "startTimeAfterMidnightMs": long,
      "durationMs": long
    },
    "deviceReportPolicy": string,
    "policyId": string
  },
  "report": {
    "lastUpdatedTimestampMillis": long,
    "appState": [
      {
        "packageName": string,
        "keyedAppState": [
          {
            "key": string,
            "stateTimestampMillis": long,
            "severity": string,
            "message": string,
            "data": string
          }
        ]
      }
    ]
  },
  "latestBuildFingerprint": string,
  "sdkVersion": integer,
  "maker": string,
  "model": string,
  "device": string,
  "product": string,
  "retailBrand": string
}
اسم الموقع القيمة الوصف ملاحظات
androidId string معرّف Android لخدمة "خدمات Google Play" للجهاز، وهو مُشفَّر على شكل سلسلة سداسية عشرية بتنسيق أحرف أبجدية صغيرة. مثلاً: "123456789abcdef0"
device string الاسم الرمزي الداخلي للجهاز هذه الرسالة واردة من android.os.Build.DEVICE. (الحقل باسم "device" لكل السجلات/wireless/android/android_checkin.proto)
kind string
latestBuildFingerprint string الملف المرجعي للإصدار الخاص بالجهاز إذا كان معروفًا
maker string الشركة المصنّعة للجهاز. هذه الرسالة واردة من android.os.Build.MANUFACTURER.
managementType string تحدِّد هذه السياسة مدى التحكُّم في الجهاز من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM) في "Google Play للأعمال" في إعدادات النشر المختلفة.

تشمل القيم المحتملة ما يلي:
  • "managedDevice"، وهو جهاز تم تخصيص وحدة التحكّم بسياسة الجهاز (DPC) لإدارة الخدمات الجوّالة للمؤسسات (EMM) بصفته مالك الجهاز.
  • "managedProfile"، جهاز يتضمّن ملفًا شخصيًا تديره وحدة التحكّم بسياسة الجهاز (DPC هو مالك الملف الشخصي) بالإضافة إلى ملف شخصي منفصل لا تتوفّر لوحدة التحكّم بسياسة الجهاز (DPC).
  • "containerApp"، لم تعد مستخدمة (متوقّفة نهائيًا).
  • "unmanagedProfile"، وهو جهاز تم السماح له (من خلال مشرف النطاق باستخدام "وحدة تحكّم المشرف" لتفعيل الامتياز) باستخدام "Google Play للأعمال"، ولكن الملف الشخصي نفسه ليس ملكًا لوحدة التحكّم بسياسة الجهاز (DPC).


القيم المقبولة هي:
  • "containerApp"
  • "managedDevice"
  • "managedProfile"
  • "unmanagedProfile"
model string اسم طراز الجهاز هذه الرسالة واردة من android.os.Build.MODEL.
policy nested object يتم فرض السياسة على الجهاز.
policy.autoUpdatePolicy string تتحكّم هذه السياسة في الحالات التي يمكن فيها تطبيق التحديثات التلقائية للتطبيقات على الجهاز.

البديل المقترَح: autoUpdateMode الذي يتم ضبطه لكل تطبيق، يوفر مرونة أكبر في ما يتعلّق بمعدل تكرار التحديثات.

عند ضبط "autoUpdateMode" على "AUTO_UPDATE_POSTPONED" أو "AUTO_UPDATE_HIGH_PRIORITY"، لن يكون لـ "autoUpdatePolicy" أي تأثير.

"choiceToTheUser" يسمح لمستخدم الجهاز بضبط سياسة تحديث التطبيقات. يؤدي اختيار "دائمًا" إلى تفعيل التحديثات التلقائية. "أبدًا" لإيقاف التحديثات التلقائية. لا تفعِّل القيمة "wifiOnly" التحديثات التلقائية إلا عندما يكون الجهاز متصلاً بشبكة Wi-Fi.

في ما يلي القيم المقبولة:
  • "always"
  • "choiceToTheUser"
  • "never"
  • "wifiOnly"
policy.deviceReportPolicy string يمكنك اختيار ما إذا كان الجهاز سيرسل حالة التطبيق إلى إدارة الخدمات الجوّالة للمؤسسات (EMM). القيمة التلقائية هي "deviceReportDisabled".

في ما يلي القيم المقبولة:
  • "deviceReportDisabled"
  • "deviceReportEnabled"
policy.maintenanceWindow nested object نافذة الصيانة التي تحدّد وقت تحديث التطبيقات التي تعمل في المقدّمة
policy.maintenanceWindow.durationMs long مدة فترة الصيانة، بالمللي ثانية يجب أن تكون المدة بين 30 دقيقة و24 ساعة (ضمنًا).
policy.maintenanceWindow.startTimeAfterMidnightMs long وقت بدء فترة الصيانة، بالملي ثانية بعد منتصف الليل على الجهاز يمكن أن تمتد الفترات الزمنية إلى منتصف الليل.
policy.policyId string معرّف للسياسة التي سيتم تمريرها مع ملاحظات تثبيت التطبيق المُرسَلة من "متجر Play".
policy.productAvailabilityPolicy string مدى التوفّر الممنوح للجهاز للمنتجات المحدّدة. تمنح القيمة "all" الجهاز إذن الوصول إلى جميع المنتجات، بصرف النظر عن حالة الموافقة. "الكل" لا يؤدي إلى تفعيل الرؤية التلقائية لـ "alpha" أو "تجريبي" المسارات. "القائمة البيضاء" لمنح الجهاز إمكانية الوصول إلى المنتجات المحددة في productPolicy[]. يمكن فقط إضافة المنتجات التي تمت الموافقة عليها أو المنتجات التي تمت الموافقة عليها سابقًا من قِبل المؤسسة (المنتجات التي تم إبطال الموافقة عليها) إلى القائمة البيضاء. إذا لم يتم تقديم أي قيمة، يتم تلقائيًا تطبيق مدى التوفّر المحدّد على مستوى المستخدم.

في ما يلي القيم المقبولة:
  • "all"
  • "whitelist"
policy.productPolicy[] list قائمة سياسات المنتجات. يجب ضبط سمة productAvailabilityPolicy على WHITELIST أو ALL ليتم تطبيق سياسات المنتجات.
policy.productPolicy[].autoInstallPolicy nested object سياسة التثبيت التلقائي للمنتج.
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] list القيود المفروضة على التثبيت التلقائي للتطبيق. يمكنك تحديد قيد واحد كحد أقصى.

policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint string قيد حالة الشحن

في ما يلي القيم المقبولة:
  • "chargingNotRequired"
  • "chargingRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint string قيد حالة عدم النشاط للجهاز

في ما يلي القيم المقبولة:
  • "deviceIdleNotRequired"
  • "deviceIdleRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint string قيد نوع الشبكة

في ما يلي القيم المقبولة:
  • "anyNetwork"
  • "unmeteredNetwork"
policy.productPolicy[].autoInstallPolicy.autoInstallMode string وضع التثبيت التلقائي في حال عدم ضبط القيمة، يتم ضبطها تلقائيًا على doNotAutoInstall. يتم تثبيت أي تطبيق تلقائيًا بغض النظر عن نافذة الصيانة المحددة.

في ما يلي القيم المقبولة:
  • "autoInstallOnce"
  • "doNotAutoInstall"
  • "forceAutoInstall"
policy.productPolicy[].autoInstallPolicy.autoInstallPriority integer أولوية التثبيت، بالتنسيق عدد صحيح غير موقَّع كلما كان الرقم أقل، أعطى أولوية أعلى.
policy.productPolicy[].autoInstallPolicy.minimumVersionCode integer الحد الأدنى لإصدار التطبيق. إذا تم تثبيت إصدار أقدم من التطبيق، سيتم تحديثه تلقائيًا وفقًا لقيود التثبيت التلقائي، بدلاً من انتظار التحديث التلقائي العادي. يمكنك ضبط حد أدنى لرمز الإصدار لـ 20 تطبيقًا كحد أقصى لكل جهاز.
policy.productPolicy[].autoUpdateMode string وضع التحديث التلقائي للمنتج. عند استخدام سياسة autoUpdateMode، تكون الأولوية دائمًا على اختيار المستخدم. لذلك عندما يُجري المستخدم تغييرات على إعدادات الجهاز يدويًا، يتم تجاهل هذه التغييرات.

في ما يلي القيم المقبولة:
  • "autoUpdateDefault"
  • "autoUpdateHighPriority"
  • "autoUpdatePostponed"
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] list إعداد عنوان URL للمصادقة في تطبيق المصادقة الخاص بموفِّر هوية يساعد ذلك في تشغيل تطبيق المصادقة لموفّر الهوية أثناء المصادقة التي تتم في تطبيق خاص باستخدام WebView لنظام التشغيل Android. يجب أن يكون تطبيق المصادقة المعالِج التلقائي لعنوان URL للمصادقة على الجهاز.
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri string عنوان URL للمصادقة.
policy.productPolicy[].managedConfiguration nested object الإعداد المُدار للمنتج.
policy.productPolicy[].managedConfiguration.configurationVariables nested object يحتوي على رقم تعريف الملف الشخصي للإعدادات المُدارة ومجموعة متغيّرات الضبط (إن وُجدت) المحدّدة للمستخدم.
policy.productPolicy[].managedConfiguration.configurationVariables.kind string
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId string رقم تعريف إعدادات الضبط المُدار
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] list يشير ذلك المصطلح إلى مجموعة المتغيّر المنسوبة إلى المستخدم.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind string
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder string سلسلة العنصر النائب التي تحدّدها إدارة الخدمات الجوّالة للمؤسسات
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue string قيمة العنصر النائب الخاصة بالمستخدم.
policy.productPolicy[].managedConfiguration.kind string تمّت إزالة هذا العمود.

policy.productPolicy[].managedConfiguration.managedProperty[] list مجموعة الخصائص المُدارة لهذه الإعدادات.
policy.productPolicy[].managedConfiguration.managedProperty[].key string تمثّل هذه السمة المفتاح الفريد الذي يعرّف الموقع.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool boolean القيمة المنطقية: لن تظهر هذه القيمة إلا إذا كان نوع السمة هو bool.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle nested object حزمة المواقع المُدارة: لن تتوفّر هذه الحزمة إلا إذا كان نوع الموقع حزمة.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] list قائمة المواقع المُدارة
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] list قائمة حِزم المواقع الإلكترونية: لن تتوفّر هذه القائمة إلا إذا كان نوع السمة هو package_array.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] list قائمة المواقع المُدارة.
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger integer قيمة العدد الصحيح - لن تكون موجودة إلا إذا كان نوع الخاصية عددًا صحيحًا.
policy.productPolicy[].managedConfiguration.managedProperty[].valueString string قيمة السلسلة: لن تظهر هذه القيمة إلا إذا كان نوع السمة سلسلة أو خيار أو مخفيًا.
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] list قائمة قيم السلسلة - لن تكون موجودة إلا إذا كان نوع الخاصية محددًا.
policy.productPolicy[].managedConfiguration.productId string رقم تعريف المنتج الذي تخصّه الإعدادات المُدارة، مثلاً "app:com.google.android.gm".
policy.productPolicy[].productId string معرّف المنتج. مثلاً: "app:com.google.android.gm"
policy.productPolicy[].trackIds[] list يمنح هذا الجهاز إذن الوصول إلى قنوات الإصدار المحدود للمنتجات المحدّدة من خلال trackIds. يمكن الحصول على قائمة مسارات الإصدار لمنتج معيّن من خلال استدعاء Products.Get.
policy.productPolicy[].tracks[] list تمّ الإيقاف. استخدِم trackIds بدلاً من ذلك.
product string اسم المنتج للجهاز. مصدر هذه المعلومات هو android.os.Build.PRODUCT.
report nested object تم تعديل تقرير الجهاز لتضمين أحدث حالات التطبيقات.
report.appState[] list قائمة بحالات التطبيق التي تحدّدها التطبيقات المُدارة على الجهاز يحدِّد مطوّرو التطبيقات حالات التطبيق. سيكون هذا الحقل متوفّرًا دائمًا.
report.appState[].keyedAppState[] list قائمة بحالات التطبيق الأساسية سيكون هذا الحقل متوفّرًا دائمًا.
report.appState[].keyedAppState[].data string حقل إضافي مخصّص للبيانات التي يمكن للآلة قراءتها. على سبيل المثال، رقم أو عنصر JSON. لمنع هجمات XSS، ننصحك بإزالة أي علامات HTML من البيانات قبل عرضها.
report.appState[].keyedAppState[].key string مفتاح يشير إلى ما يوفّره التطبيق ويحدِّد مطوِّر التطبيق محتوى المفتاح. لمنع استخدام أداة XSS، ننصح بإزالة أي رمز HTML من المفتاح قبل عرضه. سيكون هذا الحقل متوفّرًا دائمًا.
report.appState[].keyedAppState[].message string رسالة بتنسيق حر يمكن لشخص عادي قراءتها وتصف حالة التطبيق رسالة خطأ مثلاً. لمنع هجمات XSS، ننصحك بإزالة أي رمز HTML من الرسالة قبل عرضها.
report.appState[].keyedAppState[].severity string خطورة حالة التطبيق سيظهر هذا الحقل دائمًا.

في ما يلي القيم المقبولة:
  • "severityError"
  • "severityInfo"
report.appState[].keyedAppState[].stateTimestampMillis long الطابع الزمني للوقت الذي يضبط فيه التطبيق الحالة بالمللي ثانية منذ تاريخ بدء حساب الفترة سيكون هذا الحقل متوفّرًا دائمًا.
report.appState[].packageName string اسم حزمة التطبيق. سيظهر هذا الحقل دائمًا.
report.lastUpdatedTimestampMillis long الطابع الزمني لآخر تعديل بالتقرير بالمللي ثانية منذ تاريخ بدء حساب الفترة سيكون هذا الحقل متوفّرًا دائمًا.
retailBrand string العلامة التجارية للبيع بالتجزئة للجهاز، في حال ضبطها. الاطّلاع على android.os.Build.BRAND
sdkVersion integer إصدار التوافق مع واجهة برمجة التطبيقات

الطُرق

forceReportUpload
يتم تحميل تقرير يحتوي على أي تغييرات في حالات التطبيق على الجهاز منذ تم إنشاء آخر تقرير. يمكنك استدعاء هذه الطريقة بما يصل إلى 3 مرات كل 24 ساعة على جهاز معيّن.
الحصول
استرداد تفاصيل جهاز.
getState
يسترد ما إذا تم تفعيل إمكانية وصول الجهاز إلى خدمات Google أو غير مفعّل. لا تسري حالة الجهاز إلا في حال فرض سياسات إدارة الخدمات الجوّالة للمؤسسات (EMM) على نظام التشغيل Android. الأجهزة في وحدة تحكُّم المشرف في Google. وبخلاف ذلك، يتم تجاهل حالة الجهاز والسماح لجميع الأجهزة بالوصول إلى البيانات. بخدمات Google. لا تتوفّر هذه الميزة إلا للمستخدمين الذين تديرها Google.
list
استرداد أرقام تعريف جميع أجهزة المستخدم
setState
يضبط ما إذا كان سيتم تفعيل إمكانية وصول الجهاز إلى خدمات Google أو إيقافها. لا تسري حالة الجهاز إلا إذا كان فرض سياسات إدارة الخدمات الجوّالة للمؤسسات (EMM) على أجهزة Android مفعَّلاً في "وحدة تحكّم المشرف في Google". بخلاف ذلك، يتم تجاهل حالة الجهاز ويُسمح لجميع الأجهزة بالوصول إلى خدمات Google. ولا تتوفّر هذه الميزة إلا للمستخدمين الخاضعين لإدارة Google.
تعديل
تعديل سياسة الجهاز

لضمان فرض السياسة بشكل صحيح، عليك منع الحسابات غير المُدارة من الوصول إلى Google Play من خلال ضبط القيمة allowed_accounts في الإعدادات المُدارة لحزمة Google Play. راجِع مقالة فرض قيود على الحسابات في Google Play.