ملاحظة مهمة: لم نعد نقبل عمليات التسجيل الجديدة لواجهة برمجة تطبيقات Play لخدمة إدارة الأجهزة الجوّالة للمؤسسات (EMM). مزيد من المعلومات

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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`	مدى التوفّر الممنوح للجهاز للمنتجات المحدّدة. يمنح الخيار "الكل" الجهاز إذن الوصول إلى جميع المنتجات، بغض النظر عن حالة الموافقة. لا يؤدي الخيار "الكل" إلى تفعيل الرؤية التلقائية للمسارات "ألفا" أو "إصدار تجريبي". تمنح "القائمة المسموح بها" الجهاز إذن الوصول إلى المنتجات المحدّدة في 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 للمصادقة لتطبيق المصادقة الخاص بموفِّر الهوية يساعد ذلك في تشغيل تطبيق المصادقة لموفِّر الهوية أثناء إجراء عملية المصادقة في تطبيق خاص باستخدام Android WebView. يجب أن يكون تطبيق المصادقة المعالِج التلقائي لعنوان 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`	سلسلة العنصر النائب التي يتم تحديدها بواسطة إدارة الخدمات الجوّالة للمؤسسات (EMM).
`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.