Products: getAppRestrictionsSchema

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

الطلب

طلب HTTP

GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/products/productId/appRestrictionsSchema

المعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
enterpriseId string رقم تعريف المؤسسة.
productId string معرّف المنتج.
مَعلمات طلب البحث الاختيارية
language string علامة BCP47 للغة المفضّلة لدى المستخدم (مثل "en-US" أو "de").

التفويض

يتطلب هذا الطلب تفويضًا بالنطاق التالي:

النطاق
https://www.googleapis.com/auth/androidenterprise

لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.

نص الطلب

لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.

الإجابة

في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:

{
  "kind": string,
  "restrictions": [
    {
      "key": string,
      "title": string,
      "restrictionType": string,
      "description": string,
      "entry": [
        string
      ],
      "entryValue": [
        string
      ],
      "defaultValue": {
        "type": string,
        "valueBool": boolean,
        "valueString": string,
        "valueInteger": integer,
        "valueMultiselect": [
          string
        ]
      },
      "nestedRestriction": [
        (AppRestrictionsSchemaRestriction)
      ]
    }
  ]
}
اسم الموقع القيمة الوصف Notes
restrictions[] list مجموعة القيود التي يتألف منها هذا المخطط.
restrictions[].key string تمثّل هذه السمة المفتاح الفريد الذي يستخدمه المنتج لتحديد القيود، مثلاً "com.google.android.gm.fieldname".
restrictions[].title string اسم الحظر
restrictions[].restrictionType string نوع الحظر.

في ما يلي القيم المقبولة:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
restrictions[].description string وصف أطول للقيد، مع تقديم مزيد من التفاصيل حول ما يؤثر فيه.
restrictions[].entry[] list بالنسبة إلى القيود choice أو multiselect، قائمة بأسماء الإدخالات المحتملة التي يمكن لشخص عادي قراءتها.
restrictions[].entryValue[] list بالنسبة إلى القيود choice أو multiselect، تمثّل هذه السمة قائمة القيم التي يستطيع الجهاز قراءتها للإدخالات المحتملة. يجب استخدام هذه القيم في الإعدادات، إما كقيمة string واحدة لقيد choice أو في stringArray لقيد multiselect.
restrictions[].defaultValue nested object القيمة التلقائية للقيد. لا يتم تحديد قيمة تلقائية لقيود bundle وbundleArray أبدًا.
restrictions[].defaultValue.type string نوع القيمة المقدَّمة.

في ما يلي القيم المقبولة:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
restrictions[].defaultValue.valueBool boolean القيمة المنطقية - لن تكون موجودة إلا إذا كان النوع منطقيًا.
restrictions[].defaultValue.valueString string قيمة السلسلة - ستكون موجودة لأنواع السلسلة، والاختيار، والمخفي.
restrictions[].defaultValue.valueInteger integer قيمة العدد الصحيح - لن تكون موجودة إلا إذا كان النوع عددًا صحيحًا.
restrictions[].defaultValue.valueMultiselect[] list قائمة قيم السلسلة - لن تتوفر إلا إذا كان النوع محددًا.
restrictions[].nestedRestriction[] list بالنسبة إلى القيود bundle أو bundleArray، تمثّل هذه السمة قائمة القيود المتداخلة. يتم دائمًا دمج قيد bundle ضمن قيد bundleArray، بينما يكون القيد bundleArray أكثر عمقًا على مستويَين.
kind string تم إيقاف العمل بها.