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