Để đảm bảo bảo mật dữ liệu, thực thi kiểm soát quyền truy cập và duy trì tính toàn vẹn của hệ thống, bạn phải xác thực tất cả các yêu cầu Merchant API. API sử dụng danh tính đã xác thực để xác định những hành động mà phương thức gọi có quyền thực hiện. Ví dụ: một số phương thức gọi có thể chỉ có quyền đọc dữ liệu sản phẩm, trong khi những phương thức gọi khác có thể sửa đổi chế độ cài đặt tài khoản trong Merchant Center.
Tài liệu này nằm trong loạt bài gồm nhiều phần về cách bắt đầu sử dụng Merchant API. Nếu đã thiết lập quy trình xác thực bằng Merchant API, bạn có thể bỏ qua và chuyển sang phần tiếp theo: Đăng ký làm nhà phát triển
Uỷ quyền cho các yêu cầu gửi đến Merchant API
Mọi yêu cầu gửi đến Merchant API đều phải có mã uỷ quyền để Google nhận dạng ứng dụng của bạn. Để thiết lập quy trình xác thực và uỷ quyền, hãy quyết định trường hợp sử dụng mô tả chính xác nhất cách bạn dự định làm việc với Merchant API:
Bạn có đang xây dựng một ứng dụng cho các doanh nghiệp khác sử dụng không?
Nếu có, bạn sẽ sử dụng quy trình uỷ quyền OAuth 2.0. Chọn phương thức uỷ quyền OAuth 2.0 nếu:
- Bạn là nhà cung cấp hoặc công ty quảng cáo bên thứ ba: Bạn đang xây dựng một ứng dụng, chẳng hạn như nền tảng SaaS, mà các doanh nghiệp khác sẽ sử dụng để quản lý dữ liệu Merchant Center của riêng họ.
- Bạn cần quản lý nhiều tài khoản bên ngoài: Bạn muốn có một ứng dụng duy nhất để hoạt động trên nhiều tài khoản Merchant Center độc lập thuộc sở hữu của nhiều chủ sở hữu tài khoản khác nhau. Khách hàng của bạn cấp quyền bằng cách đăng nhập vào Tài khoản Google của riêng họ và nhấp vào "Cho phép" trên màn hình xin phép.
Bạn có đang xây dựng ứng dụng cho doanh nghiệp của mình không?
Nếu có, bạn sẽ sử dụng quyền uỷ quyền của tài khoản dịch vụ để có quyền truy cập vào Merchant API. Chọn phương thức uỷ quyền tài khoản dịch vụ nếu:
- Bạn đang xây dựng ứng dụng nội bộ của riêng mình: Bạn đang phát triển một công cụ dành riêng cho doanh nghiệp của mình để quản lý dữ liệu Merchant Center của riêng bạn hoặc bạn muốn thông tin xác thực thuộc về chính ứng dụng đó chứ không phải một người dùng cá nhân cụ thể.
- Bạn cần tự động hoá mà không cần người dùng đăng nhập: Ứng dụng của bạn chạy các tác vụ nền, chẳng hạn như cập nhật khoảng không quảng cáo tự động hoặc các công việc "cron".
Uỷ quyền OAuth 2.0
Nếu bạn là nhà cung cấp bên thứ ba hoặc công ty quảng cáo quản lý nhiều tài khoản khách hàng, thì ứng dụng của bạn phải sử dụng OAuth 2.0 để cấp phép các yêu cầu. Hãy làm theo các bước sau để thiết lập OAuth 2.0 cho Merchant API:
- Tạo thông tin xác thực OAuth 2.0 trong phần API và dịch vụ trong Google Cloud Console
- Tải thông tin đăng nhập ứng dụng OAuth2 xuống tệp, chẳng hạn như
client-secrets.json - Thêm tài khoản email làm người dùng vào Merchant Center: Đảm bảo rằng Tài khoản Google mà bạn dùng để uỷ quyền cho các yêu cầu tồn tại dưới dạng người dùng trong Merchant Center. Xem bài viết Cách thêm hoặc xoá người dùng khỏi Merchant Center để biết thêm thông tin
- Chỉ định vai trò
Admincho tài khoản này để thực hiện việc đăng ký. Để biết thêm thông tin về các vai trò, hãy xem bài viết Quản lý người dùng và cấp truy cập trong Merchant Center - Thiết lập phương thức xác thực bằng mã mẫu: Làm theo hướng dẫn trong phần Thiết lập phương thức xác thực và cấu hình mẫu của tài liệu về mã mẫu chính thức
Để biết thêm thông tin về quy trình uỷ quyền OAuth 2.0, hãy xem bài viết Uỷ quyền cho ứng dụng bên thứ ba truy cập vào tài khoản Merchant Center và Sử dụng OAuth 2.0 để truy cập vào các API của Google.
Uỷ quyền tài khoản dịch vụ
Bạn sử dụng tài khoản dịch vụ để cho phép Merchant API truy cập vào tài khoản Merchant Center của bạn. Hãy làm theo các bước sau để thiết lập quy trình uỷ quyền tài khoản dịch vụ cho Merchant API:
- Tạo thông tin đăng nhập tài khoản dịch vụ trong API và dịch vụ trong Cloud Console của bạn
- Tải khoá riêng tư xuống: Tạo và tải khoá riêng tư xuống ở định dạng JSON cho tài khoản dịch vụ. Đổi tên tệp thành
service-account.json - Thêm tài khoản dịch vụ vào Merchant Center: Sao chép địa chỉ email duy nhất của tài khoản dịch vụ, chẳng hạn như
sa@project.iam.gserviceaccount.com, rồi thêm địa chỉ đó làm người dùng mới trong Merchant Center. Hãy xem bài viết Cách thêm hoặc xoá người dùng khỏi Merchant Center để biết thêm thông tin - Chỉ định quyền truy cập
Admincho ứng dụng đó. Để biết thêm thông tin về các cấp truy cập, hãy xem bài viết Quản lý người dùng và cấp truy cập trong Merchant Center - Thiết lập quy trình xác thực bằng mã mẫu: Làm theo hướng dẫn trong phần Thiết lập quy trình xác thực và tài liệu về cấu hình mẫu của mã mẫu chính thức
Để biết thêm thông tin về việc uỷ quyền tài khoản dịch vụ, hãy xem bài viết Uỷ quyền truy cập vào tài khoản Merchant Center và Tổng quan về tài khoản dịch vụ.