مرجع واجهة برمجة التطبيقات لسجلّ الإصدارات

تحتوي هذه الصفحة على معلومات مرجعية فنية حول واجهة برمجة التطبيقات لخدمة VersionHistory على الويب.

تتم جميع عمليات الوصول إلى واجهة برمجة التطبيقات عبر بروتوكول HTTPS، ويتم الوصول إليها من خلال https://versionhistory.googleapis.com/v1.

الإصدار

الإصدار هو نسخة معيَّنة من Chrome يشغلها المستخدمون.

الحصول على معلومات حول الإصدار الخاص بمنصة وقناة معيّنة

يتم إدراج جميع إصدارات Chrome للمنصة والقناة المحدَّدتين.

GET /{product}/platforms/{platform}/channels/{channel}/versions
الاسم الوصف
product معرّف المنتج
platform معرِّف النظام الأساسي:
channel معرِّف القناة:

الإصدار

الإصدار هو الفاصل الزمني الذي كان المستخدمون فيه يشغّلون إصدارًا معيّنًا من Chrome. توفّر نقاط نهاية الإصدار أيضًا معلومات حول نسبة المستخدمين الذين كانوا يشغّلون هذا الإصدار من Chrome خلال هذه الفترة الزمنية.

الحصول على جميع الإصدارات

يتم عرض جميع الإصدارات الخاصة بالنظام الأساسي والقناة والإصدار المحدّدَين.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
الاسم الوصف
product معرّف المنتج
platform معرِّف النظام الأساسي:
channel معرِّف القناة:
version معرِّف إصدار

المنتَج

المنتج هو جزء من برنامج مثل Chrome أو Fuchsia Web Engine.

معرفات المنتج

الوصف القيمة
Chrome chrome
محرك ويب Fuchsia fuchsiawebengine

النظام الأساسي

المنصة هي إحدى منصات الحوسبة التي يعمل عليها المنتج، مثل Windows وAndroid وغيرها.

الحصول على جميع المنصات

GET /{product}/platforms
الاسم الوصف
product معرّف المنتج

الحصول على كل مجموعات المنصات والقنوات

GET /{product}/platforms/all/channels
الاسم الوصف
product معرّف المنتج

معرّفات النظام الأساسي

الوصف القيمة
جميع المنصات all
أجهزة Windows win
Windows (64 بت) win64
نظام التشغيل Mac mac
Mac (ARM64) mac_arm64
Linux linux
Android android
WebView webview
iOS ios
لاكروس lacros

القناة

يمكنك مراجعة كيف أختار القناة التي تريد استخدامها؟ للحصول على شرح لقنوات Chrome.

الحصول على القنوات الصالحة للنظام الأساسي

يسرد القنوات الصالحة لمنصّة معيّنة:

GET /{product}/platforms/{platform}/channels
الاسم الوصف
product معرّف المنتج
platform معرِّف النظام الأساسي:

معرّفات القنوات

تتيح واجهة برمجة التطبيقات VersionHistory مع معرّفات القنوات التالية:

الوصف القيمة
استقرار موسّع extended
إسطبل stable
إصدار تجريبي beta
المطوّر dev
الكاناري canary
إصدار Canary (إصدار تجريبي) canary_asan

فلترة النتائج

أضِف معلَمة طلب البحث filter لفلترة النتائج. لا يمكن استخدام الفلترة إلّا من نقطتَي نهاية الإصدار والإصدار. مثال:

GET /chrome/platforms/win/channels/stable/versions/all/releases?filter=fraction=1

يجب أن تكون قيمة filter قائمة تعبيرات مفصولة بفواصل. يجب أن يكون كل تعبير على شكل field operator value.

المنتج/الخدمة القيم الصالحة
الحقل version وname وplatform وstarttime* وendtime* وfraction*
المؤثِّر < و<= و= و> و>=
  • تتم فلترة القنوات من خلال المسافة من القناة الثابتة، أي stable < beta < dev < canary < canary_asan. على سبيل المثال، تعرض الدالة channel<=dev معلومات حول stable وbeta وdev.
  • وتتم فلترة الإصدارات رقميًا، على سبيل المثال 1.0.0.8 < 1.0.0.10. إذا لم تتم كتابة النسخة بالكامل، يلحق VersionHistory القيمة 0 في الحقول المفقودة. على سبيل المثال، تصبح السمة version>80 version>80.0.0.0.
  • فلاتر endtime=none للإصدارات المنشورة حاليًا والتي لم يتم تحديد تاريخ انتهاء لها بعد
  • عند الفلترة حسب starttime أو endtime، يجب أن تكون القيمة بتنسيق سلسلة التاريخ RFC 3339.
  • تتم فلترة name وplatform من خلال مقارنة السلاسل.
  • بالنسبة إلى الإصدارات التي لا يزال Chrome يعرضها، لن تتم تعبئة serving.endtime. أثناء الترتيب أو الفلترة، سيتم التعامل مع serving.endtime على أنّه 1970-01-01T00:00:00Z إذا لم تتم تعبئة الحقل.
  • وتُستخدَم fraction لتحديد عدد المستخدمين الذين شاركوا في عملية الطرح. على سبيل المثال، تعني القيمة fraction=1 100% من المستخدمين.

نتائج الطلب

أضِف معلَمة طلب البحث order_by إلى نتائج الترتيب. لا يمكن إجراء الطلب إلا من خلال نقطتَي نهاية الإصدار والإصدار. مثال:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime

تقبل order_by قائمة مفصولة بفواصل تضم القيم التالية: version وname وplatform وchannel وstarttime وendtime وfraction.

أضِف مسافة (%20) متبوعة بـ asc أو desc بعد قيمة order_by لتحديد الترتيب التصاعدي أو التنازلي. مثال:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • يتم ترتيب القنوات بالترتيب التالي: stable، وbeta، وdev، وcanary، وcanary_asan.
  • قد يؤدي الترتيب حسب name إلى حدوث سلوك غير متوقع لأنّه يعتبر ترتيبًا بسيطًا للسلسلة. على سبيل المثال، سيكون 1.0.0.8 قبل 1.0.0.10 بترتيب تنازلي.
  • في حال عدم تحديد السمة order_by، يتم ضبط الترتيب التلقائي على platform وchannel وversion ثم serving.starttime.