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

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

Products

للحصول على قائمة بالطرق لهذا المورد، اطّلِع على نهاية هذه الصفحة.

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

يمثل مورد المنتجات تطبيقًا في متجر Google Play متاح لبعض المستخدمين على الأقل في المؤسسة. (تقتصر بعض التطبيقات على مؤسسة واحدة، ولا تتوفر معلومات عنها خارج هذه المؤسسة).

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

{
  "kind": "androidenterprise#product",
  "productId": string,
  "title": string,
  "authorName": string,
  "iconUrl": string,
  "smallIconUrl": string,
  "detailsUrl": string,
  "workDetailsUrl": string,
  "requiresContainerApp": boolean,
  "appVersion": [
    {
      "versionString": string,
      "versionCode": integer,
      "track": string,
      "targetSdkVersion": integer,
      "trackId": [
        string
      ],
      "isProduction": boolean
    }
  ],
  "distributionChannel": string,
  "productPricing": string,
  "signingCertificate": {
    "certificateHashSha256": string,
    "certificateHashSha1": string
  },
  "availableTracks": [
    string
  ],
  "appTracks": [
    {
      "trackId": string,
      "trackAlias": string
    }
  ],
  "description": string,
  "fullDescription": string,
  "screenshotUrls": [
    string
  ],
  "category": string,
  "recentChanges": string,
  "minAndroidSdkVersion": integer,
  "contentRating": string,
  "lastUpdatedTimestampMillis": long,
  "permissions": [
    {
      "permissionId": string,
      "state": string
    }
  ],
  "availableCountries": [
    string
  ],
  "features": [
    string
  ],
  "iarcGenericRating": string,
  "appRestrictionsSchema": {
    "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)
        ]
      }
    ]
  }
}

اسم الموقع	القيمة	الوصف
`appRestrictionsSchema`	`nested object`	مخطط قيود التطبيق
`appRestrictionsSchema.kind`	`string`	متوقّف نهائيًا.
`appRestrictionsSchema.restrictions[]`	`list`	مجموعة القيود التي يتألف منها هذا المخطط.
`appRestrictionsSchema.restrictions[].defaultValue`	`nested object`	تمثّل هذه السمة القيمة التلقائية للقيود. لا تحتوي قيود `bundle` و`bundleArray` على قيمة تلقائية مطلقًا.
`appRestrictionsSchema.restrictions[].defaultValue.type`	`string`	تمثّل هذه السمة نوع القيمة المقدَّمة. القيم المقبولة هي: "`bool`" "`bundle`" "`bundleArray`" "`choice`" "`hidden`" "`integer`" "`multiselect`" "`string`"
`appRestrictionsSchema.restrictions[].defaultValue.valueBool`	`boolean`	القيمة المنطقية - لن تكون موجودة إلا إذا كان النوع منطقيًا.
`appRestrictionsSchema.restrictions[].defaultValue.valueInteger`	`integer`	قيمة العدد الصحيح - لن تظهر هذه القيمة إلا إذا كان النوع عددًا صحيحًا.
`appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[]`	`list`	قائمة قيم السلسلة - لن تكون موجودة إلا إذا كان النوع عبارة عن تحديد متعدد.
`appRestrictionsSchema.restrictions[].defaultValue.valueString`	`string`	قيمة السلسلة - ستكون موجودة لأنواع السلسلة والاختيار والإخفاء.
`appRestrictionsSchema.restrictions[].description`	`string`	وصف مطوّل للقيود مع تقديم مزيد من التفاصيل حول تأثيره.
`appRestrictionsSchema.restrictions[].entryValue[]`	`list`	بالنسبة إلى القيود المفروضة على `choice` أو `multiselect`، تمثّل هذه السمة قائمة القيم التي يستطيع الجهاز قراءتها للإدخالات المحتملة. يجب استخدام هذه القيم في الإعدادات، إما كقيمة `string` فردية للقيد `choice` أو في `stringArray` للقيد `multiselect`.
`appRestrictionsSchema.restrictions[].entry[]`	`list`	بالنسبة إلى القيود المفروضة على `choice` أو `multiselect`، تمثّل هذه السمة قائمة الأسماء التي يمكن للمستخدمين قراءتها.
`appRestrictionsSchema.restrictions[].key`	`string`	المفتاح الفريد الذي يستخدمه المنتج لتحديد القيود، مثلاً "com.google.android.gm.fieldname".
`appRestrictionsSchema.restrictions[].nestedRestriction[]`	`list`	بالنسبة إلى قيود `bundle` أو `bundleArray`، تمثّل هذه السمة قائمة القيود المدمَجة. يكون القيد `bundle` مدمجًا دائمًا ضمن القيد `bundleArray`، بينما يصل عمق القيد `bundleArray` إلى مستويين كحد أقصى.
`appRestrictionsSchema.restrictions[].restrictionType`	`string`	تمثّل هذه السمة نوع القيد. القيم المقبولة هي: "`bool`" "`bundle`" "`bundleArray`" "`choice`" "`hidden`" "`integer`" "`multiselect`" "`string`"
`appRestrictionsSchema.restrictions[].title`	`string`	اسم القيد.
`appTracks[]`	`list`	المسارات المرئية للمؤسسة.
`appTracks[].trackAlias`	`string`	اسم قابل للتعديل لمقطع صوتي. هذا هو الاسم المرئي في Play Console.
`appTracks[].trackId`	`string`	معرّف قناة الإصدار الفريد غير قابل للتعديل. هذا المعرّف هو releaseTrackId في عنوان URL لصفحة Play Developer Console التي تعرض معلومات المقطع الصوتي.
`appVersion[]`	`list`	إصدارات التطبيق المتوفّرة حاليًا لهذا المنتج.
`appVersion[].isProduction`	`boolean`	صحيح إذا كان هذا الإصدار من APK للإنتاج.
`appVersion[].targetSdkVersion`	`integer`	إصدار حزمة تطوير البرامج (SDK) الذي يستهدفه هذا التطبيق، كما هو محدَّد في بيان ملف APK. راجع http://developer.android.com/guide/topics/manifest/uses-sdk-element.html
`appVersion[].track`	`string`	تم إيقاف العمل بها، ويمكنك استخدام `trackId` بدلاً منها. القيم المقبولة هي: "`alpha`" "`beta`" "`production`"
`appVersion[].trackId[]`	`list`	أرقام تعريف التتبّع التي تم نشر إصدار التطبيق فيها يستبدل حقل `track` (متوقف)، ولكنه لا يتضمّن قناة الإصدار (يمكنك الاطّلاع على `isProduction` بدلاً من ذلك).
`appVersion[].versionCode`	`integer`	معرّف زيادة فريد لإصدار التطبيق
`appVersion[].versionString`	`string`	السلسلة التي استخدمها مطوِّر التطبيق في "متجر Play" لتحديد الإصدار. السلسلة ليست بالضرورة فريدة أو مترجمة (على سبيل المثال، قد تكون السلسلة "1.4").
`authorName`	`string`	اسم مؤلِّف المنتج (على سبيل المثال، مطوّر التطبيق).
`availableCountries[]`	`list`	البلدان التي يتوفّر فيها هذا التطبيق:
`availableTracks[]`	`list`	تم إيقاف العمل بها، ويمكنك استخدام `appTracks` بدلاً منها.
`category`	`string`	فئة التطبيق (مثل RACING أو SOCIAL أو غير ذلك)
`contentRating`	`string`	تقييم المحتوى لهذا التطبيق. القيم المقبولة هي: "`all`" "`mature`" "`preTeen`" "`teen`"
`description`	`string`	الوصف الترويجي المترجَم، في حال توفّره.
`detailsUrl`	`string`	رابط إلى صفحة تفاصيل المنتج على Google Play (للمستهلك)
`distributionChannel`	`string`	طريقة توفير الطرد ولمن يتم توفيره تعني القيمة `publicGoogleHosted` أن الحزمة متاحة من خلال "متجر Play" وغير مقيّدة بمؤسسة معيّنة. وتعني القيمة `privateGoogleHosted` أن الحزمة عبارة عن تطبيق خاص (يقتصر على مؤسسة) ولكن تستضيفه Google. وتعني القيمة `privateSelfHosted` أن الحزمة عبارة عن تطبيق خاص (يقتصر على مؤسسة) ويتم استضافته بشكل خاص. القيم المقبولة هي: "`privateGoogleHosted`" "`privateSelfHosted`" "`publicGoogleHosted`"
`features[]`	`list`	ميزات ملحوظة (إن توفّرت) لهذا المنتج.
`fullDescription`	`string`	الوصف الكامل المترجَم إلى متجر التطبيقات، في حال توفّره
`iarcGenericRating`	`string`	تقييم المحتوى لهذا التطبيق. القيم المقبولة هي: "`eighteenYears`" "`iarcGenericRatingUnspecified`" "`sevenYears`" "`sixteenYears`" "`threeYears`" "`twelveYears`"
`iconUrl`	`string`	تمثّل هذه السمة رابطًا إلى صورة يمكن استخدامها كرمز للمنتج. هذه الصورة مناسبة للاستخدام حتى 512 بكسل × 512 بكسل.
`kind`	`string`
`lastUpdatedTimestampMillis`	`long`	الوقت التقريبي (خلال 7 أيام) الذي تم فيه نشر التطبيق لآخر مرة، ويتم التعبير عنه بالمللي ثانية منذ البداية.
`minAndroidSdkVersion`	`integer`	الحد الأدنى من حزمة تطوير البرامج (SDK) لنظام التشغيل Android واللازم لتشغيل التطبيق.
`permissions[]`	`list`	قائمة بالأذونات التي يطلبها التطبيق.
`permissions[].permissionId`	`string`	سلسلة مبهمة تعرِّف الإذن بشكل فريد.
`permissions[].state`	`string`	ما إذا تم قبول الإذن أم لا. القيم المقبولة هي: "`accepted`" "`required`"
`productId`	`string`	سلسلة بالتنسيق `app:<package name>`. على سبيل المثال، يمثّل `app:com.google.android.gm` تطبيق Gmail.
`productPricing`	`string`	ما إذا كان هذا المنتج مجانيًا أو مجانيًا مع عمليات الشراء داخل التطبيق أو مدفوعًا إذا كان السعر غير معروف، هذا يعني أن المنتج لم يعد متوفرًا بشكل عام (على الرغم من أنه قد لا يزال متاحًا للأشخاص الذين يمتلكونه). القيم المقبولة هي: "`free`" "`freeWithInAppPurchase`" "`paid`"
`recentChanges`	`string`	وصف للتغييرات الأخيرة التي تم إجراؤها على التطبيق.
`requiresContainerApp`	`boolean`	تمّ الإيقاف.
`screenshotUrls[]`	`list`	قائمة بروابط لقطات الشاشة التي تمثل التطبيق.
`signingCertificate`	`nested object`	تمثّل هذه السمة الشهادة المستخدَمة لتوقيع هذا المنتج.
`signingCertificate.certificateHashSha1`	`string`	تجزئة SHA1 بترميز urlsafe لـ Base64 الخاصة بالشهادة (تم إيقاف هذا الحقل لصالح SHA2-256. ولا يجوز استخدامها وقد تتم إزالتها في أي وقت.)
`signingCertificate.certificateHashSha256`	`string`	تجزئة SHA2-256 بترميز urlsafe لـ Base64 الخاصة بالشهادة
`smallIconUrl`	`string`	تمثّل هذه السمة رابطًا يؤدي إلى صورة أصغر يمكن استخدامها كرمز للمنتج. هذه الصورة مناسبة للاستخدام حتى 128 بكسل × 128 بكسل.
`title`	`string`	اسم المنتج
`workDetailsUrl`	`string`	رابط إلى صفحة تفاصيل "Google Play للأعمال" للمنتج، ليستخدمه مشرف Enterprise.

الطُرق

موافقة

يوافق على المنتج المحدد وأذونات التطبيق ذات الصلة، إن وجدت. الحد الأقصى لعدد المنتجات التي يمكنك الموافقة عليها لكل عميل في المؤسسة هو 1,000 منتج.

للتعرّف على كيفية استخدام "Google Play للأعمال" لتصميم وإنشاء تنسيق للمتجر لعرض المنتجات التي تمت الموافقة عليها للمستخدمين، راجع تصميم تنسيق المتجر.

ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة.

generateApprovalUrl

ينشئ عنوان URL يمكن عرضه في إطار iframe لعرض الأذونات (إن توفّرت) لأحد المنتجات. وعلى أحد مشرفي المؤسسة الاطّلاع على هذه الأذونات وقبولها نيابةً عن مؤسسته من أجل الموافقة على هذا المنتج.

على المشرفين قبول الأذونات المعروضة من خلال التفاعل مع عنصر منفصل في واجهة المستخدم في وحدة تحكّم "إدارة الخدمات الجوّالة للمؤسسات"، ما يؤدي بدوره إلى تفعيل استخدام عنوان URL هذا كسمة approvalUrlInfo.approvalUrl في طلب على Products.approve للموافقة على المنتج. يمكن استخدام عنوان URL هذا فقط لعرض الأذونات لمدة تصل إلى يوم واحد. ملاحظة: تم إيقاف هذا العنصر نهائيًا. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكن أن تشير إلى اقتراحاتنا الجديدة.

الحصول على

استرداد تفاصيل منتج لعرضها لأحد مشرفي المؤسسة.

getAppRestrictionsSchema

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

getPermissions

استرداد أذونات تطبيق Android التي يتطلبها هذا التطبيق.

list

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

إلغاء الموافقة

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