Để đồng bộ hóa các sản phẩm, bạn cần catalogId để tích hợp vào. Trong hầu hết các trường hợp tích hợp, mã này sẽ do người quản lý tài khoản kỹ thuật của bạn tạo thay. Sau khi tạo danh mục, người quản lý tài khoản kỹ thuật của bạn cần hiển thị danh mục đó trong cổng thông tin CitrusAd của bạn.
Ngữ cảnh tạo danh mục
Dưới đây là một ngữ cảnh ví dụ để tạo danh mục:
POST $BASE_URL/v1/catalogs HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"catalogs": [
{
"name": "Retailer A"
}
]
}
Nếu thành công, đối tượng sau sẽ được trả về:
{
"catalogs": [
{
"teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
"name": "Retailer A",
"id": "216af452-d219-4807-b8ca-578bba446541"
}
]
}
Khi một đối tượng được trả lại thành công, bạn sẽ nhận được
idcho danh mục mới của mình. Nếu bạn gửi lại cùng một yêu cầu, bạn sẽ nhận được mộtidmới, từ đó tạo ra hai danh mục.
Bạn sẽ cần
idnày để đồng bộ hóa sản phẩm.
Tạo nhiều danh mục
Nếu bạn đang tạo nhiều danh mục, bạn có thể sắp xếp tối đa 100 cho mỗi yêu cầu. Dưới đây là một ngữ cảnh ví dụ để tạo hai danh mục:
POST $BASE_URL/v1/catalogs HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"catalogs": [
{
"name": "Retailer A"
},
{
"name": "Retailer B"
}
]
}
Nếu thành công, đối tượng sau sẽ được trả về (mỗi danh mục sẽ có idriêng):
{
"catalogs": [
{
"teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
"name": "Retailer A",
"id": "216af452-d219-4807-b8ca-578bba446541"
},
{
"teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
"name": "Retailer B",
"id": "75047339-65f5-41b8-8f2c-e76b04716cd4"
}
]
}
Danh mục bị ẩn theo mặc định sau khi được tạo. Liên hệ với người quản lý tài khoản kỹ thuật của bạn để hiển thị danh mục trên không gian tên của bạn.