يشغّل تحليل PageSpeed للصفحة على عنوان URL المحدد، ويعرض نتائج PageSpeed، وقائمة اقتراحات لجعل هذه الصفحة أسرع، ومعلومات أخرى.
طلب HTTP
GET https://pagespeedonline.googleapis.com/pagespeedonline/v5/runPagespeed
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معامِلات طلب البحث
المعلمات | |
---|---|
category |
فئة Lighthouse التي يجب تشغيلها في حال عدم تحديد أي سمة، سيتم تنفيذ فئة "الأداء" فقط. |
locale |
اللغة المستخدمة لأقلمة النتائج المنسقة |
strategy |
يجب استخدام استراتيجية التحليل (سطح المكتب أو الهاتف الجوّال)، وأجهزة الكمبيوتر المكتبي هي الخيار التلقائي |
url |
مطلوب. عنوان URL المطلوب استرجاعه وتحليله |
utm_campaign |
اسم الحملة في "إحصاءات Google" |
utm_source |
مصدر الحملة للإحصاءات. |
captchaToken |
تم تمرير رمز CAPTCHA المميز عند ملء اختبار CAPTCHA. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
كائن الاستجابة Pagespeed API.
تمثيل JSON | |
---|---|
{ "kind": string, "captchaResult": string, "id": string, "loadingExperience": { object ( |
الحقول | |
---|---|
kind |
نوع النتيجة. |
captchaResult |
نتيجة التحقّق من اختبار CAPTCHA |
id |
عنوان URL الأساسي والنهائي للمستند، بعد عمليات إعادة التوجيه التالية للصفحة (إن وجدت). |
loadingExperience |
مقاييس سلوك المستخدمين تجربة تحميل الصفحة |
originLoadingExperience |
مقاييس تجربة تحميل الصفحات المجمَّعة للمصدر |
analysisUTCTimestamp |
الطابع الزمني للتوقيت العالمي المتفق عليه لهذا التحليل |
lighthouseResult |
استجابة أداة Lighthouse لعنوان URL للتدقيق باعتباره كائنًا. |
version |
إصدار سرعة الصفحة المستخدم لإنشاء هذه النتائج. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
openid
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
الفئة
الفئات المعدّة التي يجب تحليلها.
عمليات التعداد | |
---|---|
CATEGORY_UNSPECIFIED |
الفئة التلقائية "غير محدّد". |
ACCESSIBILITY |
إمكانية الوصول (a11y)، الفئة المتعلقة بقدرة موقع الويب على أن تكون في متناول جميع المستخدمين. |
BEST_PRACTICES |
أفضل الممارسات، الفئة المتعلقة بتوافق موقع الويب مع أفضل ممارسات الويب. |
PERFORMANCE |
الأداء، الفئة المتعلقة بأداء موقع الويب. |
SEO |
تحسين محركات البحث (SEO)، وهي الفئة التي تتعلق بإمكانية فهرسة موقع الويب بواسطة محركات البحث. |
الاستراتيجية
يشير ذلك المصطلح إلى استراتيجية تشغيل الجهاز التي سيتم استخدامها في التحليل.
عمليات التعداد | |
---|---|
STRATEGY_UNSPECIFIED |
غير محدد. |
DESKTOP |
يمكنك استرجاع عنوان URL وتحليله للمتصفحات المتوافقة مع أجهزة الكمبيوتر المكتبي. |
MOBILE |
يمكنك استرجاع عنوان URL وتحليله للأجهزة الجوّالة. |
PagespeedApiLoadingExperienceV5
عنصر تجربة تحميل CrUX الذي يحتوي على تقسيمات بيانات CrUX.
تمثيل JSON | |
---|---|
{
"id": string,
"metrics": {
string: {
object ( |
الحقول | |
---|---|
id |
عنوان URL أو النمط أو المصدر الذي تستخدمه المقاييس. |
metrics |
خريطة <المقاييس, البيانات>. عنصر يحتوي على قائمة بأزواج |
overall_category |
تشير "الفئة" إلى السرعة التي يمكن لشخص عادي قراءتها المعرّف. |
initial_url |
قد يختلف عنوان URL المطلوب عن "المعرِّف" الذي تم حلّه. |
origin_fallback |
صحيح إذا كانت النتيجة مصدرًا احتياطيًا من صفحة، وخطأ في الحالات الأخرى. |
LighthouseResultV5
كائن النتيجة Lighthouse
تمثيل JSON | |
---|---|
{ "fetchTime": string, "requestedUrl": string, "finalUrl": string, "lighthouseVersion": string, "i18n": { object ( |
الحقول | |
---|---|
fetchTime |
الوقت الذي تم فيه استرجاع بيانات عملية التشغيل هذه |
requestedUrl |
عنوان URL الأصلي المطلوب. |
finalUrl |
عنوان URL النهائي الذي تم حلّه والذي تم تدقيقه |
lighthouseVersion |
إصدار المنارة الذي تم استخدامه لإنشاء هذا LHR |
i18n |
سلاسل التدويل المطلوبة لعرض LHR |
userAgent |
وكيل المستخدم الذي تم استخدامه لتشغيل هذا LHR |
audits |
خريطة عمليات التدقيق في LHR عنصر يحتوي على قائمة بأزواج |
categoryGroups |
خريطة لمجموعات الفئات في LHR عنصر يحتوي على قائمة بأزواج |
stackPacks[] |
سلاسل نصائح حزمة التكديس. |
environment |
إعدادات البيئة التي تم استخدامها عند إنشاء موقع LHR هذا. |
runWarnings |
قائمة بجميع تحذيرات التشغيل في LHR سيتم دومًا الإخراج إلى |
runtimeError |
رسالة خطأ من المستوى الأعلى تشير، في حال توفّرها، إلى حدوث مشكلة خطيرة بدرجة كافية تتطلّب التخلّص من نتيجة Lighthouse هذه. |
categories |
خريطة الفئات في LHR. |
timing |
معلومات التوقيت في موقع LHR هذا. |
configSettings |
إعدادات الضبط لـ LHR هذا. |
عرض تقديمي عالمي 18
رسالة تحتوي على بيانات i18n لجهاز LHR - الإصدار 1
تمثيل JSON | |
---|---|
{
"rendererFormattedStrings": {
object ( |
الحقول | |
---|---|
rendererFormattedStrings |
سلاسل دولية يتم تنسيقها حسب اللغة في configSettings. |
RendererFormattedStrings
رسالة تحتوي على السلاسل المنسّقة المستخدمة في العارض.
تمثيل JSON | |
---|---|
{ "varianceDisclaimer": string, "opportunityResourceColumnLabel": string, "opportunitySavingsColumnLabel": string, "errorMissingAuditInfo": string, "errorLabel": string, "warningHeader": string, "auditGroupExpandTooltip": string, "passedAuditsGroupTitle": string, "notApplicableAuditsGroupTitle": string, "manualAuditsGroupTitle": string, "toplevelWarningsMessage": string, "scorescaleLabel": string, "crcLongestDurationLabel": string, "crcInitialNavigation": string, "lsPerformanceCategoryDescription": string, "labDataTitle": string } |
الحقول | |
---|---|
varianceDisclaimer |
يظهر بيان إخلاء المسؤولية أسفل قيمة مقياس الأداء. |
opportunityResourceColumnLabel |
عنوان فرصة التوفير المقدّرة لتحميل الصفحة في عملية التدقيق |
opportunitySavingsColumnLabel |
عنوان التوفيرات المقدَّرة في تحميل الصفحة لعمليات تدقيق الفرص |
errorMissingAuditInfo |
سلسلة الخطأ المعروضة بجانب عملية تدقيق تتضمّن أخطاءً. |
errorLabel |
التصنيف المعروض بجانب التدقيق أو المقياس الذي به خطأ. |
warningHeader |
التصنيف المعروض أعلى قائمة نقطية من التحذيرات. |
auditGroupExpandTooltip |
نص التلميح على رمز شيفرون قابل للتوسيع |
passedAuditsGroupTitle |
العنوان الذي يظهر أعلى قائمة عمليات التدقيق التي اجتازت المراجعة. |
notApplicableAuditsGroupTitle |
العنوان الموضح أعلى قائمة بعمليات التدقيق التي لا تنطبق على إحدى الصفحات. |
manualAuditsGroupTitle |
العنوان الموضح أعلى قائمة عمليات التدقيق التي لم يتم إجراؤها باستخدام الكمبيوتر أثناء التشغيل. |
toplevelWarningsMessage |
يتم عرض التصنيف السابق للتحذيرات المهمة التي قد تكون أدت إلى إلغاء صلاحية تقرير كامل. |
scorescaleLabel |
التسمية التي تشرح مقياس مقياس الدرجة (0-49، 50-89، 90-100). |
crcLongestDurationLabel |
تصنيف القيم المعروضة في ملخّص سلاسل الطلبات المهمة. |
crcInitialNavigation |
تصنيف الطلب الأولي في سلسلة طلب مهمة. |
lsPerformanceCategoryDescription |
بيان إخلاء المسؤولية الذي يظهر تحت الأداء الذي يوضّح أن الشبكة قد تختلف. |
labDataTitle |
تمثّل هذه السمة عنوان فئة أداء بيانات المختبر. |
StackPack
رسالة تحتوي على معلومات حزمة الحزم.
تمثيل JSON | |
---|---|
{ "id": string, "title": string, "iconDataURL": string, "descriptions": { string: string, ... } } |
الحقول | |
---|---|
id |
رقم تعريف حزمة المكدس |
title |
تمثّل هذه السمة عنوان حزمة الحزم. |
iconDataURL |
معرّف الموارد المنتظم (URI) الخاص ببيانات رمز حزمة الحزمة |
descriptions |
سلاسل النصائح لحزمة المكدس. عنصر يحتوي على قائمة بأزواج |
البيئة
رسالة تحتوي على إعدادات بيئة تشغيل Lighthouse
تمثيل JSON | |
---|---|
{ "networkUserAgent": string, "hostUserAgent": string, "benchmarkIndex": number } |
الحقول | |
---|---|
networkUserAgent |
سلسلة وكيل المستخدم التي تم إرسالها عبر الشبكة. |
hostUserAgent |
سلسلة وكيل المستخدم لإصدار Chrome المُستخدَم. |
benchmarkIndex |
رقم المؤشر المعياري الذي يشير إلى فئة الجهاز التقريبية. |
RuntimeError
رسالة تحتوي على إعدادات خطأ في بيئة التشغيل
تمثيل JSON | |
---|---|
{ "code": string, "message": string } |
الحقول | |
---|---|
code |
رمز خطأ Lighthouse المعدود. |
message |
رسالة يمكن لشخص عادي قراءتها توضّح رمز الخطأ |
الفئات
الفئات في عرض Lighthouse
تمثيل JSON | |
---|---|
{ "accessibility": { object ( |
الحقول | |
---|---|
accessibility |
فئة تسهيل الاستخدام، التي تحتوي على جميع عمليات التدقيق المتعلقة بإمكانية الوصول. |
best-practices |
فئة أفضل الممارسات، التي تحتوي على جميع عمليات التدقيق المتعلقة بأفضل الممارسات. |
seo |
فئة تحسين محركات البحث (SEO) التي تتضمن جميع عمليات التدقيق المتعلقة بتحسين محركات البحث. |
performance |
فئة الأداء، التي تحتوي على جميع عمليات التدقيق المتعلّقة بالأداء |
LighthouseCategoryV5
فئة Lighthouse
تمثيل JSON | |
---|---|
{
"id": string,
"title": string,
"description": string,
"manualDescription": string,
"auditRefs": [
{
object ( |
الحقول | |
---|---|
id |
معرِّف السلسلة للفئة. |
title |
تمثّل هذه السمة اسم الفئة مناسبًا للمستخدمين. |
description |
وصف أكثر تفصيلاً للفئة وأهميتها. |
manualDescription |
وصف لعمليات التدقيق اليدوية في الفئة. |
auditRefs[] |
مصفوفة من المراجع لجميع أعضاء التدقيق في هذه الفئة. |
score |
النتيجة الإجمالية للفئة، المتوسط المرجح لجميع عمليات التدقيق. (يمكن أن تكون نتيجة الفئة فارغة.) |
AuditRefs
مرجع خفيف إلى تدقيق حسب رقم التعريف، يُستخدم لتجميع عمليات التدقيق وترجيحها في فئة معيّنة.
تمثيل JSON | |
---|---|
{ "id": string, "weight": number, "group": string } |
الحقول | |
---|---|
id |
رقم تعريف مرجع التدقيق |
weight |
تشير هذه السمة إلى أهمية نتيجة التدقيق هذه في نتيجة الفئة الإجمالية. |
group |
مجموعة الفئات التي ينتمي إليها التدقيق (اختيارية) |
التوقيت
رسالة تحتوي على بيانات توقيت الأداء لعملية تشغيل Lighthouse
تمثيل JSON | |
---|---|
{ "total": number } |
الحقول | |
---|---|
total |
إجمالي مدة تشغيل Lighthouse. |
ConfigSettings
رسالة تحتوي على إعدادات الضبط لتشغيل Lighthouse
تمثيل JSON | |
---|---|
{ "onlyCategories": value, "emulatedFormFactor": string, "locale": string, "channel": string, "formFactor": string } |
الحقول | |
---|---|
onlyCategories |
قائمة فئات عمليات التدقيق التي يجب إجراؤها. |
emulatedFormFactor |
تمثّل هذه السمة شكل الجهاز الذي يجب أن تستخدمه المحاكاة. تم إيقاف هذا الحقل نهائيًا، ويجب استخدام formFactor بدلاً منه. |
locale |
إعداد اللغة. |
channel |
طريقة تشغيل Lighthouse، على سبيل المثال من إضافة Chrome أو من وحدة npm. |
formFactor |
الطريقة التي يجب أن تفسّر بها أداة Lighthouse هذا التشغيل في ما يتعلق بتسجيل مقاييس الأداء وتخطّي اختبارات الأجهزة الجوّالة فقط على أجهزة الكمبيوتر المكتبي. |
PagespeedVersion
عنصر Pagespeed Version
تمثيل JSON | |
---|---|
{ "major": string, "minor": string } |
الحقول | |
---|---|
major |
رقم الإصدار الرئيسي لسرعة الصفحة المستخدم لإنشاء هذه النتائج. |
minor |
الرقم الثانوي لسرعة الصفحة المستخدم لإنشاء هذه النتائج. |