Hướng dẫn kết nối Google Docs với n8n bằng OAuth2 chi tiết

Vì sao cần kết nối Google Docs với n8n?

Google Docs là công cụ soạn thảo văn bản được dùng phổ biến trong công việc hàng ngày, từ viết báo cáo, biên bản họp cho đến hợp đồng và tài liệu nội bộ. Khi kết nối Google Docs với n8n, bạn có thể tự động hóa toàn bộ quy trình liên quan đến tài liệu mà không cần thao tác thủ công lặp đi lặp lại.

Giống như các dịch vụ Google khác, để n8n truy cập được vào Google Docs, bạn bắt buộc phải tạo một bộ thông tin xác thực OAuth2 trên Google Cloud Console. Bài viết này sẽ hướng dẫn bạn thực hiện đầy đủ quy trình đó, bám sát theo đúng thứ tự các bước và các mũi tên hướng dẫn trong ảnh minh họa thực tế.

Hướng dẫn kết nối Google Docs với n8n từng bước

Bước 1: Tạo credential mới cho Google Docs

Trong giao diện n8n, vào mục Personal, chọn tab Credentials (đánh số 1 trong ảnh). Ở góc trên bên phải, nhấp vào nút Create credential (đánh số 2). Trong cửa sổ Add new credential hiện ra, gõ vào ô tìm kiếm từ khóa Google Docs OAuth2 API (đánh số 3), sau đó nhấp Continue (đánh số 4) để tiếp tục.  

Bước 2: Xem giao diện credential và sao chép Redirect URL

Cửa sổ Google Docs account mở ra với các trường cần điền: OAuth Redirect URL, Client ID và Client Secret. Redirect URL mặc định hiển thị dạng http://localhost:5678/rest/oauth2-credential/callback. Đây chính là địa chỉ bạn sẽ cần dán vào Google Cloud ở các bước tiếp theo, hãy giữ tab n8n này mở song song để tiện thao tác qua lại.

Bước 3: Chọn hoặc tạo project mới trên Google Cloud

Mở một tab trình duyệt khác, truy cập console.cloud.google.com. Nhấp vào tên project hiện tại ở góc trên bên trái (mũi tên đỏ bên trái trong ảnh) để mở danh sách project. Nếu muốn tạo project riêng cho tác vụ này thay vì dùng project cũ, nhấp New project ở góc trên bên phải (mũi tên đỏ bên phải).

Bước 4: Đặt tên và khởi tạo project

Tại trang New Project, điền tên project vào trường Project name, ví dụ Google-Docs-n8n-QTM. Project ID sẽ được tự động sinh ra bên dưới và không thể chỉnh sửa sau khi tạo. Nhấp nút Create để hoàn tất khởi tạo.

Bước 5: Chọn project vừa tạo để làm việc

Sau khi project được khởi tạo thành công, Google Cloud hiển thị thông báo xác nhận trong khu vực Notifications ở góc phải màn hình. Nhấp vào Select Project ngay trong thông báo đó để chuyển hẳn sang làm việc trong project mới, tên project sẽ hiển thị ở thanh điều hướng phía trên.

Bước 6: Kích hoạt Google Docs API

Tìm kiếm Google Docs API trong thanh tìm kiếm của Google Cloud, mở trang chi tiết dịch vụ này. Trang mô tả cho biết API này dùng để đọc và ghi tài liệu Google Docs. Nhấp nút Enable để kích hoạt cho project hiện tại.

Bước 7: Bắt đầu tạo credentials từ trang API

Sau khi bật API xong, trang chuyển sang giao diện quản lý chi tiết dịch vụ với thông báo nhắc rằng bạn cần tạo credentials để có thể gọi API này từ ứng dụng riêng. Nhấp vào nút Create credentials ở góc trên bên phải để tiếp tục.

Bước 8: Cấu hình màn hình đồng ý (Consent Screen)

Trang Credentials hiển thị danh sách trống cho API Keys, OAuth 2.0 Client IDs và Service Accounts, kèm theo cảnh báo màu vàng nhắc bạn cần cấu hình OAuth consent screen trước khi tạo credential. Nhấp vào Configure consent screen để bắt đầu thiết lập.

Bước 9: Điền thông tin ứng dụng (App Information)

Ở bước đầu tiên trong quy trình cấu hình, điền tên ứng dụng vào ô App name (đánh số 1), ví dụ GGDocs-n8n-QTM. Chọn địa chỉ email hỗ trợ người dùng ở ô User support email (đánh số 2). Nhấp Next (đánh số 3) để chuyển sang bước kế tiếp.

Bước 10: Chọn phạm vi đối tượng sử dụng (Audience)

Ở bước này, bạn cần chọn giữa hai loại: Internal, chỉ dành cho người dùng trong cùng tổ chức và không cần xác minh với Google, hoặc External, cho phép bất kỳ tài khoản Google nào được thêm vào danh sách thử nghiệm truy cập. Với tài khoản Google cá nhân thông thường, hãy chọn External rồi nhấp Next.

Bước 11: Nhập thông tin liên hệ (Contact Information)

Điền địa chỉ email vào ô Email addresses để Google gửi thông báo mỗi khi có thay đổi liên quan đến project của bạn. Nhấp Next để tiếp tục sang bước cuối cùng.

Bước 12: Hoàn tất và đồng ý chính sách

Ở bước Finish, tích vào ô đồng ý với Google API Services: User Data Policy, sau đó nhấp Continue để xác nhận toàn bộ thông tin đã cấu hình ở các bước trước.

Bước 13: Tạo OAuth Client và lấy Client ID, Client Secret

Sau khi hoàn tất consent screen, hệ thống hiển thị cửa sổ OAuth client created, thông báo rằng quyền truy cập OAuth hiện đang bị giới hạn trong danh sách test users đã khai báo trên OAuth consent screen. Cửa sổ này cung cấp cả Client ID và Client secret. Lưu ý quan trọng: Google chỉ hiển thị Client secret một lần duy nhất, hãy sao chép ngay cả hai giá trị này trước khi đóng cửa sổ, vì sau đó bạn sẽ không thể xem lại Client secret nữa.

Bước 14: Thêm tài khoản Google vào danh sách Test users

Vì ứng dụng đang ở trạng thái Testing, chỉ những tài khoản nằm trong danh sách test user mới có thể đăng nhập thành công. Vào mục Audience ở menu bên trái (đánh số 1), nhấp Add users (đánh số 2), nhập địa chỉ Gmail bạn dùng để xác thực vào ô nhập liệu (đánh số 3), rồi nhấp Save (đánh số 4) để lưu lại.

Bước 15: Dán Client ID và Client Secret vào n8n

Quay lại tab n8n, dán Client ID vào ô số 1 và Client Secret vào ô số 2 trong cửa sổ Google Docs account. Nhấp vào nút Sign in with Google (đánh số 3) để bắt đầu quá trình xác thực với tài khoản Google.

Bước 16: Cấp quyền truy cập cho ứng dụng

Trình duyệt mở ra màn hình xác nhận quyền, hiển thị dòng thông báo cho phép ứng dụng xem, chỉnh sửa, tạo và xóa tất cả tài liệu của bạn trên Google Tài liệu. Đọc kỹ nội dung này để đảm bảo bạn hiểu rõ mức quyền đang cấp, sau đó nhấp Tiếp tục để xác nhận.

Bước 17: Xác nhận kết nối thành công

Quay lại giao diện n8n, cửa sổ Google Docs account hiển thị dải màu xanh với dòng chữ "Account connected" cùng nút Sign in with Google đổi màu xác nhận. Góc trên cùng của cửa sổ cũng hiển thị trạng thái Saved. Đến đây, credential Google Docs của bạn đã sẵn sàng sử dụng trong bất kỳ workflow nào.

Google Docs trong n8n hỗ trợ những thao tác nào?

• Sau khi kết nối thành công, node Google Docs trong n8n cho phép bạn thực hiện ba nhóm thao tác chính trên tài liệu.
• Create cho phép tạo mới hoàn toàn một tài liệu Google Docs trực tiếp từ workflow, hữu ích khi bạn cần sinh ra báo cáo, hợp đồng hay biên bản một cách tự động dựa trên dữ liệu đầu vào từ các node khác.
• Get cho phép đọc nội dung của một tài liệu đã tồn tại, lấy về toàn bộ văn bản để xử lý tiếp trong các bước sau của workflow, ví dụ chuyển sang node phân tích văn bản hoặc gửi tóm tắt qua email.
• Update cho phép cập nhật nội dung tài liệu hiện có, thêm đoạn văn mới, chỉnh sửa thông tin hoặc điền dữ liệu động vào một mẫu tài liệu đã dựng sẵn.

Ngoài ra, node Google Docs còn có thể được dùng như một công cụ (AI tool) cho AI Agent trong n8n, cho phép mô hình AI tự động quyết định khi nào cần tạo, đọc hoặc cập nhật tài liệu dựa trên ngữ cảnh cuộc trò chuyện, thay vì phải cấu hình cứng từng tham số.

Vài ý tưởng workflow tự động hóa với Google Docs trong n8n

Một khi đã kết nối xong, Google Docs có thể trở thành mắt xích trong rất nhiều quy trình tự động khác nhau. Bạn có thể để n8n tự động tạo báo cáo hàng tuần bằng cách kéo dữ liệu từ Google Sheets hoặc cơ sở dữ liệu, sau đó điền vào một mẫu tài liệu Google Docs và gửi email cho các bên liên quan mà không cần ai phải soạn thủ công.

Một hướng khác là kết hợp với form khảo sát: khi có phản hồi mới từ Google Forms hoặc Typeform, n8n tự động tạo một tài liệu tổng hợp riêng cho từng phản hồi, tiện cho việc lưu trữ và tra cứu về sau. Với các đội ngũ pháp lý hoặc nhân sự, workflow có thể tự động điền thông tin nhân viên mới vào mẫu hợp đồng có sẵn trên Google Docs, giảm đáng kể thời gian soạn thảo thủ công cho từng trường hợp.

Xử lý các lỗi thường gặp khi kết nối

Nếu bạn nhận được thông báo lỗi truy cập bị từ chối khi đăng nhập Google, nguyên nhân phổ biến nhất là tài khoản Gmail bạn đang dùng chưa được thêm vào danh sách Test users ở Bước 14. Hãy quay lại mục Audience trong Google Cloud Console và kiểm tra lại danh sách này.

Một lỗi khác thường gặp là dán sai hoặc thiếu Redirect URL. Redirect URL trong Google Cloud phải khớp chính xác từng ký tự với URL hiển thị trong n8n ở Bước 2, kể cả dấu gạch chéo cuối cùng. Nếu bạn đang chạy n8n trên môi trường khác localhost, ví dụ trên server có domain riêng, hãy nhớ cập nhật lại Redirect URL tương ứng trong cả hai nơi trước khi thử kết nối lại.

Ngoài ra, vì ứng dụng OAuth đang ở trạng thái Testing, token xác thực thường chỉ có hiệu lực trong thời gian giới hạn. Nếu sau một thời gian n8n báo lỗi phiên đăng nhập hết hạn, chỉ cần vào lại credential và nhấp Sign in with Google để xác thực lại là Workflow sẽ hoạt động bình thường trở lại.