Nội dung cập nhật về API của Search Console

Thứ Tư, ngày 9 tháng 12 năm 2020

Vài tháng trước, chúng tôi đã thông báo về việc nâng cấp cơ sở hạ tầng API để cải thiện hiệu suất của Search Console API khi nhu cầu gia tăng. Hôm nay, chúng tôi rất vui mừng được thông báo về một số nội dung cập nhật khác sắp ra mắt:

  • Bổ sung dữ liệu mới cập nhật và bộ lọc tin tức trong Search Console API
  • Hỗ trợ tài nguyên miền trong Sitemaps API
  • Hướng dẫn cách di chuyển tài liệu khám phá

Nếu bạn tự thực hiện lệnh gọi đối với API này, hãy đọc tiếp.

Dữ liệu mới cập nhật và bộ lọc tin tức trong Search Console API

Báo cáo hiệu suất hiện có thể cho thấy dữ liệu mới cập nhật trong vòng chưa đến một ngày. Giờ đây bạn có thể truy cập vào những dữ liệu như vậy thông qua API chuyển thông số yêu cầu dataState với giá trị được đặt thành all. Dữ liệu bạn thu được cho giá trị này sẽ bao gồm cả dữ liệu mới cập nhật (chưa phải dữ liệu chính thức). Nếu chỉ muốn nhận dữ liệu chính thức, bạn có thể chuyển thông số này với giá trị được đặt thành final, hoặc cũng có thể không chuyển và chỉ nhận dữ liệu chính thức theo mặc định.

Vài tháng trước, chúng tôi đã thêm một thẻ Tin tức vào bộ lọc Tìm kiếm trong Báo cáo hiệu suất. Thẻ này hiện cũng có trong API và bạn có thể truy cập bằng cách đặt giá trị của thông số searchType trong yêu cầu thành news.

Hỗ trợ tài nguyên miền trong Sitemaps API

Như các API khác của Search Console, Sitemaps API hiện cũng hỗ trợ các tài nguyên miền. Bạn có thể truy vấn, thêm và xoá sơ đồ trang web của mình trên các tài nguyên miền, ví dụ như:

GET https://www.googleapis.com/webmasters/v3/sites/sc-domain:example.com/sitemaps

Di chuyển tài liệu khám phá

Chúng tôi sẽ ngừng hỗ trợ tài liệu khám phá của Webmasters API. Nếu bạn đang dùng một thư viện API bên ngoài để truy vấn Search Console API hoặc trực tiếp truy vấn tài liệu khám phá của Webmasters API, thì bạn cần cập nhật các lệnh gọi API để bổ sung những thay đổi sau.

Thay đổi đối với thư viện API

Để biết thông tin cập nhật về những thay đổi đối với thư viện API, hãy tham khảo hướng dẫn nhanh về Java và Python để xem hướng dẫn sử dụng mới cho API.

Java

Trong mọi lượt nhập liên quan đến dịch vụ của Webmasters API, hãy thay đổi gói webmasters thành gói searchconsole.v1, và thay đổi tên dịch vụ từ Webmasters thành SearchConsole. Ví dụ:

  • Nhập dịch vụ API:

    import com.google.api.services.webmasters.Webmasters;

    import com.google.api.services.searchconsole.v1.SearchConsole;

  • Nhập một đối tượng phản hồi:

    import com.google.api.services.webmasters.model.WmxSite;

    import com.google.api.services.searchconsole.v1.model.WmxSite;

Lưu ý rằng ngoài đối tượng dịch vụ, các đối tượng API khác vẫn giữ nguyên như trước (chỉ có gói thay đổi).

Python

Khi xây dựng đối tượng dịch vụ Webmasters, hãy thực hiện thay đổi sau:

webmasters_service = build('webmasters', 'v3', http=http)

webmasters_service = build('searchconsole', 'v1', http=http)

Xin nhắc lại, hành vi của các đối tượng không thay đổi.

Truy vấn trực tiếp tài liệu khám phá

Sau đây là những thay đổi đối với hoạt động truy vấn tài liệu khám phá:

  • Thay đổi URL

    https://www.googleapis.com/discovery/v1/apis/webmasters/v3/rest

    https://searchconsole.googleapis.com/$discovery/rest

  • Thay đổi nội dung
    • Trường name đã thay đổi từ webmasters thành searchconsole.
    • Trường version đã thay đổi từ v3 thành v1.

Nếu có thắc mắc, bạn có thể hỏi trong cộng đồng của Trung tâm Tìm kiếm hoặc trên Twitter.

Người đăng: Nati Yosephian, Gilad Amar và Michael Huzman, nhóm Search Console