Skip to content
Artwork for TaiNguyenSeo
TaiNguyenSeo · November 11 · 1 min

Lấy dữ liệu Search Console bằng Python, đọc đúng trước khi lập lịch

Nhiều anh em làm SEO muốn bỏ thao tác xuất bảng thủ công từ Google Search Console. Ý định đó hợp lý. Nhưng nếu chưa chốt cần lấy truy vấn hay trạng thái URL thì chưa nên lập lịch. Chuyển một câu hỏi mơ hồ sang Python chỉ khiến máy chăm chỉ trả lời sai việc. Bản đầy đủ nằm trong hướng dẫn dùng Google Search Console API cho báo cáo SEO. Chọn dữ liệu theo câu hỏi cần trả lời. Lấy được dữ liệu chưa đồng nghĩa với có báo cáo hữu ích. Nhiều bảng gom rất đầy mà người xem vẫn không biết cần sửa trang nào. Muốn biết truy vấn nào mang lượt nhấp về một trang, hãy chọn Search Analytics và xác định cách nhóm dữ liệu. Muốn biết Google ghi nhận trạng thái index của một địa chỉ ra sao, hãy chuyển sang URL Inspection. Hai việc này khác nhau. Có hai điều đừng làm. Đừng dùng dữ liệu hiệu suất để kết luận trạng thái index. Cũng đừng coi API là nút ép Google lập chỉ mục, vì nó chỉ cho đọc thông tin Google đã ghi nhận. Trước khi thêm một trường dữ liệu, hãy tự hỏi bảng này dùng để quyết định việc gì. Chưa trả lời được thì chưa thêm. Kết nối bắt đầu từ một truy vấn chỉ đọc, phạm vi rõ ràng. Làm vậy dễ tách lỗi quyền khỏi lỗi dữ liệu trước khi thêm lịch chạy. Việc đầu tiên là xác định đúng property, tức phạm vi website trong Search Console. Đừng chọn theo tên hiển thị gần giống. Chọn nhầm bản tên miền với bản tiền tố địa chỉ thì truy vấn đúng vẫn lấy nhầm dữ liệu. Về xác thực có hai hướng. OAuth phù hợp khi chương trình hoạt động theo quyền của người dùng. Service account thì cần được cấp quyền trên đúng property. Tạo danh tính trong Google Cloud chưa đồng nghĩa đã được đọc website. Sau đó bật Search Console API trong dự án Google Cloud và chọn quyền chỉ đọc. Tệp xác thực nên nằm ngoài mã nguồn, không đưa vào bảng chia sẻ hay ảnh hướng dẫn. Đèn sáng chưa có nghĩa cửa đã mở. Về thư viện, google-auth xử lý xác thực, google-api-python-client gọi API, còn pandas xử lý bảng trả về. Chưa cần bảng thì chưa cần pandas. Với Search Analytics, hãy viết yêu cầu bằng lời trước. Chốt khoảng ngày, loại tìm kiếm và bộ lọc trang. Khi chuyển phản hồi thành bảng, giữ tên chiều đi cùng giá trị, nếu không các cột rất dễ bị hiểu nhầm. Phản hồi cần được kiểm tra trước khi xử lý. Hãy tách yêu cầu thất bại khỏi yêu cầu thành công nhưng không có dòng dữ liệu. Rỗng chưa phải sạch. Phản hồi rỗng không tự chứng minh website không có lượt nhấp. Cũng cần kiểm tra cách phân trang trước khi coi bảng là đầy đủ. Nên lưu kèm property, khoảng ngày, bộ lọc, chiều nhóm và thời điểm lấy dữ liệu để dựng lại đúng phép đo. Một lưu ý về vị trí trung bình. Đây là giá trị trung bình, không phải chỗ đứng cố định trong mọi lần tìm kiếm. Hãy giữ đúng nhãn chỉ số khi diễn giải. Còn mã Python thì chỉ đưa vào luồng khi cú pháp đã được xác minh bằng tài liệu chính thức và lần chạy thử. Chép được mã chưa phải lấy đúng dữ liệu. Đối chiếu kết quả trước khi báo cáo. Phép cộng đúng vẫn có thể trả lời sai câu hỏi. Trước khi so hai lần xuất, hãy rà bốn điều kiện. Một là cùng property. Hai là cùng khoảng ngày và thời điểm lấy dữ liệu. Ba là cùng loại tìm kiếm, bộ lọc và cách nhóm. Bốn là đã kiểm tra phân trang. Khớp phạm vi đã nhé. Khi kết quả lệch, đừng vội kết luận API sai. Search Console ghi nhận lượt nhấp từ kết quả tìm kiếm của Google. Google Analytics 4 đếm phiên truy cập từ mọi nguồn và quan sát hành vi trên website. Hai công cụ đo hai thứ khác nhau, nên chênh lệch giữa chúng không phải bằng chứng API lấy sai. Trạng thái index phải đi cùng URL. Một nhãn tổng hợp chưa đủ giải thích từng trang. Hãy chọn URL thuộc property có quyền truy cập, lấy kết quả Inspection rồi mở đúng URL ấy trên giao diện để đối chiếu. Giữ lại thời điểm lấy kết quả. Đúng URL trước đã. Kết quả kiểm tra phản ánh điều Google đã ghi nhận, nên không mặc nhiên là phép thử trực tiếp mọi thay đổi vừa sửa. Còn tỷ lệ index tổng hợp thì sao? Chỉ nên báo khi đã có danh sách URL đầu vào rõ ràng. Một nhóm URL tự chọn không đủ đại diện cho toàn site. Chưa xác định được tập URL cần theo dõi thì báo trạng thái từng URL trước. Bên Tài Nguyên SEO dùng API ở chế độ chỉ đọc để theo dõi các thông số như tỷ lệ index. Đó là cách theo dõi dữ liệu, không phải lời khẳng định mọi việc kiểm tra đã được tự động hóa. Chạy đúng khi thử chưa đủ để giao cho lịch tự động. Trước khi lập lịch, hãy kiểm tra quota và khả năng báo lỗi. Theo tài liệu giới hạn sử dụng của Google, Search Analytics có quota tải và quota theo nhịp gọi, còn URL Inspection có quota theo website và dự án. Đừng dùng một quy tắc chung. Tách lịch gọi giúp anh em biết phần nào đang vướng giới hạn. Mức sử dụng xem được trong thẻ quota của dự án Google API Console. Trong bản thử, hãy cố ý dùng một bộ lọc không hợp lệ để xem chương trình có báo lỗi không. Khi gặp lỗi, đừng gọi lại dồn dập. Ghi nhận nguyên nhân trước rồi mới quyết định thử lại. Lịch chạy không biết nghi ngờ. Báo cáo SEO cần giữ dấu vết kiểm tra, thay vì chỉ đến hộp thư rất đúng giờ. Muốn xem đủ các bước thì đọc thêm bài viết chi tiết về Search Console API. Bài gốc: https://tainguyenseo.com/google-search-console-api/ CÔNG TY TNHH TÀI NGUYÊN SEO Địa chỉ: BT T14-11, The Manhattan, KĐT Vinhomes Grand Park, Đường Nguyễn Xiển, Phường Long Bình, TP. Hồ Chí Minh Mã số thuế: 4202052216 Hotline: 0563 650 666 Email: tainguyenseocom@gmail.com Website: https://tainguyenseo.com/ Giọng đọc: Piper, mô hình vi_VN vais1000 (CC BY 4.0).

0:00-1:18

transcript

No transcript — this publisher did not publish one.

show notes

Nhiều anh em làm SEO muốn bỏ thao tác xuất bảng thủ công từ Google Search Console. Ý định đó hợp lý. Nhưng nếu chưa chốt cần lấy truy vấn hay trạng thái URL thì chưa nên lập lịch. Chuyển một câu hỏi mơ hồ sang Python chỉ khiến máy chăm chỉ trả lời sai việc. Bản đầy đủ nằm trong hướng dẫn dùng Google Search Console API cho báo cáo SEO.

Chọn dữ liệu theo câu hỏi cần trả lời. Lấy được dữ liệu chưa đồng nghĩa với có báo cáo hữu ích. Nhiều bảng gom rất đầy mà người xem vẫn không biết cần sửa trang nào. Muốn biết truy vấn nào mang lượt nhấp về một trang, hãy chọn Search Analytics và xác định cách nhóm dữ liệu. Muốn biết Google ghi nhận trạng thái index của một địa chỉ ra sao, hãy chuyển sang URL Inspection. Hai việc này khác nhau.

Có hai điều đừng làm. Đừng dùng dữ liệu hiệu suất để kết luận trạng thái index. Cũng đừng coi API là nút ép Google lập chỉ mục, vì nó chỉ cho đọc thông tin Google đã ghi nhận. Trước khi thêm một trường dữ liệu, hãy tự hỏi bảng này dùng để quyết định việc gì. Chưa trả lời được thì chưa thêm.

Kết nối bắt đầu từ một truy vấn chỉ đọc, phạm vi rõ ràng. Làm vậy dễ tách lỗi quyền khỏi lỗi dữ liệu trước khi thêm lịch chạy. Việc đầu tiên là xác định đúng property, tức phạm vi website trong Search Console. Đừng chọn theo tên hiển thị gần giống. Chọn nhầm bản tên miền với bản tiền tố địa chỉ thì truy vấn đúng vẫn lấy nhầm dữ liệu.

Về xác thực có hai hướng. OAuth phù hợp khi chương trình hoạt động theo quyền của người dùng. Service account thì cần được cấp quyền trên đúng property. Tạo danh tính trong Google Cloud chưa đồng nghĩa đã được đọc website. Sau đó bật Search Console API trong dự án Google Cloud và chọn quyền chỉ đọc. Tệp xác thực nên nằm ngoài mã nguồn, không đưa vào bảng chia sẻ hay ảnh hướng dẫn. Đèn sáng chưa có nghĩa cửa đã mở.

Về thư viện, google-auth xử lý xác thực, google-api-python-client gọi API, còn pandas xử lý bảng trả về. Chưa cần bảng thì chưa cần pandas. Với Search Analytics, hãy viết yêu cầu bằng lời trước. Chốt khoảng ngày, loại tìm kiếm và bộ lọc trang. Khi chuyển phản hồi thành bảng, giữ tên chiều đi cùng giá trị, nếu không các cột rất dễ bị hiểu nhầm.

Phản hồi cần được kiểm tra trước khi xử lý. Hãy tách yêu cầu thất bại khỏi yêu cầu thành công nhưng không có dòng dữ liệu. Rỗng chưa phải sạch. Phản hồi rỗng không tự chứng minh website không có lượt nhấp. Cũng cần kiểm tra cách phân trang trước khi coi bảng là đầy đủ. Nên lưu kèm property, khoảng ngày, bộ lọc, chiều nhóm và thời điểm lấy dữ liệu để dựng lại đúng phép đo.

Một lưu ý về vị trí trung bình. Đây là giá trị trung bình, không phải chỗ đứng cố định trong mọi lần tìm kiếm. Hãy giữ đúng nhãn chỉ số khi diễn giải. Còn mã Python thì chỉ đưa vào luồng khi cú pháp đã được xác minh bằng tài liệu chính thức và lần chạy thử. Chép được mã chưa phải lấy đúng dữ liệu.

Đối chiếu kết quả trước khi báo cáo. Phép cộng đúng vẫn có thể trả lời sai câu hỏi. Trước khi so hai lần xuất, hãy rà bốn điều kiện. Một là cùng property. Hai là cùng khoảng ngày và thời điểm lấy dữ liệu. Ba là cùng loại tìm kiếm, bộ lọc và cách nhóm. Bốn là đã kiểm tra phân trang. Khớp phạm vi đã nhé.

Khi kết quả lệch, đừng vội kết luận API sai. Search Console ghi nhận lượt nhấp từ kết quả tìm kiếm của Google. Google Analytics 4 đếm phiên truy cập từ mọi nguồn và quan sát hành vi trên website. Hai công cụ đo hai thứ khác nhau, nên chênh lệch giữa chúng không phải bằng chứng API lấy sai.

Trạng thái index phải đi cùng URL. Một nhãn tổng hợp chưa đủ giải thích từng trang. Hãy chọn URL thuộc property có quyền truy cập, lấy kết quả Inspection rồi mở đúng URL ấy trên giao diện để đối chiếu. Giữ lại thời điểm lấy kết quả. Đúng URL trước đã. Kết quả kiểm tra phản ánh điều Google đã ghi nhận, nên không mặc nhiên là phép thử trực tiếp mọi thay đổi vừa sửa.

Còn tỷ lệ index tổng hợp thì sao? Chỉ nên báo khi đã có danh sách URL đầu vào rõ ràng. Một nhóm URL tự chọn không đủ đại diện cho toàn site. Chưa xác định được tập URL cần theo dõi thì báo trạng thái từng URL trước. Bên Tài Nguyên SEO dùng API ở chế độ chỉ đọc để theo dõi các thông số như tỷ lệ index. Đó là cách theo dõi dữ liệu, không phải lời khẳng định mọi việc kiểm tra đã được tự động hóa.

Chạy đúng khi thử chưa đủ để giao cho lịch tự động. Trước khi lập lịch, hãy kiểm tra quota và khả năng báo lỗi. Theo tài liệu giới hạn sử dụng của Google, Search Analytics có quota tải và quota theo nhịp gọi, còn URL Inspection có quota theo website và dự án. Đừng dùng một quy tắc chung. Tách lịch gọi giúp anh em biết phần nào đang vướng giới hạn. Mức sử dụng xem được trong thẻ quota của dự án Google API Console.

Trong bản thử, hãy cố ý dùng một bộ lọc không hợp lệ để xem chương trình có báo lỗi không. Khi gặp lỗi, đừng gọi lại dồn dập. Ghi nhận nguyên nhân trước rồi mới quyết định thử lại. Lịch chạy không biết nghi ngờ. Báo cáo SEO cần giữ dấu vết kiểm tra, thay vì chỉ đến hộp thư rất đúng giờ. Muốn xem đủ các bước thì đọc thêm bài viết chi tiết về Search Console API.

Bài gốc: https://tainguyenseo.com/google-search-console-api/

CÔNG TY TNHH TÀI NGUYÊN SEO
Địa chỉ: BT T14-11, The Manhattan, KĐT Vinhomes Grand Park, Đường Nguyễn Xiển, Phường Long Bình, TP. Hồ Chí Minh
Mã số thuế: 4202052216
Hotline: 0563 650 666
Email: tainguyenseocom@gmail.com
Website: https://tainguyenseo.com/

Giọng đọc: Piper, mô hình vi_VN vais1000 (CC BY 4.0).

links2