Tài khoản dịch vụ là tài khoản Google đặc biệt mà các ứng dụng có thể sử dụng để truy cập vào các API của Google theo phương thức có lập trình thông qua OAuth 2.0. Tài khoản dịch vụ sử dụng quy trình OAuth 2.0 không yêu cầu sự cho phép của con người. Thay vào đó, ứng dụng này sử dụng tệp khoá mà chỉ ứng dụng của bạn mới truy cập được. Hướng dẫn này thảo luận cách truy cập vào Content API for Shopping bằng tài khoản dịch vụ.
Lưu ý: Các ứng dụng dùng tài khoản dịch vụ để xác thực chỉ có thể truy cập vào tài khoản Merchant Center của riêng bạn. Nếu bạn đang viết một ứng dụng của bên thứ ba cần quyền truy cập vào tài khoản Merchant Center của khách hàng, vui lòng xem hướng dẫn về Yêu cầu uỷ quyền.
Điều kiện tiên quyết
- Tài khoản Merchant Center.
Các bước sử dụng tài khoản dịch vụ để truy cập Content API for Shopping
- Tạo thông tin xác thực tài khoản dịch vụ hoặc truy cập thông tin xác thực công khai mà bạn đã tạo. Bạn sẽ cần tạo mã ứng dụng khách OAuth 2.0 và lấy tệp khoá riêng tư *.json:
- Chuyển đến Google API Console.
- Chọn một dự án trong trình đơn thả xuống ở đầu trang. Nếu bạn chưa có dự án, hãy tạo dự án bằng cách nhấp vào DỰ ÁN MỚI.
- Nếu bạn chưa bật Content API for Shopping cho dự án này, hãy tìm dự án này trong danh sách API của Google rồi bật.
- Trong thanh bên ở bên trái, hãy chọn Thông tin xác thực. Bạn có thể phải nhấp vào mũi tên chỉ sang trái ở trên cùng bên trái để xem.
- Để thiết lập tài khoản dịch vụ, hãy chọn TẠO THÔNG TIN XÁC THỰC, sau đó chọn Tài khoản dịch vụ.
- Đặt tên cho tài khoản dịch vụ mới. Tên này cũng đóng vai trò là tên người dùng mặc định cho mã tài khoản dịch vụ. Ghi lại mã tài khoản dịch vụ, bao gồm cả phần sau ký tự "@" để sử dụng sau này. Nhấp vào TẠO, sau đó thực hiện các bước không bắt buộc để cấp quyền truy cập vào dự án và người dùng, rồi nhấp vào XONG.
Lựa chọn vai trò cho tài khoản dịch vụ sẽ không ảnh hưởng đến những lệnh gọi có thể thực hiện đến Content API, vì quyền truy cập vào các phương thức Content API được xác định thay thế theo vai trò liên kết với mã tài khoản dịch vụ trong Merchant Center. Nếu bạn không chắc nên chọn mục nào, hãy chọn Project > Viewer (Dự án > Trình xem).
- Bạn sẽ được chuyển hướng đến trang Tài khoản dịch vụ để truy cập vào tài khoản dịch vụ mới.
- Để lấy khoá riêng tư JSON, hãy nhấp vào tài khoản dịch vụ, sau đó nhấp vào thẻ KHOÁ. Nhấp vào THÊM KHOÁ > Tạo khoá mới, rồi chọn JSON làm loại khoá. Nhấp vào CREATE (TẠO) để tải khoá riêng tư xuống máy tính.
- Thêm tài khoản dịch vụ mới làm người dùng vào tài khoản Merchant Center. Nếu là nhà phát triển bên thứ ba, bạn sẽ cần khách hàng thực hiện bước này cho mình.
- Truy cập vào tài khoản Merchant Center.
- Chuyển đến phần Quyền truy cập vào tài khoản trong phần cài đặt của tài khoản Merchant Center.
- Nhấp vào + Thêm người dùng rồi sử dụng mã tài khoản dịch vụ làm địa chỉ email cho người dùng mới.
Nếu bạn chưa ghi lại mã tài khoản dịch vụ trước đó, hãy chuyển đến trang quản trị Service Accounts (Tài khoản dịch vụ) rồi chọn dự án bạn đã tạo.
- Chỉ định các lựa chọn ưu tiên Quyền truy cập của người dùng và Thông báo qua email cho tài khoản dịch vụ. Xin lưu ý rằng để sử dụng dịch vụ
Accounts, bạn cần có quyền Quản trị. - Nhấp vào Thêm người dùng để lưu lựa chọn ưu tiên và quay lại danh sách người dùng. Mã tài khoản dịch vụ phải được liệt kê cùng với vai trò người dùng đã chọn.
- Lặp lại quy trình này cho tất cả các tài khoản dịch vụ khác mà bạn muốn thêm.
- Giờ đây, bạn có thể truy cập vào tài khoản Merchant Center bằng tài khoản dịch vụ thông qua quy trình Thông tin xác thực mặc định của ứng dụng Google hoặc trực tiếp sử dụng quy trình tài khoản dịch vụ. Mẫu Content API for Shopping cho biết cách sử dụng cả hai luồng cho thông tin xác thực tài khoản dịch vụ trong từng ngôn ngữ lập trình được hỗ trợ. Vui lòng xem các mã mẫu để dùng thử tài khoản dịch vụ mới và tìm hiểu những thay đổi cần thiết để sử dụng tài khoản dịch vụ trong mã của riêng bạn.
Câu hỏi thường gặp
- Tôi có thể đăng nhập vào giao diện người dùng Merchant Center bằng tài khoản dịch vụ của mình không?
- Không, tài khoản dịch vụ không phải là Tài khoản Google thông thường và không thể truy cập vào giao diện người dùng Merchant Center.
- Tôi cần làm mới mã truy cập tài khoản dịch vụ bao lâu một lần?
- Mã truy cập sẽ hết hạn một giờ sau khi được Máy chủ uỷ quyền OAuth 2.0 của Google cấp. Khi mã truy cập hết hạn, ứng dụng sẽ dùng thư viện ứng dụng để tìm nạp một mã truy cập khác.