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 cách có lập trình thông qua OAuth 2.0. Tài khoản dịch vụ sử dụng một quy trình OAuth 2.0 không yêu cầu sự cho phép của con người. Thay vào đó, tài khoản này sử dụng một tệp khoá mà chỉ ứng dụng của bạn mới có thể truy cập. Hướng dẫn này trình bày cách truy cập Content API for Shopping bằng tài khoản dịch vụ.
Lưu ý: Các ứng dụng sử 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 bên thứ ba cần có 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 Uỷ quyền yêu cầu.
Đ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 vào thông tin xác thực công khai mà bạn đã tạo. Bạn sẽ cần tạo một mã ứng dụng 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 một 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 API đó trong danh sách API của Google rồi bật API đó.
- Nhấp vào trình đơn điều hướng (☰) ở trên cùng bên trái, chọn API và dịch vụ, rồi chọn Thông tin xác thực.
- Để thiết lập tài khoản dịch vụ, hãy chọn TẠO THÔNG TIN XÁC THỰC, rồi chọn Tài khoản dịch vụ.
- Đặt tên cho tài khoản dịch vụ mới. Đây cũng 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.
Việc 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ể được thực hiện đối với Content API, vì quyền truy cập vào các phương thức Content API được xác định bằng 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 chắn nên chọn gì, 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ụ, nơi bạn có thể 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ẻ KEYS (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 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 cần yêu cầu khách hàng thực hiện bước này cho bạn.
- Truy cập vào tài khoản Merchant Center.
- Chuyển đến mục 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 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ị Tài khoản dịch vụ rồi chọn dự án mà bạn đã tạo.
- Chỉ định các lựa chọn ưu tiên về 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 bạn phải có quyền truy cập Quản trị để sử dụng dịch vụ
Accounts. - Nhấp vào Thêm người dùng để lưu các 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 của mình bằng tài khoản dịch vụ bằng cách sử dụng quy trình Thông tin đăng nhập mặc định của ứng dụng Google hoặc bằng cách sử dụng trực tiếp 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 quy trình cho thông tin đăng nhập 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ẫu mã để dùng thử tài khoản dịch vụ mới và tìm hiểu những thay đổi mà bạn cần thực hiện để sử dụng tài khoản dịch vụ trong mã của riêng mình.
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 sau một giờ kể từ 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.