API lịch sử CrUX

API Lịch sử CrUX cho phép bạn truy cập vào dữ liệu trước đây về trải nghiệm người dùng thực tế trong 6 tháng với độ trễ thấp ở mức độ chi tiết của trang và nguồn gốc.

Hãy làm thử!

Trường hợp sử dụng phổ biến

API Lịch sử CrUX cho phép truy vấn các chỉ số trước đây về trải nghiệm người dùng cho một URI cụ thể, chẳng hạn như "Xem xu hướng trải nghiệm người dùng trước đây cho nguồn gốc https://example.com".

API Lịch sử có cấu trúc tương tự như API CrUX hằng ngày, ngoại trừ việc các giá trị được cung cấp trong một mảng còn các khoá được gắn nhãn bằng tên số nhiều (ví dụ: histogramTimeseries thay vì histogram hoặc p75s thay vì p75).

Khoá API CrUX

Giống như API hằng ngày, việc sử dụng API nhật ký CrUX yêu cầu một khoá API Google Cloud được cấp để sử dụng Chrome UX Report API. Bạn có thể dùng cùng một khoá cho API nhật ký và API nhật ký.

Nhận và sử dụng khoá API

Mua khoá

Hoặc tạo một mã trong trang Thông tin đăng nhập.

Sau khi bạn có khoá API, ứng dụng của bạn có thể thêm tham số truy vấn key=yourAPIKey vào tất cả URL yêu cầu.

Khoá API này an toàn khi nhúng trong URL; nó không cần bất kỳ phương thức mã hoá nào.

Xem phần Truy vấn mẫu.

Mô hình dữ liệu

Phần này trình bày chi tiết cấu trúc của dữ liệu trong yêu cầu và phản hồi.

Ghi âm

Một phần thông tin riêng biệt về một trang hoặc trang web. Một bản ghi có thể có dữ liệu dành riêng cho một giá trị nhận dạng và cho một tổ hợp phương diện cụ thể. Một bản ghi có thể chứa dữ liệu của một hoặc nhiều chỉ số.

Giá trị nhận dạng

Giá trị nhận dạng chỉ định bản ghi nào cần được tra cứu. Trong CrUX, các giá trị nhận dạng này là trang web.

Điểm gốc

Khi giá trị nhận dạng là một nguồn gốc, tất cả dữ liệu hiện có cho tất cả các trang trong nguồn gốc đó sẽ được tổng hợp lại với nhau. Ví dụ: giả sử nguồn gốc http://www.example.com có các trang được bố trí theo sơ đồ trang web này:

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

Điều này có nghĩa là khi truy vấn Báo cáo trải nghiệm người dùng trên Chrome có nguồn gốc được đặt thành http://www.example.com, dữ liệu cho http://www.example.com/, http://www.example.com/foo.htmlhttp://www.example.com/bar.html sẽ được trả về và tổng hợp với nhau vì đó là tất cả các trang thuộc nguồn gốc đó.

URL

Khi giá trị nhận dạng là một URL, chỉ có dữ liệu cho URL cụ thể đó được trả về. Xem lại sơ đồ trang web gốc http://www.example.com:

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

Nếu mã nhận dạng được đặt thành URL có giá trị là http://www.example.com/foo.html, thì chỉ có dữ liệu cho trang đó được trả về.

Kích thước

Phương diện xác định một nhóm dữ liệu cụ thể để tổng hợp một bản ghi. Ví dụ: hệ số hình dạng PHONE cho biết bản ghi chứa thông tin về những lần tải diễn ra trên thiết bị di động.

Hệ thống chỉ tổng hợp được CrUX History API theo phương diện kiểu dáng thiết bị. Đây là một lớp chung của thiết bị được chia thành PHONE, TABLETDESKTOP.

Chỉ số

Chúng tôi báo cáo các chỉ số theo chuỗi thời gian của các tổng hợp thống kê, chẳng hạn như biểu đồ, phân vị, và phân số.

Các biểu đồ

Khi các chỉ số được biểu thị trong một mảng biểu đồ, thì mỗi mục nhập của chuỗi thời gian sẽ đại diện cho tỷ lệ phần trăm những lần tải trang mà chỉ số nằm trong một khoảng thời gian tương ứng với tất cả. Các điểm dữ liệu được trình bày theo thứ tự ngày trong thời gian thu thập mà API cũng trả về, với điểm đầu tiên là khoảng thời gian sớm nhất và điểm cuối cùng là giai đoạn thu thập gần đây nhất.

Biểu đồ 3 thùng cho một chỉ số mẫu có dạng như sau:

{
  "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]
    }
  ],
}

Dữ liệu này chỉ ra rằng 91,90% lượt tải trang gặp phải giá trị chỉ số mẫu trong khoảng từ 0 mili giây đến 2.500 mili giây trong khoảng thời gian thu thập đầu tiên trong lịch sử, tiếp theo là 92,03%, 91,94%... Các đơn vị của chỉ số không có trong biểu đồ này, trong trường hợp này, chúng tôi sẽ giả định là mili giây.

Ngoài ra, 5,21% lượt tải trang có giá trị chỉ số mẫu từ 2.500 mili giây đến 4.000 mili giây trong giai đoạn thu thập đầu tiên trong lịch sử và 2,88% lượt tải trang có giá trị lớn hơn 4.000 mili giây trong khoảng thời gian thu thập đầu tiên trong lịch sử.

Phân vị

Các chỉ số cũng có thể chứa chuỗi thời gian của phân vị có thể hữu ích cho việc phân tích bổ sung.

Các điểm dữ liệu được trình bày theo thứ tự ngày trong thời gian thu thập mà API cũng trả về, với điểm đầu tiên là khoảng thời gian sớm nhất và điểm cuối cùng là giai đoạn thu thập gần đây nhất.

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

Những phân vị này có thể thể hiện các giá trị chỉ số cụ thể tại phân vị thứ nhất cho chỉ số đó. Các chỉ số này dựa trên toàn bộ dữ liệu có sẵn chứ không phải dữ liệu kết hợp cuối cùng, nên các chỉ số này không nhất thiết phải khớp với phân vị nội suy dựa trên biểu đồ liên kết cuối cùng.

Phân số

Chỉ số có thể được biểu thị dưới dạng chuỗi thời gian của các phân số được gắn nhãn; mỗi nhãn mô tả một lượt tải trang theo . Các điểm dữ liệu được trình bày theo thứ tự ngày trong thời gian thu thập mà API cũng trả về, với điểm đầu tiên là khoảng thời gian sớm nhất và điểm cuối cùng là giai đoạn thu thập gần đây nhất.

Ví dụ:

{    
  "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]}
  }
}

Trong ví dụ này, điểm dữ liệu gần đây nhất cho thấy 14,21% lượt tải trang đến từ máy tính và 82,88% đến từ điện thoại.

Loại giá trị chỉ số

Vì API Nhật ký CrUX sử dụng cùng loại giá trị chỉ số, nên bạn có thể tham khảo tài liệu về các loại giá trị chỉ số API CrUX hằng ngày để biết thêm thông tin chi tiết.

Điều kiện sử dụng chỉ số

Dựa trên các tiêu chí, một nguồn gốc hoặc URL chỉ có thể đủ điều kiện cho một số khoảng thời gian thu thập thuộc phạm vi của API Nhật ký CrUX. Trong những trường hợp này, CrUX History API sẽ trả về "NaN" cho mật độ histogramTimeseriesnull cho percentilesTimeseries cho các giai đoạn thu thập không có dữ liệu đủ điều kiện. Nguyên nhân là do mật độ của biểu đồ luôn ở dạng số, trong khi phân vị có thể là số hoặc chuỗi (CLS sử dụng chuỗi, ngay cả khi các phân vị đó trông giống số).

Ví dụ: nếu không có dữ liệu đủ điều kiện cho kỳ thứ hai, thì dữ liệu sẽ được thể hiện như sau:

{
  "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]
  },
}

Đối với các URL hoặc nguồn gốc ngày càng không đủ điều kiện, bạn có thể nhận thấy nhiều mục nhập bị thiếu.

Thời gian thu thập

API nhật ký CrUX chứa đối tượng collectionPeriods có một mảng các trường firstDateendDate đại diện cho ngày bắt đầu và ngày kết thúc của từng cửa sổ tổng hợp. Ví dụ:

    "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 }
      }
    ]

Các khoảng thời gian thu thập này được sắp xếp theo thứ tự tăng dần và thể hiện khoảng thời gian của từng điểm dữ liệu trong các phần khác của phản hồi.

API Lịch sử được cập nhật vào thứ Hai hằng tuần và chứa dữ liệu cho đến thứ Bảy tuần trước (theo độ trễ 2 ngày tiêu chuẩn). Trang này chứa dữ liệu của 25 tuần trước đó (một khoảng thời gian thu thập mỗi tuần).

Vì mỗi kỳ thu thập chứa dữ liệu tổng hợp của 28 ngày trước đó và các kỳ thu thập đều được tính mỗi tuần, nên điều này có nghĩa là các kỳ thu thập sẽ trùng lặp. Chúng tương tự như giá trị trung bình động của dữ liệu, trong đó dữ liệu của 3 tuần được đưa vào mỗi khoảng thời gian tiếp theo, còn 1 tuần thì khác.

Cụm từ tìm kiếm mẫu

Các truy vấn được gửi dưới dạng đối tượng JSON bằng cách sử dụng yêu cầu POST tới https://chromeuxreport.googleapis.com/v1/records:queryHistoryRecord?key=[YOUR_API_KEY]" với dữ liệu truy vấn dưới dạng đối tượng JSON trong phần nội dung POST.

Vui lòng lưu ý việc sử dụng queryHistoryRecord thay thế queryRecord của API CrUX hằng ngày.

Ví dụ về nội dung:

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

Ví dụ: bạn có thể gọi lệnh này từ curl bằng dòng lệnh sau (thay thế API_KEY bằng khoá của bạn):

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"]}'

Bạn có thể truy cập dữ liệu cấp trang thông qua API bằng cách truyền thuộc tính url trong truy vấn thay vì origin:

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

Nếu bạn không đặt thuộc tính metrics thì tất cả các chỉ số có sẵn sẽ được trả về:

  • cumulative_layout_shift
  • first_contentful_paint
  • interaction_to_next_paint
  • largest_contentful_paint
  • experimental_time_to_first_byte
  • navigation_types
  • round_trip_time
  • form_factors (chỉ được báo cáo nếu không có formFactor nào được chỉ định trong yêu cầu)

Nếu bạn không cung cấp giá trị formFactor, thì các giá trị sẽ được tổng hợp trên tất cả hệ số hình dạng.

Hãy xem hướng dẫn Sử dụng CrUX History API để biết thêm các truy vấn mẫu.

Quy trình dữ liệu

Tập dữ liệu CrUX được xử lý thông qua một quy trình để hợp nhất, tổng hợp và lọc dữ liệu trước khi được cung cấp thông qua API.

Trung bình luân phiên

Dữ liệu trong Báo cáo trải nghiệm người dùng trên Chrome là số liệu trung bình luân phiên trong 28 ngày của các chỉ số tổng hợp. Tức là dữ liệu được trình bày trong Báo cáo trải nghiệm người dùng trên Chrome tại một thời điểm bất kỳ thực ra là dữ liệu trong 28 ngày qua được tổng hợp lại với nhau.

API Lịch sử chứa một số khoảng thời gian thu thập, mỗi khoảng thời gian kéo dài 28 ngày. Vì mỗi kỳ thu thập chứa dữ liệu tổng hợp của 28 ngày trước đó và các kỳ thu thập đều được tính mỗi tuần, nên điều này có nghĩa là các kỳ thu thập sẽ trùng lặp. Chúng tương tự như giá trị trung bình động của dữ liệu, trong đó dữ liệu của 3 tuần được đưa vào mỗi khoảng thời gian tiếp theo, còn 1 tuần thì khác.

Thông tin cập nhật hằng tuần

History API được cập nhật vào mỗi thứ Hai lúc khoảng 04:00 (giờ UTC) và chứa dữ liệu cho đến thứ Bảy trước đó (theo độ trễ tiêu chuẩn là 2 ngày). Trang này chứa dữ liệu của 25 tuần trước đó (khoảng 6 tháng), một khoảng thời gian thu thập mỗi tuần.

Không có thoả thuận mức độ cung cấp dịch vụ về thời gian cập nhật; chương trình đó sẽ được chạy trên cơ sở nỗ lực tối đa mỗi ngày.

Lược đồ

Có một điểm cuối duy nhất cho CrUX History API chấp nhận các yêu cầu HTTP POST. API trả về một record chứa một hoặc nhiều metrics tương ứng với dữ liệu hiệu suất về nguồn hoặc trang được yêu cầu.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

CrUX History API sử dụng các nội dung yêu cầu tương tự như API CrUX hằng ngày, ngoại trừ việc không hỗ trợ trường yêu cầu effectiveConnectionType.

Ví dụ: để yêu cầu giá trị Nội dung lớn nhất hiển thị trên máy tính cho trang chủ web.dev:

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

Nội dung phản hồi

Các yêu cầu thành công sẽ trả về các phản hồi có đối tượng recordurlNormalizationDetails trong cấu trúc sau:

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

Ví dụ: phản hồi cho nội dung yêu cầu trong yêu cầu trước có thể là:

{
  "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 }
      }, {
        ...
      }
    ]
  }
}

Khoá

Key định nghĩa mọi phương diện xác định bản ghi này là duy nhất.

{
  "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.
}
Trường
formFactor

enum (FormFactor)

Kiểu dáng là loại thiết bị mà tất cả người dùng dùng để truy cập vào trang web cho bản ghi này.

Nếu bạn chưa chỉ định hệ số hình dạng này, thì dữ liệu tổng hợp cho tất cả các hệ số hình dạng sẽ được trả về.

Trường kết hợp url_pattern. Mẫu URL là URL áp dụng bản ghi. url_pattern chỉ có thể là một trong những trạng thái sau đây:
origin

string

Nguồn gốc chỉ định nguồn gốc của bản ghi này.

Lưu ý: Khi chỉ định một nguồn gốc, dữ liệu cho các lượt tải theo nguồn gốc này trên tất cả các trang sẽ được tổng hợp thành dữ liệu về trải nghiệm người dùng ở cấp nguồn gốc.

url

string

url chỉ định một URL cụ thể chứa bản ghi này.

Lưu ý: Khi bạn chỉ định một url, dữ liệu chỉ được tổng hợp cho URL cụ thể đó.

Chỉ số

metric là tập hợp dữ liệu về trải nghiệm người dùng cho một chỉ số hiệu suất web, chẳng hạn như nội dung hiển thị đầu tiên. Tệp này chứa biểu đồ tóm tắt về mức sử dụng Chrome trong thực tế dưới dạng một chuỗi bins.

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

hoặc

"fractionTimeseries": {
  object (Fractions)
}
Trường
histogramTimeseries[]

object (Bin)

Biểu đồ chuỗi thời gian về trải nghiệm người dùng cho một chỉ số. Biểu đồ chuỗi thời gian sẽ có ít nhất một thùng và mật độ của tất cả các thùng sẽ cộng lại tối đa là ~1.

Các giá trị bị thiếu cho Giai đoạn thu thập cụ thể đó sẽ được đánh dấu là "NaN".

percentilesTimeseries

object (Percentiles)

Phân vị hữu ích phổ biến của Chỉ số. Loại giá trị cho phân vị sẽ giống với loại giá trị được cung cấp cho các thùng Biểu đồ.

Các giá trị bị thiếu cho Khoảng thời gian thu thập dữ liệu cụ thể đó sẽ được đánh dấu là null.

fractionTimeseries

object (Fractions)

Đối tượng này chứa chuỗi thời gian gồm các phân số được gắn nhãn, cộng lại tối đa ~1 cho mỗi mục nhập.

Phân số được làm tròn đến 4 chữ số thập phân.

Các mục bị thiếu được biểu thị là "NaN" trên tất cả các phân số.

Thùng

bin là một phần dữ liệu riêng biệt kéo dài từ đầu đến cuối hoặc nếu không có điểm kết thúc nào được gán từ đầu đến vô hạn dương.

Giá trị bắt đầu và kết thúc của thùng được cung cấp dưới dạng loại giá trị của chỉ số mà nó đại diện. Ví dụ: lượt vẽ nội dung đầu tiên được đo bằng mili giây và hiển thị dưới dạng int, do đó, các bộ chứa chỉ số sẽ sử dụng int32 cho các loại bắt đầu và kết thúc. Tuy nhiên, thay đổi bố cục tích luỹ được đo bằng số thập phân không đơn vị và được biểu thị dưới dạng số thập phân được mã hoá dưới dạng chuỗi, do đó, thùng chỉ số sẽ sử dụng chuỗi cho loại giá trị.

{
  "start": value,
  "end": value,
  "densities": [number, number, number...etc.]
}
Trường
start

(integer | string)

Bắt đầu là điểm bắt đầu của thùng dữ liệu.

end

(integer | string)

Đây là điểm kết thúc của thùng dữ liệu. Nếu điểm cuối không được điền, thì thùng rác sẽ không có điểm kết thúc và có hiệu lực từ đầu đến +inf.

densities

array[number]

Một chuỗi thời gian tỷ lệ người dùng đã gặp phải giá trị của thùng này cho chỉ số đã cho.

Mật độ được làm tròn đến 4 chữ số thập phân.

Phân vị

Percentiles chứa các giá trị tổng hợp của một chỉ số ở một phân vị thống kê nhất định. Các chỉ số này được dùng để ước tính giá trị của một chỉ số theo tỷ lệ phần trăm người dùng trong tổng số người dùng.

{
  "P75": value
}
Trường
p75s

array[(integer | string)]

Chuỗi thời gian của các giá trị mà 75% lượt tải trang gặp phải chỉ số đã cho bằng hoặc thấp hơn giá trị này.

Phân số

Fractions chứa chuỗi thời gian gồm các phân số được gắn nhãn, cộng lại thành ~1 trên mỗi mục nhập. Mỗi nhãn mô tả tải trang theo một cách nào đó, do đó, các chỉ số được thể hiện theo cách này có thể được coi là tạo ra các giá trị riêng biệt thay vì giá trị số và phân số cho biết tần suất đo lường một giá trị riêng biệt cụ thể.

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

Giống như các giá trị mật độ trong thùng biểu đồ, mỗi fraction là một số 0.0 <= value <= 1.0 và tổng cộng bằng 1.0. Khi không có chỉ số này cho một khoảng thời gian thu thập cụ thể thì mục nhập tương ứng sẽ là "NaN" trong tất cả các mảng phân số.

Trường
p75s

array[(integer | string)]

Chuỗi thời gian của các giá trị mà 75% lượt tải trang gặp phải chỉ số đã cho bằng hoặc thấp hơn giá trị này.

UrlNormalization

Đối tượng đại diện cho các hành động chuẩn hoá được thực hiện để chuẩn hoá một URL nhằm đạt được khả năng tra cứu thành công cao hơn. Đây là những thay đổi tự động đơn giản được thực hiện khi tra cứu url_pattern được cung cấp sẽ được xác định là không thành công. Những thao tác phức tạp như chuyển hướng sau đây sẽ không được xử lý.

{
  "originalUrl": string,
  "normalizedUrl": string
}
Trường
originalUrl

string

URL được yêu cầu ban đầu trước khi có bất kỳ hành động chuẩn hoá nào.

normalizedUrl

string

URL sau khi có hành động chuẩn hoá. Đây là URL trải nghiệm người dùng hợp lệ và có thể được tra cứu một cách hợp lý.

Giới hạn số lượng yêu cầu

CrUX History API có cùng hạn mức với CrUX API đối với 150 lượt truy vấn mỗi phút trên mỗi dự án Google Cloud đối với một trong hai API được cung cấp miễn phí. Bạn có thể xem hạn mức này và mức sử dụng hiện tại của mình trong Google Cloud Console. Hạn mức hào phóng này sẽ đủ cho phần lớn các trường hợp sử dụng và sẽ không thể chi trả cho hạn mức tăng.