Trang này được dịch bởi Cloud Translation API.

Tổng quan

Để 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. Chúng phục vụ cá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 Merchant Center.

Thuật ngữ

Đăng ký, xác thực và uỷ quyền có liên quan với nhau, nhưng mỗi hoạt động đều có ý nghĩa và mục đích riêng biệt.

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 gửi yêu cầu API. Merchant API sử dụng các cơ chế tiêu chuẩn của Google, chẳng hạn như OAuth 2.0. Để biết thêm thông tin, hãy xem phần Xác thực cá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. Nó 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 phép đọc dữ liệu sản phẩm nhưng không được phép 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 quan trọng về dịch vụ cho những tài khoản người bán mà bạn quản lý. Quy trình đăng ký sẽ thêm địa chỉ email của nhà phát triển vào tài khoản Merchant Center chính của bạn và liên kết địa chỉ đó 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 về dịch vụ cho tất cả tài khoản người bán 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 phải có những thông tin sau:

Tài khoản Merchant Center: Bạn cần có một tài khoản Merchant Center đang hoạt động.
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 Quản trị đối với tài khoản Merchant Center mà bạn đang đăng ký.
Dự án trên Google Cloud: Ứng dụng của bạn phải được liên kết với một Dự án trên Google Cloud. Dự án này cung cấp thông tin xác thực cần thiết (chẳng hạn 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 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 Google Cloud dùng chung do Google sở hữu. Bạn không thể đăng ký bằng các dự án được chia sẻ vì:

Chúng được dùng cho mục đích kiểm thử và khám phá, chứ không phải cho danh tính ứng dụng phát hành công khai.
Việc đăng ký các công cụ này sẽ ngụ ý mối liên kết giữa công cụ dùng chung và dữ liệu cụ thể của bạn trong Merchant Center, đồng thời có thể dẫn đến việc bạn nhận được thông tin liên lạc không mong muốn.

Ứng dụng của bạn cần có dự án Google Cloud chuyên dụng riêng để thông tin liên lạc mà Merchant API gửi cho bạn vẫ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 các ứng dụng web OAuth Playground và API Explorer để dùng Merchant API cho các trường hợp thử nghiệm và không phải sản xuất.

Tìm mã dự án trên Google Cloud

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 sẽ 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 một địa chỉ email liên kết với một người dùng riêng lẻ 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), 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 sẽ đảm bảo rằng những thông tin này đến được với người phù hợp.

Mục đích: Google sử dụng địa chỉ email này làm địa chỉ liên hệ chính để gửi 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 một đầu mố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 cá nhân.
- KHÔNG: Sử dụng bí danh nhóm chung hoặc email tài khoản dịch vụ. Chúng tôi dự định 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ý danh bạ

Mặc dù địa chỉ email trong lệnh gọi đăng ký sẽ thiết lập một 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 Merchant API accounts.users hoặc chế độ cài đặt quản lý người dùng trong giao diện người dùng 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.

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ững 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_DEVELOPER cho 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:
- Phân tách rõ ràng: Tách rời hoạt động quản lý danh bạ API khỏi quy trình đăng ký một lần.
- Tính linh hoạt: Cập nhật thông tin liên hệ khi thành viên trong 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ệ API bằng cách thêm người dùng có vai trò API_DEVELOPER.