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

تحتوي هذه الصفحة على معلومات مرجعية فنية حول واجهة برمجة التطبيقات للخدمة web 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 Web Engine 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 lacros

القناة

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

الحصول على القنوات الصالحة لمنصّة معيّنة

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

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

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

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

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

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

أضِف مَعلمة طلب بحث filter لفلترة النتائج. لا تتيح سوى نقطتا نهاية version وrelease الفلترة. مثال:

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 لترتيب النتائج. لا تتيح سوى نقطتا نهاية version وrelease إمكانية الترتيب. مثال:

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.