Grouplicenses

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

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

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

يمكنك استخدام واجهة برمجة التطبيقات للاستعلام عن تراخيص المجموعة. يتضمن مورد Grouplicenses إجمالي عدد التراخيص التي تم شراؤها (التطبيقات المدفوعة فقط) وإجمالي عدد التراخيص المستخدمة حاليًا. وبعبارة أخرى، إجمالي عدد Entitlements المتوفّر للمنتج.

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

{
  "kind": "androidenterprise#groupLicense",
  "productId": string,
  "numPurchased": integer,
  "numProvisioned": integer,
  "acquisitionKind": string,
  "approval": string,
  "permissions": string
}
اسم الموقع القيمة الوصف ملاحظات
acquisitionKind string كيفية الحصول على ترخيص المجموعة هذا. "bulkPurchase" تعني أن هذا المورد لتراخيص المجموعة تم إنشاؤه لأن المؤسسة قد اشترت تراخيص لهذا المنتج، وإلا فستكون القيمة "free" (للمنتجات المجانية).

القيم المقبولة هي:
  • "bulkPurchase"
  • "free"
approval string ما إذا كان المنتج الذي يرتبط به ترخيص المجموعة هذا موافقًا عليه حاليًا من قِبل المؤسسة. تتم الموافقة على المنتجات عند إنشاء ترخيص مجموعة لأول مرة، ولكن يمكن إبطال هذه الموافقة بواسطة مشرف المؤسسة عبر Google Play. ولن تظهر المنتجات التي لم تتم الموافقة عليها للمستخدمين في مجموعات، ويجب عادةً عدم إنشاء استحقاقات جديدة لها.

القيم المقبولة هي:
  • "approved"
  • "unapproved"
kind string
numProvisioned integer إجمالي عدد التراخيص المتوفرة لهذا المنتج. يتم عرضها من خلال عمليات القراءة، ولكن يتم تجاهلها في عمليات الكتابة.
numPurchased integer عدد التراخيص التي تم شراؤها (ربما في عمليات شراء متعددة). إذا تم حذف هذا الحقل، فليس هناك حد لعدد التراخيص التي يمكن توفيرها (على سبيل المثال، إذا كان نوع الاكتساب هو "free").
permissions string حالة الموافقة على المنتج. ولا يتم ضبط هذا الحقل إلا إذا تمت الموافقة على المنتج. الحالات المحتملة هي:
  • "currentApproved"، تتم الموافقة على مجموعة الأذونات الحالية، ولكن ستتطلب الأذونات الإضافية من المشرف إعادة الموافقة على المنتج (إذا تمت الموافقة على المنتج بدون تحديد إعداد الأذونات التي تمت الموافقة عليها، يكون هذا هو السلوك التلقائي).
  • "needsReapproval"، يحتوي المنتج على أذونات غير مصرّح بها. لا يمكن تعيين تراخيص منتجات إضافية حتى تتم الموافقة على المنتج مرة أخرى،
  • "allCurrentAndFutureApproved"، ستتم الموافقة على الأذونات الحالية، وستتم الموافقة تلقائيًا على أي تحديثات أذونات في المستقبل بدون مراجعة المشرف.


القيم المقبولة هي:
  • "allCurrentAndFutureApproved"
  • "currentApproved"
  • "needsReapproval"
productId string رقم تعريف المنتج الذي تم الترخيص له. مثلاً: "app:com.google.android.gm"

الطُرق

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