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

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

ويتم الوصول إلى جميع واجهات برمجة التطبيقات عبر بروتوكول 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.

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

الوصف القيمة
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 API لمعرّفات القنوات التالية:

الوصف القيمة
إصدار ثابت ممتد 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. إذا لم تتم كتابة أي نسخة بشكل كامل، يلحق سجلّ الإصدارات 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.