Để sử dụng Merchant API một cách hiệu quả, bạn cần hiểu rõ các khái niệm về đăng ký, xác thực và uỷ quyền. Các vai trò này có mục đích riêng biệt trong việc đảm bảo quyền truy cập an toàn và chính xác vào dữ liệu của Merchant Center.
Thuật ngữ
Đăng ký, xác thực và uỷ quyền có liên quan đến nhau, nhưng mỗi quy trình đều có ý nghĩa và mục đích riêng.
- Xác thực: Trong quy trình này, dịch vụ sẽ xác minh danh tính của người dùng hoặc ứng dụng đưa ra yêu cầu API. Merchant API sử dụng các cơ chế tiêu chuẩn của Google như OAuth 2.0. Việc sử dụng khoá API để xác thực không được hỗ trợ và sẽ dẫn đến lỗi xác thực. Để biết thêm thông tin, hãy xem bài viết Xác thực yêu cầu và Xác thực bằng tài khoản của riêng bạn.
- Uỷ quyền: Quy trình này xác định những hành động mà người dùng hoặc ứng dụng đã xác thực được phép thực hiện bằng tài khoản Merchant Center. Vai trò này trả lời câu hỏi: "Bạn có thể làm gì?" dựa trên vai trò và quyền được cấp cho người dùng đã xác thực trong tài khoản Merchant Center. Ví dụ: người dùng có thể được cấp quyền đọc dữ liệu sản phẩm nhưng không được cấp quyền sửa đổi chế độ cài đặt tài khoản.
- Đăng ký: Đối với Merchant API, đây là quy trình thiết lập một lần cho phép Google gửi cho bạn các thông báo dịch vụ quan trọng cho những tài khoản nhà bán hàng mà bạn quản lý. Khi đăng ký, bạn sẽ thêm địa chỉ email của nhà phát triển vào tài khoản Merchant Center chính và liên kết tài khoản đó với(các) mã dự án Google Cloud mà bạn dùng để xác thực. Mối liên kết này cho phép ứng dụng của bạn nhận thông báo dịch vụ cho tất cả tài khoản nhà bán hàng mà bạn quản lý. Để biết thêm thông tin, hãy xem bài viết Tạo dự án trên Google Cloud.
Đăng ký
Quy trình đăng ký là bước quan trọng để cho phép ứng dụng của bạn sử dụng Merchant API. Dưới đây là những gì bạn cần phải biết:
Điều kiện tiên quyết
Để đăng ký sử dụng Merchant API, bạn cần làm như sau:
- Tài khoản Merchant Center: Bạn cần có một tài khoản Merchant Center.
- Quyền quản trị: Tài khoản người dùng Google mà bạn dùng để bắt đầu lệnh gọi đăng ký phải có đặc quyền của quản trị viên đối với tài khoản Merchant Center mà bạn đang đăng ký.
- Dự án Google Cloud: Ứng dụng của bạn phải được liên kết với một Dự án Google Cloud. Dự án này cung cấp thông tin xác thực cần thiết (như Mã ứng dụng khách OAuth 2.0) để ứng dụng của bạn xác thực.
Lý do bạn không thể đăng ký một dự án trên đám mây dùng chung trên Google Cloud
Các công cụ như Google OAuth Playground và APIs Explorer sử dụng các dự án trên đám mây của Google Cloud dùng chung do Google sở hữu. Bạn không thể đăng ký bằng dự án dùng chung vì:
- Các mã này dùng để thử nghiệm và khám phá, chứ không phải để xác định danh tính ứng dụng chính thức.
- Việc đăng ký các địa chỉ email này sẽ ngụ ý rằng có mối liên kết giữa công cụ dùng chung và dữ liệu Merchant Center cụ thể của bạn, đồng thời có thể dẫn đến việc liên lạc không mong muốn.
Ứng dụng của bạn cần có dự án trên đám mây của Google Cloud riêng để thông tin liên lạc về Merchant API mà Google gửi cho bạn luôn phù hợp với mức sử dụng thực tế của bạn.
Tuy nhiên, bạn có thể sử dụng ứng dụng web OAuth Playground và API Explorer để sử dụng Merchant API cho các trường hợp thử nghiệm và không phải trong môi trường thực tế.
Tìm mã dự án trên đám mây của bạn
Bạn có thể tìm thấy Mã dự án và Số dự án trong Google Cloud Console. Để biết thông tin chi tiết, hãy xem bài viết Tìm tên, số và mã dự án.
Gọi điện để đăng ký
Đăng ký bằng phương thức
registerGcp
trong API phụ Accounts. Lệnh gọi này liên kết Số dự án Google Cloud của bạn với tài khoản Merchant Center.
Trong quá trình này, bạn nên cung cấp địa chỉ email liên kết với một người dùng cá nhân mà bạn dùng để gọi API. Email này phải thuộc về một người dùng có quyền quản trị đối với tài khoản Merchant Center.
Giới thiệu về trường email
Giao tiếp hiệu quả là yếu tố then chốt. Google gửi thông tin cập nhật quan trọng, Thông báo bắt buộc về dịch vụ (MSA), bản khảo sát dành cho nhà phát triển và các cơ hội khác liên quan đến Merchant API. Việc quản lý thông tin liên hệ đúng cách giúp đảm bảo rằng những thông báo này đến được đúng người.
- Mục đích: Google sử dụng địa chỉ email này làm người liên hệ chính cho thông tin liên lạc liên quan đến API.
- Email của ai: Đây phải là địa chỉ email của một nhà phát triển cá nhân hoặc người liên hệ kỹ thuật chính chịu trách nhiệm về việc tích hợp API.
- Các phương pháp hay nhất:
- NÊN: Sử dụng địa chỉ email công ty của một cá nhân.
- KHÔNG: Sử dụng email chung của nhóm hoặc email của tài khoản dịch vụ. Chúng tôi gửi thông tin liên lạc cho người nhận là con người.
Tài nguyên users để quản lý người liên hệ
Mặc dù địa chỉ email trong lệnh gọi đăng ký sẽ thiết lập người liên hệ ban đầu, nhưng
cách hiệu quả hơn để quản lý người liên hệ và quyền là sử dụng tài nguyên
accounts.users của Merchant API
hoặc chế độ cài đặt quản lý người dùng trong giao diện người dùng của Merchant Center. Để biết thêm thông tin về cách sử dụng Merchant Center, hãy xem bài viết Quản lý người dùng trong tài khoản của bạn.
Hãy tận dụng các tính năng này như sau:
- Thêm tất cả nhà phát triển: Thêm nhà phát triển đang thực hiện việc tích hợp API làm người dùng của tài khoản Merchant Center.
- Chỉ định vai trò
API_DEVELOPER: Ngoài các vai trò tiêu chuẩn (Quản trị viên, Tiêu chuẩn), bạn có thể chỉ định vai tròAPI_DEVELOPERcho người dùng. Cụ thể, hãy chỉ định vai trò này cho những người dùng cần nhận thông tin liên lạc liên quan đến API. Bạn có thể kết hợp vai trò này với các vai trò khác. - Lợi ích:
- Tách biệt rõ ràng: Tách biệt việc quản lý thông tin liên hệ API khỏi quy trình đăng ký một lần.
- Tính linh hoạt: Cập nhật người liên hệ khi thành viên nhóm thay đổi.
- Thông tin liên lạc có mục tiêu: Đảm bảo tin tức dành riêng cho API được gửi đến những người có liên quan.
Ngay cả khi bạn đã cung cấp địa chỉ email trong quá trình đăng ký, bạn vẫn nên
quản lý người liên hệ về API bằng cách thêm người dùng có vai trò API_DEVELOPER.
Tài liệu tham khảo
Để biết thêm thông tin, hãy xem phần dưới đây:
- Hướng dẫn bắt đầu nhanh
DeveloperRegistrationphương thức