واجهة برمجة تطبيقات CrUX History

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

تاريخ النشر: 7 شباط (فبراير) 2023، تاريخ آخر تعديل: 11 نيسان (أبريل) 2025

توفّر واجهة برمجة التطبيقات CrUX History API إمكانية الوصول بسرعة منخفضة إلى بيانات سابقة عن تجربة المستخدمين الفعليين على مدار ستة أشهر، وذلك بدقة الصفحة والمصدر.

جرِّبه الآن

حالة الاستخدام الشائعة

تتيح واجهة برمجة التطبيقات CrUX History API طلب مقاييس سابقة لتجربة المستخدم لعنوان URL معيّن، مثل "الحصول على مؤشرات سابقة لتجربة المستخدم لمصدر https://example.com".

تتّبع واجهة برمجة التطبيقات History API البنية نفسها المستخدَمة في واجهة CrUX API اليومية، باستثناء أنّ القيم يتم تقديمها في صفيف، ويتم تصنيف المفاتيح بأسماء جمع (على سبيل المثال، histogramTimeseries بدلاً من histogram أو p75s بدلاً من p75).

مفتاح واجهة برمجة التطبيقات CrUX

مثل واجهة برمجة التطبيقات اليومية، يتطلّب استخدام واجهة برمجة التطبيقات CrUX History API مفتاح Google Cloud API تم إعداده لاستخدام Chrome UX Report API. يمكن استخدام المفتاح نفسه لواجهة برمجة التطبيقات الخاصة بالبيانات اليومية والسجلّ.

الحصول على مفتاح واجهة برمجة التطبيقات واستخدامه

أو يمكنك إنشاء حساب في صفحة بيانات الاعتماد.

بعد الحصول على مفتاح واجهة برمجة التطبيقات، يمكن لتطبيقك إلحاق مَعلمة طلب البحث key=yourAPIKey بجميع عناوين URL للطلبات.

مفتاح واجهة برمجة التطبيقات آمن لتضمينه في عناوين URL، ولا يحتاج إلى أي ترميز.

اطّلِع على أمثلة على طلبات البحث.

نموذج البيانات

يوضّح هذا القسم بالتفصيل بنية البيانات في الطلبات والردود.

تسجيل

قطعة منفصلة من المعلومات عن صفحة أو موقع إلكتروني يمكن أن يتضمّن السجلّ بيانات خاصة بمعرّف ومجموعة محدّدة من السمات. يمكن أن يحتوي السجلّ على بيانات لمقياس واحد أو أكثر.

المعرفات

تحدِّد المعرّفات السجلّات التي يجب البحث عنها. في CrUX، تكون هذه المعرّفات هي صفحات الويب والمواقع الإلكترونية.

الأصل

عندما يكون المعرّف مصدرًا، يتم تجميع كل البيانات المتوفّرة لجميع الصفحات في ذلك المصدر معًا. على سبيل المثال، لنفترض أنّ مصدر http://www.example.com يتضمّن صفحات على النحو الموضّح في خريطة الموقع هذه:

http://www.example.com/
http://www.example.com/foo.html
http://www.example.com/bar.html

وهذا يعني أنّه عند طلب "تقرير تجربة المستخدم على Chrome" مع ضبط المصدر على http://www.example.com، سيتم عرض بيانات http://www.example.com/ وhttp://www.example.com/foo.html وhttp://www.example.com/bar.html مجمّعة معًا، لأنّ هذه هي جميع الصفحات ضمن هذا المصدر.

عناوين URL

عندما يكون المعرّف عنوان URL، سيتم عرض بيانات عنوان URL هذا فقط. بالرجوع إلى خريطة الموقع الأصلية http://www.example.com:

http://www.example.com/
http://www.example.com/foo.html
http://www.example.com/bar.html

إذا تم ضبط المعرّف على عنوان URL بالقيمة http://www.example.com/foo.html، سيتم عرض بيانات تلك الصفحة فقط.

الأبعاد

تحدِّد السمات مجموعة محدّدة من البيانات التي يتم تجميع السجلّ استنادًا إليها. على سبيل المثال، يشير شكل الجهاز PHONE إلى أنّ السجلّ يحتوي على معلومات عن عمليات التحميل التي حدثت على جهاز جوّال.

شكل الجهاز

لا تتوفّر واجهة برمجة التطبيقات CrUX History API إلا مجمّعة حسب سمة شكل الجهاز. هذه فئة عامة للأجهزة مُقسَّمة إلى PHONE وTABLET وDESKTOP.

المقياس

نُبلغ عن المقاييس في سلاسل زمنية من التجميعات الإحصائية، وهي المخططات البيانية للشرائح التكرارية والنسب المئوية والأجزاء.

المدرجات التكرارية

عند التعبير عن المقاييس في صفيف مخطّط بياني هرمي، يمثّل كل إدخال في السلسلة الزمنية النسبة المئوية لتحميلات الصفحة التي سقط فيها المقياس في فاصل زمني، وذلك بشكلٍ نسبي لجميع عمليات التحميل. يتم عرض نقاط البيانات بترتيب تواريخ فترة جمع البيانات التي تعرضها أيضًا واجهة برمجة التطبيقات، وتكون النقطة الأولى هي أقرب فترة، وتكون النقطة الأخيرة هي أحدث فترة جمع بيانات.

يظهر الرسم البياني الشريطي للاحتمالية بثلاثة أقسام لمثال على مقياس على النحو التالي:

{
  "histogramTimeseries": [
    {
      "start": 0,
      "end": 2500,
      "densities": [0.9190, 0.9203, 0.9194, 0.9195, 0.9183, 0.9187]
    },
    {
      "start": 2500,
      "end": 4000,
      "densities": [0.0521, 0.0513, 0.0518, 0.0518, 0.0526, 0.0527]
    },
    {
      "start": 4000,
      "densities": [0.0288, 0.0282, 0.0286, 0.0285, 0.0290, 0.0285]
    }
  ],
}

تشير هذه البيانات إلى أنّ% 91.90 من عمليات تحميل الصفحة سجّلت قيمة المقياس النموذجي بين 0 و2,500 ملي ثانية لفترة جمع البيانات الأولى في السجلّ، يليها %92.03 و%91.94 وما إلى ذلك. لا تتضمّن هذه الرسمة البيانية لأشرطة الكثافة وحدات المقياس، وفي هذه الحالة سنفترض أنّها مللي ثانية.

بالإضافة إلى ذلك، سجّل ‎5.21% من عمليات تحميل الصفحة قيمة المقياس النموذجي بين ‎2,500 و‎4,000 ملي ثانية في أوّل فترة جمع في السجلّ، وسجّل ‎2.88% من عمليات تحميل الصفحة قيمة أكبر من ‎4,000 ملي ثانية في أوّل فترة جمع في السجلّ.

النِسب المئوية

قد تحتوي المقاييس أيضًا على سلاسل زمنية للنسب المئوية التي يمكن أن تكون مفيدة لإجراء تحليل إضافي.

يتم عرض نقاط البيانات بترتيب تواريخ فترة جمع البيانات التي تعرضها أيضًا واجهة برمجة التطبيقات، وتكون النقطة الأولى هي أقرب فترة، وتكون النقطة الأخيرة هي أحدث فترة جمع بيانات.

{
  "percentilesTimeseries": {
    "p75s": [1362, 1352, 1344, 1356, 1366, 1377]
  },
}

يمكن أن تعرِض هذه النسب المئوية قيم مقاييس معيّنة في النسبة المئوية المحدّدة لذلك المقياس. وتستند هذه القيم إلى المجموعة الكاملة من البيانات المتاحة وليس إلى البيانات النهائية التي تم تجميعها في مجموعات، لذا لا تتطابق بالضرورة مع النسبة المئوية التي تمّت إضافتها استنادًا إلى المخطّط التكراري النهائي الذي تم تجميعه في مجموعات.

الكسور

يمكن التعبير عن المقاييس على شكل سلسلة زمنية من الكسور المُصنَّفة، ويصف كل تصنيف تحميل صفحة بطريقة معيّنة. يتم عرض نقاط البيانات بترتيب تواريخ فترة جمع البيانات التي تعرضها أيضًا واجهة برمجة التطبيقات، وتكون النقطة الأولى هي أقرب فترة، وتكون النقطة الأخيرة هي أحدث فترة جمع بيانات.

مثال:

{    
  "fractionTimeseries": {
    "desktop": {"fractions": [0.3195, 0.2115, 0.1421]},
    "phone": {"fractions": [0.6295, 0.7544, 0.8288]},
    "tablet": {"fractions": [0.051, 0.0341, 0.029]}
  }
}

في هذا المثال، تشير أحدث نقطة بيانات إلى أنّ% 14.21 من عمليات تحميل الصفحة مصدرها أجهزة الكمبيوتر المكتبي، و% 82.88 مصدرها الهواتف.

أنواع قيم المقاييس

بما أنّ واجهة برمجة التطبيقات CrUX History API تستخدِم أنواع قيم المقاييس نفسها، يمكنك الرجوع إلى مستندات أنواع قيم المقاييس اليومية لواجهة برمجة التطبيقات CrUX API للحصول على مزيد من التفاصيل.

أهلية المقياس

استنادًا إلى معايير الأهلية، قد يكون مصدر أو عنوان URL مؤهّلاً لبعض فترات جمع البيانات التي تشملها واجهة برمجة التطبيقات CrUX History API فقط. في هذه الحالات، ستعرِض CrUX History API القيمة "NaN" لكثافة histogramTimeseries والقيمة null لكثافة percentilesTimeseries لفترات الجمع التي لا تتضمّن بيانات مؤهَّلة. يرجع سبب الاختلاف إلى أنّ كثافة المخطّط التكراري تكون دائمًا أرقامًا، في حين يمكن أن تكون النسب المئوية أرقامًا أو سلاسل (تستخدِم CLS سلاسل، حتى لو كانت تبدو مثل الأرقام).

على سبيل المثال، إذا لم تتضمّن الفترة الثانية أي بيانات مؤهّلة، سيظهر ذلك على النحو التالي:

{
  "histogramTimeseries": [
    {
      "start": 0,
      "end": 2500,
      "densities": [0.9190, "NaN", 0.9194, 0.9195, 0.9183, 0.9187]
    },
    {
      "start": 2500,
      "end": 4000,
      "densities": [0.0521, "NaN", 0.0518, 0.0518, 0.0526, 0.0527]
    },
    {
      "start": 4000,
      "densities": [0.0288, "NaN", 0.0286, 0.0285, 0.0290, 0.0285]
    }
  ],
  "percentilesTimeseries": {
    "p75s": [1362, null, 1344, 1356, 1366, 1377]
  },
}

بالنسبة إلى عناوين URL أو مصادر البيانات التي تصبح مؤهّلة أو غير مؤهّلة بمرور الوقت، قد تلاحظ العديد من الإدخالات غير المتوفّرة.

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

تحتوي واجهة برمجة التطبيقات CrUX History API على عنصر collectionPeriods يتضمّن صفيفًا من حقلَي firstDate وendDate يمثّلان تاريخَي بدء وانتهاء كل فترة تجميع. على سبيل المثال:

    "collectionPeriods": [{
        "firstDate": { "year": 2022, "month": 7, "day": 10 },
        "lastDate": { "year": 2022, "month": 8, "day": 6 }
      }, {
        "firstDate": { "year": 2022, "month": 7, "day": 17 },
        "lastDate": { "year": 2022, "month": 8, "day": 13 }
      }, {
        "firstDate": { "year": 2022, "month": 7, "day": 24 },
        "lastDate": { "year": 2022, "month": 8, "day": 20 }
      }, {
        "firstDate": { "year": 2022, "month": 7, "day": 31 },
        "lastDate": { "year": 2022, "month": 8, "day": 27 }
      }, {
        "firstDate": { "year": 2022, "month": 8, "day": 7 },
        "lastDate": { "year": 2022, "month": 9, "day": 3 }
      }, {
        "firstDate": { "year": 2022, "month": 8, "day": 14 },
        "lastDate": { "year": 2022, "month": 9, "day": 10 }
      }
    ]

يتم ترتيب فترات الجمع هذه بترتيب تصاعدي، وهي تمثّل النطاق الزمني لكل نقطة بيانات في الأقسام الأخرى من الاستجابة.

يتم تعديل History API كل يوم اثنين، وتتضمّن البيانات حتى يوم السبت السابق (وفقًا للتأخّر العادي الذي يبلغ يومَين). يحتوي على بيانات آخر 40 أسبوعًا، أي فترة جمع واحدة في الأسبوع. يتم تلقائيًا عرض 25 فترة جمع. ويمكن تغيير ذلك من خلال ضبط "collectionPeriodCount" في الطلب على رقم بين 1 و40.

بما أنّ كل فترة جمع بيانات تحتوي على البيانات المجمّعة لآخر 28 يومًا، وبما أنّ فترات جمع البيانات تكون أسبوعية، يعني ذلك أنّ فترات جمع البيانات ستتداخل. وهي تشبه المتوسط المتحرك للبيانات، مع تضمين بيانات لمدة ثلاثة أسابيع في كل فترة لاحقة، واختلاف أسبوع واحد.

أمثلة على طلبات البحث

يتم إرسال طلبات البحث كعناصر JSON باستخدام طلب POST إلى https://chromeuxreport.googleapis.com/v1/records:queryHistoryRecord?key=[YOUR_API_KEY]" مع بيانات طلب البحث كعنصر JSON في نص POST.

يُرجى ملاحظة استخدام queryHistoryRecord بدلاً من queryRecord في واجهة برمجة التطبيقات اليومية لخدمة CrUX API.

في ما يلي مثال على نص الطلب:

{
  "origin": "https://example.com",
  "formFactor": "PHONE",
  "metrics": [
    "largest_contentful_paint",
    "experimental_time_to_first_byte"
  ]
}

على سبيل المثال، يمكن استدعاء هذا الإجراء من curl باستخدام سطر الأوامر التالي (مع استبدال API_KEY بمفتاحك):

curl -s --request POST 'https://chromeuxreport.googleapis.com/v1/records:queryHistoryRecord?key=API_KEY' \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --data '{"formFactor":"PHONE","origin":"https://www.example.com","metrics":["largest_contentful_paint", "experimental_time_to_first_byte"]}'

تتوفّر البيانات على مستوى الصفحة من خلال واجهة برمجة التطبيقات عن طريق تمرير موقع url في طلب البحث بدلاً من origin:

{
  "url": "https://example.com/page",
  "formFactor": "PHONE",
  "metrics": [
    "largest_contentful_paint",
    "experimental_time_to_first_byte"
  ]
}

في حال عدم ضبط السمة metrics، سيتم عرض جميع المقاييس المتاحة:

• cumulative_layout_shift
• first_contentful_paint
• interaction_to_next_paint
• largest_contentful_paint
• experimental_time_to_first_byte
• largest_contentful_paint_resource_type
• largest_contentful_paint_image_time_to_first_byte
• largest_contentful_paint_image_resource_load_delay
• largest_contentful_paint_image_resource_load_duration
• largest_contentful_paint_image_element_render_delay
• navigation_types
• round_trip_time
• form_factors (لا يتم الإبلاغ عنها إلا إذا لم يتم تحديد formFactor في الطلب)

في حال عدم تقديم قيمة formFactor، سيتم تجميع القيم على مستوى جميع أشكال الأجهزة.

اطّلِع على دليل استخدام واجهة برمجة التطبيقات CrUX History API للاطّلاع على المزيد من أمثلة طلبات البحث.

مسار البيانات

تتم معالجة مجموعة بيانات CrUX من خلال مسار عمل لتوحيد البيانات وجمعها وفلترها قبل أن تصبح متاحة من خلال واجهة برمجة التطبيقات.

المتوسط المتحرك

البيانات الواردة في تقرير تجربة المستخدِم في Chrome هي متوسط متحرك للأرباح خلال 28 يومًا من المقاييس المجمّعة. وهذا يعني أنّ البيانات المعروضة في "تقرير تجربة المستخدم في Chrome" في أي وقت هي في الواقع بيانات آخر 28 يومًا مجمّعة معًا.

تحتوي History API على عدد من فترات الجمع، التي تمتد كلّ منها على مدار هذه الأيام الـ 28. بما أنّ كل فترة جمع بيانات تحتوي على البيانات المجمّعة لآخر 28 يومًا، وبما أنّ فترات جمع البيانات تكون أسبوعية، يعني ذلك أنّ فترات جمع البيانات ستتداخل. وهي تشبه المتوسط المتحرك للبيانات، مع تضمين بيانات لمدة ثلاثة أسابيع في كل فترة لاحقة، واختلاف أسبوع واحد.

التحديثات الأسبوعية

يتم تعديل History API كل يوم اثنين في الساعة 4:00 صباحًا بالتوقيت العالمي المنسق تقريبًا، ويتضمّن البيانات حتى يوم السبت السابق (وفقًا للتأخّر العادي الذي يبلغ يومَين). يحتوي على بيانات 40 أسبوعًا سابقة (10 أشهر تقريبًا)، أي فترة جمع واحدة في الأسبوع. يُرجى العِلم أنّنا نعرض تلقائيًا 25 إدخالًا لكل سلسلة زمنية، ولكن يمكن إلغاء ذلك من خلال تحديد مَعلمة الطلب collectionPeriodCount.

لا تتوفّر اتفاقية مستوى خدمة لأوقات التحديث، ويتم تنفيذها يوميًا على أساس أقصى جهد ممكن.

المخطط

تتوفّر نقطة نهاية واحدة لواجهة برمجة التطبيقات CrUX History API تقبل طلبات HTTP من النوع POST. تعرِض واجهة برمجة التطبيقات record يحتوي على metrics واحد أو أكثر يتوافق مع بيانات الأداء حول المصدر أو الصفحة المطلوبة.

طلب HTTP

POST https://chromeuxreport.googleapis.com/v1/records:queryHistoryRecord

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

نص الطلب

تستخدم واجهة برمجة التطبيقات CrUX History API نصّ طلب مشابهًا لـ واجهة برمجة التطبيقات اليومية CrUX API، مع إضافة حقل "collectionPeriodCount" اختياري واحد:

{
  "formFactor": enum (FormFactor),
  "metrics": [
    string
  ],

  // Union field url_pattern can be only one of the following:
  "origin": string,
  "url": string,
  // End of list of possible types for union field url_pattern.

  "collectionPeriodCount": int32 // Optional: Number of periods to collect
}

على سبيل المثال، لطلب قيم سرعة عرض أكبر محتوى مرئي على الكمبيوتر المكتبي للصفحة الرئيسية على web.dev:

{
  "url": "https://web.dev/",
  "formFactor": "DESKTOP",
  "metrics": [
    "largest_contentful_paint"
  ]
}

يتضمّن هذا الطلب المشابه الحقل الاختياري collectionPeriodCount وسيؤدي إلى عرض 40 إدخالًا للسلسلة الزمنية يقدّمون سجلّ أداء الويب على مدار 10 أشهر تقريبًا لمصدر https://web.dev:

{
  "url": "https://web.dev/",
  "formFactor": "DESKTOP",
  "metrics": [
    "largest_contentful_paint"
  ],
  "collectionPeriodCount": 40
}

نص الاستجابة

تعرِض الطلبات الناجحة ردودًا تتضمّن عنصر record وurlNormalizationDetails بالبنية التالية:

{
  "record": {
    "key": {
      object (Key)
    },
    "metrics": [
      string: {
        object (Metric)
      }
    ]
  },
  "urlNormalizationDetails": {
    object (UrlNormalization)
  }
}

على سبيل المثال، يمكن أن يكون الردّ على نص الطلب في الطلب السابق على النحو التالي:

{
  "record": {
    "key": {
      "origin": "https://web.dev"
    },
    "metrics": {
      "largest_contentful_paint": {
        "histogramTimeseries": [{
            "start": 0, "end": 2500, "densities": [
              0.9190, 0.9203, 0.9194, 0.9195, 0.9183, 0.9187, ...
            ]
          }, {
            "start": 2500, "end": 4000, "densities": [
              0.0521, 0.0513, 0.0518, 0.0518, 0.0526, 0.0527, ...
            ]
          },  {
            "start": 4000, "densities": [
              0.0288, 0.0282, 0.0286, 0.0285, 0.0290, 0.0285, ...
            ]
          }
        ],
        "percentilesTimeseries": {
          "p75s": [
            1362, 1352, 1344, 1356, 1366, 1377, ...
          ]
        }
      }
    },
    "collectionPeriods": [{
        "firstDate": { "year": 2022, "month": 7, "day": 10 },
        "lastDate": { "year": 2022, "month": 8, "day": 6 }
      }, {
        "firstDate": { "year": 2022, "month": 7, "day": 17 },
        "lastDate": { "year": 2022, "month": 8, "day": 13 }
      }, {
        "firstDate": { "year": 2022, "month": 7, "day": 24 },
        "lastDate": { "year": 2022, "month": 8, "day": 20 }
      }, {
        "firstDate": { "year": 2022, "month": 7, "day": 31 },
        "lastDate": { "year": 2022, "month": 8, "day": 27 }
      }, {
        "firstDate": { "year": 2022, "month": 8, "day": 7 },
        "lastDate": { "year": 2022, "month": 9, "day": 3 }
      }, {
        "firstDate": { "year": 2022, "month": 8, "day": 14 },
        "lastDate": { "year": 2022, "month": 9, "day": 10 }
      }, {
        ...
      }
    ]
  }
}

المفتاح

تحدِّد Key جميع السمات التي تحدِّد هذا السجلّ على أنّه فريد.

{
  "formFactor": enum (FormFactor),

  // Union field url_pattern can be only one of the following:
  "origin": string,
  "url": string
  // End of list of possible types for union field url_pattern.
}

المقاييس

metric هي مجموعة من بيانات تجربة المستخدم لمقياس أداء واحد على الويب، مثل سرعة عرض أول محتوى مرئي. يحتوي على مخطّط بياني هرمي تلخيصي لاستخدام Chrome في العالم الحقيقي على شكل سلسلة من bins.

{
  "histogramTimeseries": [
    {
      object (Bin)
    }
  ],
  "percentilesTimeseries": {
    object (Percentiles)
  }
}

أو

"fractionTimeseries": {
  object (Fractions)
}

المربع

bin هو جزء منفصل من البيانات يمتد من البداية إلى النهاية، أو إذا لم يتم تحديد نهاية، يمتد من البداية إلى ما لا نهاية.

يتمّ تقديم قيم بداية الحزمة ونهايتها في نوع قيمة المقياس الذي تمثّله. على سبيل المثال، يتم قياس أوّل مرّة ظهور للمحتوى بالملي ثانية ويتم عرضها كأرقام صحيحة، وبالتالي ستستخدم حِزم المقاييس أرقامًا صحيحة من النوع int32 لأنواع البدء والانتهاء. ومع ذلك، يتم قياس "تغيُّر المخطّط الإعلاني التراكمي" بقيم عشرية بدون وحدات ويتم عرضه كقيمة عشرية مُشفَّرة كسلسلة، وبالتالي ستستخدم حِزم المقاييس سلاسل لنوع القيمة.

{
  "start": value,
  "end": value,
  "densities": [number, number, number...etc.]
}

النِسب المئوية

يحتوي Percentiles على قيم اصطناعية لمقياس بنسبة مئوية إحصائية معيّنة. وتُستخدَم هذه المقاييس لتقدير قيمة مقياس معيّن استنادًا إلى نسبة مئوية من المستخدِمين من إجمالي عدد المستخدِمين.

{
  "P75": value
}

الكسور

يحتوي العمود Fractions على سلسلة زمنية من الكسور المُصنَّفة التي تضيف ما يصل إلى 1 تقريبًا لكل إدخال. يصف كل تصنيف عملية تحميل صفحة بطريقة ما، لذا يمكن اعتبار المقاييس التي يتم تمثيلها بهذه الطريقة أنّها تُنتج قيمًا مميزة بدلاً من القيم الرقمية، وتُعبّر الكسور عن معدّل تكرار قياس قيمة مميزة معيّنة.

{
  "label_1": { "fractions": array[fraction]},
  "label_1": { "fractions": array[fraction]},
  ...
  "label_n": { "fractions": array[fraction]}
}

تمامًا مثل قيم الكثافة في سلال المخطّط البياني التكراري، كل fraction هو عدد 0.0 <= value <= 1.0، ويكون مجموعها 1.0 تقريبًا. عندما لا يكون المقياس متاحًا للفترة المحدّدة لجمع البيانات، سيكون الإدخال المقابل هو "NaN" في جميع صفائف الكسور.

UrlNormalization

عنصر يمثّل إجراءات التطبيع التي تم اتّخاذها لتطبيع عنوان URL من أجل زيادة فرص البحث الناجح. هذه تغييرات أساسية ومبرمَجة يتم إجراؤها عند البحث عن url_pattern المقدَّمة والتي من المعلوم أنّها ستتعذّر. لا تتم معالجة الإجراءات المعقدة، مثل متابعة عمليات إعادة التوجيه.

{
  "originalUrl": string,
  "normalizedUrl": string
}

حدود معدّل الاستخدام

تشترك واجهة برمجة التطبيقات CrUX History API في الحد الأقصى نفسه مع واجهة برمجة التطبيقات CrUX API، وهو 150 طلب بحث في الدقيقة لكل مشروع على Google Cloud لواجهة برمجة التطبيقات هذه أو تلك، والتي يتم تقديمها بدون أي رسوم. يمكنك الاطّلاع على هذا الحدّ الأقصى واستخدامك الحالي في Google Cloud Console. من المفترض أن تكون هذه الحصة الكبيرة كافية لمعظم حالات الاستخدام، ولا يمكن الدفع مقابل حصة أكبر.