Trang này giải thích cách bạn có thể tạo tài khoản Merchant Center và tải một 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.
Nếu bạn sử dụng chế độ tích hợp API trong AppScript bằng Dịch vụ nội dung mua sắm, thì chế độ này sẽ tạo một dự án Google Cloud mặc định và tự động bật dịch vụ Merchant API. Tuy nhiên, bạn vẫn cần hoàn tất quy trình đăng ký Nhà phát triển một lần trước khi sử dụng Merchant API. Để biết thêm thông tin, hãy xem phần Sử dụng Merchant API Service trong Apps Script.
Tạo tài khoản
Để sử dụng Merchant API, bạn phải có một 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.
Đăng ký làm nhà phát triển
Để sử dụng Merchant API, bạn phải liên kết tài khoản Merchant Center và dự án Google Cloud bằng phương thức Đăng ký nhà phát triển, như sau:
Liên kết Merchant Center và dự án Google Cloud: Yêu cầu liên kết sẽ được phê duyệt tự động vì phương thức gọi có Mã truy cập hoặc Khoá API hợp lệ từ dự án Google Cloud và là người dùng được uỷ quyền của tài khoản Merchant Center.
Thêm người dùng API Developer vào tài khoản Merchant Center: API đăng ký sẽ thêm người dùng API Developer vào tài khoản Merchant Center. Nếu người dùng đã tồn tại, họ sẽ được cấp Loại quyền truy cập mới. Trong trường hợp là người dùng mới, họ sẽ nhận được lời mời qua email của Merchant Center.
Bạn nên sử dụng phương thức accounts.users.create để thêm nhà phát triển API bổ sung hoặc dự phòng nhằm xác minh rằng trong trường hợp người đó rời khỏi tổ chức của bạn hoặc bị xoá, bạn vẫn có thể đăng ký nhà phát triển hợp lệ.
Sau khi đăng ký, bạn có thể xem Trạng thái đăng ký bằng cách sử dụng GetDeveloperRegistration hoặc huỷ đăng ký bằng cách sử dụng UnregisterGCP.
Cuộc gọi đăng ký là
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp
{
developer_email:"example-email@example.com"
}
Sau khi yêu cầu chạy thành công, hãy chờ phản hồi:
{
"developerRegistration": {
"name": "accounts/ACCOUNT_ID/developerRegistration",
"gcpIds": ["GOOGLE_CLOUD_PROJECT_ID"]
}
}
Sau khi đăng ký nhà phát triển API, bạn có thể sử dụng phương thức accounts.users.patch để cấp cho họ các vai trò bổ sung, chẳng hạn như STANDARD và ADMIN.
Lấy mã tài khoản
Bạn có thể lấy mã nhận dạng 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. APIs Explorer sử dụng Google OAuth 2.0 để xác thực. Trước khi chạy các yêu cầu, hãy đảm bảo rằng bạn đã đá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 APIs 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 của mình:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
hoặc
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}
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 mã này để chạy các yêu cầu khác.
Tạo một nguồn dữ liệu sản phẩm chính
Để chèn một sản phẩm, bạn cần có một nguồn dữ liệu sản phẩm chính. Yêu cầu sau đây cho biết cách tạo một nguồn dữ liệu mà bạn có thể dùng để chèn một 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ã nhận dạng của tài khoản Merchant Center mà bạn đã tạo.
Sau khi chạy thành công yêu cầu này, 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 một sản phẩm.
Nguồn dữ liệu bạn tạo sẽ mất vài phút thì mới có thể chèn sản phẩm.
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 của bạ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ị mà bạn đã sao chép trước đó.
Sau khi chạy thành công yêu cầu này, 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.