Grouplicenses

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

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

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

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

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

{
  "kind": "androidenterprise#groupLicense",
  "productId": string,
  "numPurchased": integer,
  "numProvisioned": integer,
  "acquisitionKind": string,
  "approval": string,
  "permissions": string
}
اسم الموقع القيمة الوصف Notes
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
استرداد أرقام تعريف جميع المنتجات التي تمتلك المؤسسة ترخيصًا جماعيًا لها