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" وفقًا لـ logs/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) (وحدة التحكّم بسياسة الجهاز هي مالك الملف الشخصي) بالإضافة إلى ملف شخصي منفصل غير متاح لوحدة التحكّم بسياسة الجهاز.
  • "containerApp"، لم يعُد قيد الاستخدام (تم إيقافه نهائيًا)
  • "unmanagedProfile"، وهو جهاز تم السماح له (من قِبل مشرف النطاق باستخدام "وحدة تحكُّم المشرف" لتفعيل الامتياز) باستخدام Google Play المُدار، ولكن الملف الشخصي نفسه ليس مملوكًا لشركة إدارة الخدمات.


القيم المقبولة هي:
  • "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 لمستخدم الجهاز بضبط سياسة تحديث التطبيقات.
  • always تفعِّل التحديثات التلقائية.
  • never يوقف التحديثات التلقائية.
  • 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" الجهاز إذن الوصول إلى جميع المنتجات، بصرف النظر عن حالة الموافقة. لا يؤدي الخيار "الكل" إلى تفعيل مستوى الرؤية التلقائي للقنوات الاختبارية أو القنوات التجريبية. تمنح "القائمة المسموح بها" الجهاز إذن الوصول إلى المنتجات المحدّدة في 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 قائمة حِزم المواقع: لن تظهر هذه السمة إلا إذا كان نوع الموقع هو bundle_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.