Bắt đầu

API Manufacturer Center (MfC) cho phép các ứng dụng tương tác trực tiếp với nền tảng Manufacturer Center. Để giúp bạn bắt đầu, chúng tôi cung cấp các mã mẫu trong Java và .NET.

Hướng dẫn này sẽ giúp bạn tạo ứng dụng đầu tiên bằng API Manufacturer Center. Trước khi có thể bắt đầu lập trình, có một số việc bạn cần làm.

Hỗ trợ REST

API REST của chúng tôi hỗ trợ các thao tác CRUD cơ bản cho 2 loại tài nguyên:

Phần còn lại của tài liệu này sẽ chủ yếu được viết về Sản phẩm nhưng quy trình sẽ tương tự như quy trình ProductCertification.

Thiết lập tài khoản Manufacturer Center

  1. Tạo tài khoản Manufacturer Center.

  2. Hãy nhớ rõ email bạn đã sử dụng để tạo tài khoản Manufacturer Center này vì bạn sẽ cần đến email đó sau này. Trong ảnh chụp màn hình, bạn sẽ thấy tên này được biểu thị là manufacturer_user@example.com.

Tạo yêu cầu API đầu tiên của bạn (không cần một dòng mã!)

  1. Chuyển đến APIs Explorer (Trình khám phá API) trong tài liệu dành cho nhà phát triển của chúng tôi về Accounts.Products.list.

  2. Đảm bảo rằng Tài khoản Google đã đăng nhập có trong chế độ cài đặt "Người dùng" trong thẻ Cài đặt.

  3. Trong APIs Explorer, hãy đảm bảo bạn đã chọn Google OAuth 2.0 trong trình đơn thả xuống Authentication (Xác thực):

  4. Nhập accounts/{account_id}, thay thế {account_id} bằng Mã nhà sản xuất trong tài khoản Manufacturer Center của bạn, vào trường "gốc" của biểu mẫu rồi nhấp vào Thực thi.

  5. Bạn sẽ thấy một phản hồi thành công. Xin chúc mừng! Bạn đã đưa ra yêu cầu API Manufacturer Center đầu tiên.

  6. Nếu bạn chưa có sản phẩm nào trong Manufacturer Center thì sẽ không có sản phẩm nào trong danh sách. Tại thời điểm này, bạn có thể chuyển sang các yêu cầu khác và xem chức năng của chúng. Vì đây là một API RESTful nên tất cả các yêu cầu đều hoạt động tương tự nhau. Bước tiếp theo bạn nên làm là dùng thử Accounts.Products.get sau khi đã có sản phẩm.

Tạo Dự án trên Bảng điều khiển API của Google

Các yêu cầu đối với Manufacturer Center API được thực hiện thông qua dự án của bạn trên Bảng điều khiển API. Ở đây, chúng tôi giả định rằng bạn sẽ truy cập vào tài khoản Manufacturer Center của chính mình. Vì vậy, bạn nên sử dụng tài khoản dịch vụ để đơn giản hoá quy trình xác thực. Hãy xem Hướng dẫn về Tài khoản dịch vụ để biết thông tin chi tiết về cách thiết lập tài khoản dịch vụ mới dùng với tài khoản Manufacturer Center.

Yêu cầu API được uỷ quyền đầu tiên của bạn bằng Java

Sau khi thiết lập tài khoản dịch vụ và thêm mã tài khoản dịch vụ vào tài khoản Manufacturer Center, bạn có thể truy cập vào tài khoản của mình bằng Mã mẫu có sẵn. Hướng dẫn này dùng các mẫu Java để minh hoạ cách sử dụng API.

  1. Cài đặt Apache Maven nếu bạn chưa cài đặt.

  2. Tải mẫu Mua sắm của chúng tôi xuống từ trang GitHub.

  3. Trong thư mục con java, hãy tạo các mẫu Java:

    $ mvn compile

  4. Bây giờ, hãy chạy mã ProductsListSample (ví dụ cho mã ProductCertification sẽ là ListProductCertificationsSample):

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  5. Nếu chưa làm theo hướng dẫn về cấu hình trong tệp README đi kèm với tệp nguồn, bạn sẽ gặp lỗi không tìm thấy cấu hình mẫu nào. Làm theo hướng dẫn trong README để tạo thư mục cấu hình và điền thông tin thích hợp vào thư mục đó. Tệp JSON mà bạn đã tải xuống trong khi thiết lập tài khoản dịch vụ phải được đặt vào thư mục đó có tên tệp là service-account.json. Hãy nhớ cho mã biết vị trí của tệp bằng cách đặt biến môi trường sau.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>

  6. Bây giờ, bạn đã thiết lập cấu hình mẫu, hãy chạy lại mã ProductsListSample.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  7. Tại thời điểm này, chương trình Java sẽ hoàn tất việc thực thi và xuất danh sách sản phẩm đã tìm thấy hoặc thông báo không có sản phẩm nào trong tài khoản của bạn. Nếu bạn gặp lỗi như "Người dùng không thể truy cập vào tài khoản 1234567890", thì nhiều khả năng là bạn chưa thiết lập người dùng tài khoản dịch vụ làm người dùng được uỷ quyền trong Manufacturer Center. Trên quan điểm của API, dự án Bảng điều khiển API đã gửi yêu cầu thay mặt cho một người dùng không có trong danh sách quản trị viên được uỷ quyền của Manufacturer Center. Do đó, tất nhiên dự án sẽ từ chối yêu cầu đó.

  8. Bạn có thể thử nghiệm việc chạy ProductsListSample bao nhiêu lần tuỳ thích, vì đây là yêu cầu chỉ có thể đọc. Bạn cũng có thể khám phá các mẫu khác mà chúng tôi đã tạo cho cả Java và .NET.