Trang này giải thích cách tạo tài khoản Merchant Center và tải sản phẩm mẫu lên bằng Merchant API.
Trước khi bắt đầu
Bật Merchant API trong dự án Google Cloud.
Tạo tài khoản
Để sử dụng Merchant API, bạn phải có tài khoản Merchant Center. Để tạo tài khoản Merchant Center, hãy xem bài viết Bắt đầu sử dụng Merchant Center.
Lấy mã tài khoản
Bạn có thể lấy mã tài khoản bằng cách sử dụng phương thức accounts.list.
Bạn có thể sử dụng Google APIs Explorer để chạy các yêu cầu Merchant API. Trình khám phá API sử dụng Google OAuth 2.0 để xác thực. Trước khi chạy các yêu cầu, hãy nhớ đánh dấu vào hộp kiểm Google OAuth 2.0.
Để xác thực bằng OAuth 2.0, bạn cần đăng nhập vào Tài khoản Google của mình, sau đó đăng nhập vào Trình khám phá API. Bạn cũng cần cho phép API Explorer quản lý trang thông tin sản phẩm và tài khoản của bạn.
Yêu cầu sau đây cho biết cách bạn có thể truy xuất mã tài khoản:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
Sau khi yêu cầu chạy thành công, bạn sẽ thấy phản hồi sau:
{
"accounts": [
{
"name": "{ACCOUNT_NAME}",
"accountId": "{ACCOUNT_ID}",
"accountName": "{ACCOUNT_DISPLAY_NAME}",
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
]
}
Sao chép {ACCOUNT_ID} vì bạn sẽ cần nó để chạy các yêu cầu khác.
Tạo nguồn dữ liệu sản phẩm chính
Để chèn sản phẩm, bạn cần có nguồn dữ liệu sản phẩm chính. Yêu cầu sau đây cho biết cách tạo nguồn dữ liệu mà bạn có thể sử dụng để chèn sản phẩm vào tài khoản của mình:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1
{
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"contentLanguage": "en",
"countries": [
"US"
],
"feedLabel": "US"
},
"name": "primary-data-source",
"displayName": "Primary Products Data Source"
}
Thay thế {ACCOUNT_ID} bằng mã tài khoản Merchant Center mà bạn đã tạo.
Sau khi yêu cầu này chạy thành công, bạn sẽ thấy phản hồi sau:
{
"name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
"dataSourceId": "{DATASOURCE_ID}",
"displayName": "Primary Products Data Source",
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"feedLabel": "US",
"contentLanguage": "en",
"countries": [
"US"
],
"defaultRule": {
"takeFromDataSources": [
{
"self": true
}
]
}
},
"input": "API"
}
Sao chép giá trị của trường name vì bạn sẽ cần giá trị này để chèn sản phẩm.
Bạn sẽ phải đợi vài phút để có thể chèn sản phẩm vào nguồn dữ liệu đã tạo.
Bạn có thể xem nguồn dữ liệu này trong giao diện người dùng của Merchant Center. Để biết thêm thông tin, hãy xem bài viết Cách tìm thẻ Nguồn dữ liệu.
Chèn sản phẩm
Để chèn một sản phẩm mẫu vào tài khoản, hãy chạy yêu cầu sau:
POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1
{
"channel": "ONLINE",
"contentLanguage": "en",
"feedLabel": "US",
"name": "Red T-shirt",
"attributes": {
"gender": "Male",
"brand": "New brand"
},
"offerId": "tshirt-123"
}
Thay thế {DATASOURCE_NAME} bằng giá trị bạn đã sao chép trước đó.
Sau khi yêu cầu này chạy thành công, bạn sẽ thấy phản hồi sau:
{
"name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
"product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
"channel": "ONLINE",
"offerId": "tshirt-123",
"contentLanguage": "en",
"feedLabel": "US",
"attributes": {
"brand": "New brand",
"gender": "Male"
}
}
Mã sản phẩm của sản phẩm mới tạo là online~en~US~tshirt-123. Bạn có thể sử dụng phương thức accounts.products.get để truy xuất thông tin chi tiết về sản phẩm này. Bạn cũng có thể sử dụng giao diện người dùng Merchant Center để xem sản phẩm này.