مرجع VersionHistory API

این صفحه حاوی اطلاعات مرجع فنی در مورد API وب سرویس VersionHistory است.

تمام دسترسی های API از طریق 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
موتور وب فوشیا fuchsiawebengine

پلت فرم

پلتفرم یکی از پلتفرم‌های محاسباتی است که محصول روی آن اجرا می‌شود، مانند ویندوز، اندروید و غیره.

همه پلتفرم ها را دریافت کنید

GET /{product}/platforms
نام توضیحات
product یک شناسه محصول

تمام پلتفرم ها و ترکیب های کانال را دریافت کنید

GET /{product}/platforms/all/channels
نام توضیحات
product یک شناسه محصول

شناسه های پلتفرم

توضیحات ارزش
همه پلتفرم ها all
ویندوز win
ویندوز (64 بیت) win64
مک mac
Mac (ARM64) mac_arm64
لینوکس linux
اندروید android
WebView webview
iOS ios
لاکروس lacros

کانال

ببینید چگونه می توانم از کدام کانال استفاده کنم؟ برای توضیح کانال های کروم.

کانال های معتبر یک پلتفرم را دریافت کنید

کانال های معتبر را برای یک پلتفرم معین فهرست می کند:

GET /{product}/platforms/{platform}/channels
نام توضیحات
product یک شناسه محصول
platform شناسه پلتفرم

شناسه های کانال

VersionHistory API از شناسه های کانال زیر پشتیبانی می کند:

توضیحات ارزش
پایدار توسعه یافته extended
پایدار stable
بتا beta
توسعه دهنده dev
قناری canary
قناری (انواع ساخت) canary_asan

نتایج را فیلتر کنید

یک پارامتر پرس و جو filter برای فیلتر کردن نتایج اضافه کنید. فقط نقاط پایانی نسخه و نسخه از فیلتر کردن پشتیبانی می کنند. مثال:

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

مقدار filter باید لیستی از عبارات جدا شده با کاما باشد. هر عبارت باید به شکل field operator value باشد.

مورد مقادیر معتبر
میدان version ، name ، platform ، starttimeendtimefraction *
اپراتور < , <= , = , > , >=
  • فیلتر کانال با فاصله از Stable انجام می شود، به عبارت دیگر 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 query به نتایج سفارش اضافه کنید. فقط نسخه و نسخه نهایی از سفارش پشتیبانی می کنند. مثال:

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 است.