Thẻ sản phẩm trong file phương tiện trên Instagram

Biểu thị thẻ sản phẩm trên File phương tiện trên Instagram. Hãy xem hướng dẫn Gắn thẻ sản phẩm để biết toàn bộ chi tiết về cách sử dụng.

Tạo

POST /{ig-media-id}/product_tags

Tạo hoặc cập nhật thẻ sản phẩm trên File phương tiện trên Instagram hiện có.

Giới hạn

Không hỗ trợ tài khoản Người sáng tạo nội dung trên Instagram.
Không hỗ trợ Tin, Instagram TV, Live và Mentions.
Hoạt động gắn thẻ file phương tiện sẽ được tính cộng cho đến khi đạt đến giới hạn 5 thẻ. Nếu file phương tiện được nhắm mục tiêu đã được gắn thẻ một sản phẩm trong yêu cầu, các giá trị x và y của thẻ cũ sẽ được cập nhật giá trị mới (không thêm thẻ mới).

Yêu cầu

Loại	Yêu cầu
Mã truy cập	Người dùng
Vai trò trong doanh nghiệp	Người dùng ứng dụng phải có vai trò quản trị viên trên Trình quản lý kinh doanh sở hữu Cửa hàng trên Instagram của Người dùng Instagram.
Cửa hàng trên Instagram	Người dùng Instagram sở hữu File phương tiện trên Instagram phải có Cửa hàng trên Instagram được phê duyệt với một danh mục sản phẩm chứa các sản phẩm.
Quyền	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Nếu người dùng ứng dụng được cấp một vai trò trên Trang đã kết nối với Người dùng Instagram được nhắm mục tiêu qua Trình quản lý kinh doanh, bạn cũng sẽ cần có một trong những quyền sau: `ads_management` `business_management`

Cú pháp yêu cầu

POST https://graph.facebook.com/{api-version}/{ig-media-id}/product_tags
  ?updated_tags={updated-tags}
  &access_token={access-token}

Thông số đường dẫn

Phần giữ chỗ	Giá trị
`{api-version}`	Phiên bản API.
`{ig-media-id}`	Bắt buộc. ID File phương tiện trên Instagram.

Thông số chuỗi truy vấn

Khóa Phần giữ chỗ Giá trị

access_token

{access-token}

Bắt buộc. Mã truy cập dành cho Người dùng của người dùng ứng dụng.

updated_tags

{updated-tags}

Bắt buộc. Chỉ áp dụng cho hình ảnh và video. Một mảng gồm các đối tượng chỉ định thẻ sản phẩm sẽ dùng để gắn thẻ hình ảnh hoặc video (tối đa 5 thẻ; các thẻ và ID sản phẩm phải là duy nhất). Mỗi đối tượng phải chứa các thông tin sau:

product_id - Bắt buộc. ID sản phẩm.
x – Chỉ hình ảnh. Một số thực float không bắt buộc cho biết tỷ lệ phần trăm khoảng cách từ cạnh trái của hình ảnh đa phương tiện đã đăng. Giá trị phải nằm trong khoảng 0.0 - 1.0.
y - Chỉ hình ảnh. Một số thực float không bắt buộc cho biết tỷ lệ phần trăm khoảng cách từ cạnh trên cùng của hình ảnh đa phương tiện đã đăng. Giá trị phải nằm trong khoảng 0.0 - 1.0.

Ví dụ:

[{product_id:'3231775643511089',x:0.5,y:0.8}]

Phản hồi

Đối tượng cho biết thành công hay thất bại.

{
  "success": {success}
}

Nội dung phản hồi

Thuộc tính	Giá trị
`success`	Trả về `true` nếu có thể cập nhật thẻ sản phẩm của File phương tiện trên Instagram. Nếu không, hệ thống sẽ trả về `false`.

cURL mẫu

Yêu cầu

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010778325754/product_tags?updated_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3859448974125379'%2C%0A%20%20%20%20x%3A%200.5%2C%0A%20%20%20%20y%3A%200.8%0A%20%20%7D%0A%5D&access_token=EAAOc..."

Bạn có thể tham khảo chuỗi phần tải dữ liệu POST được giải mã HTML dưới đây:

https://graph.facebook.com/v19.0/90010778325754/product_tags?updated_tags=[ { product_id:'3859448974125379', x: 0.5, y: 0.8 } ]&access_token=EAAOc...

Phản hồi

{
  "success": true
}

Đọc

GET /{ig-media-id}/product_tags

Lấy tập hợp thẻ sản phẩm trên File phương tiện trên Instagram. Hãy xem hướng dẫn Gắn thẻ sản phẩm để biết toàn bộ các bước gắn thẻ sản phẩm.

Giới hạn

Không hỗ trợ tài khoản Người sáng tạo nội dung trên Instagram.
Tin, Instagram TV, Reels, Live và Mentions không được hỗ trợ.

Yêu cầu

Loại	Yêu cầu
Mã truy cập	Người dùng
Vai trò trong doanh nghiệp	Người dùng ứng dụng phải có vai trò quản trị viên trên Trình quản lý kinh doanh sở hữu Cửa hàng trên Instagram của Người dùng Instagram.
Cửa hàng trên Instagram	Người dùng Instagram sở hữu File phương tiện trên Instagram phải có Cửa hàng trên Instagram được phê duyệt với một danh mục sản phẩm chứa các sản phẩm.
Quyền	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Nếu người dùng ứng dụng được cấp một vai trò trên Trang đã kết nối với Người dùng Instagram được nhắm mục tiêu qua Trình quản lý kinh doanh, bạn cũng sẽ cần có một trong những quyền sau: `ads_management` `business_management`

Cú pháp yêu cầu

GET https://graph.facebook.com/{api-version}/{ig-media-id}/product_tags
  ?access_token={access-token}

Thông số đường dẫn

Phần giữ chỗ	Giá trị
`{api-version}`	Phiên bản API.
`{ig-media-id}`	Bắt buộc. ID File phương tiện trên Instagram.

Thông số chuỗi truy vấn

Khóa	Phần giữ chỗ	Giá trị
`access_token`	`{access-token}`	Bắt buộc. Mã truy cập dành cho Người dùng của người dùng ứng dụng.

Phản hồi

Đối tượng ở định dạng JSON chứa một mảng thẻ sản phẩm trên File phương tiện trên Instagram. Phản hồi có thể bao gồm các trường thông tin thẻ sản phẩm sau:

{
  "data": [
    {
      "product_id": {product-id},
      "merchant_id": {merchant-id},
      "name": "{name}",
      "price_string": "{price-string}",
      "image_url": "{image-url}",
      "review_status": "{review-status}",
      "is_checkout": {is-checkout},
      "stripped_price_string": "{stripped-price-string}",
      "string_sale_price_string": "{string-sale-price-string}",
      "x": {x},
      "y": {y}
    }
  ]
}

Nội dung phản hồi

Thuộc tính	Giá trị
`product_id`	ID sản phẩm.
`merchant_id`	ID người bán.
`name`	Tên sản phẩm.
`price_string`	Chuỗi giá.
`image_url`	URL hình ảnh sản phẩm.
`review_status`	Trạng thái xét duyệt sản phẩm. Các giá trị có thể là: `approved` - Sản phẩm được phê duyệt. `rejected` - Sản phẩm đã bị từ chối `pending` - Vẫn đang xét duyệt. `outdated` - Sản phẩm đã được phê duyệt nhưng chưa được chỉnh sửa và cần phải phê duyệt lại. `""` - Không có trạng thái xét duyệt.
`is_checkout`	Nếu giá trị là `true` thì có thể mua sản phẩm trực tiếp qua ứng dụng Instagram. Nếu giá trị là `false` thì chỉ có thể mua sản phẩm trên trang web của người bán.
`stripped_price_string`	Chuỗi giá ngắn của sản phẩm (giá hiển thị trong không gian hạn chế, chẳng hạn như `$100` thay cho `100 USD`).
`string_sale_price_string`	Giá khuyến mãi của sản phẩm.
`x`	Một số thực cho biết tỷ lệ phần trăm khoảng cách từ cạnh trái của hình ảnh đa phương tiện. Giá trị nằm trong khoảng `0.0` - `1.0`.
`y`	Một số thực cho biết tỷ lệ phần trăm khoảng cách từ cạnh trên cùng của hình ảnh đa phương tiện. Giá trị nằm trong khoảng `0.0` - `1.0`.

cURL mẫu

Yêu cầu

curl -i -X GET \
 "https://graph.facebook.com/v19.0/90010778325754/product_tags?access_token=EAAOc..."

Phản hồi

{
  "data": [
    {
      "product_id": 3231775643511089,
      "merchant_id": 90010177253934,
      "name": "Gummy Bears",
      "price_string": "$3.50",
      "image_url": "https://scont...",
      "review_status": "approved",
      "is_checkout": true,
      "stripped_price_string": "$3.50",
      "stripped_sale_price_string": "$3",
      "x": 0.5,
      "y": 0.80000001192093
    }
  ]
}

Cập nhật

Xem phần Tạo.

Xóa

DELETE /{ig-media-id}/product_tags

Xóa thẻ sản phẩm trên File phương tiện trên Instagram hiện có.

Giới hạn

Không hỗ trợ tài khoản Người sáng tạo nội dung trên Instagram.
Tin, Instagram TV, Reels, Live và Mentions không được hỗ trợ.

Yêu cầu

Loại	Yêu cầu
Mã truy cập	Người dùng
Vai trò trong doanh nghiệp	Người dùng ứng dụng phải có vai trò quản trị viên trên Trình quản lý kinh doanh sở hữu Cửa hàng trên Instagram của Người dùng Instagram.
Cửa hàng trên Instagram	Người dùng Instagram sở hữu File phương tiện trên Instagram phải có Cửa hàng trên Instagram được phê duyệt với một danh mục sản phẩm chứa các sản phẩm.
Quyền	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Nếu người dùng ứng dụng được cấp một vai trò trên Trang đã kết nối với Người dùng Instagram được nhắm mục tiêu qua Trình quản lý kinh doanh, bạn cũng sẽ cần có một trong những quyền sau: `ads_management` `business_management`

Cú pháp yêu cầu

DELETE https://graph.facebook.com/{api-version}/{ig-media-id}/product_tags
  ?deleted_tags={deleted-tags}
  &access_token={access-token}

Thông số đường dẫn

Phần giữ chỗ	Giá trị
`{api-version}`	Phiên bản API.
`{ig-media-id}`	Bắt buộc. ID File phương tiện trên Instagram.

Thông số chuỗi truy vấn

Khóa Phần giữ chỗ Giá trị

access_token

{access-token}

Bắt buộc. Mã truy cập dành cho Người dùng của người dùng ứng dụng.

deleted_tags

{deleted-tags}

Bắt buộc. Một mảng chứa các thông tin sau cho mỗi thẻ sản phẩm cần xóa

merchant_id - Bắt buộc. ID người bán.
product_id - Bắt buộc. ID sản phẩm.

Phản hồi

Đối tượng cho biết thành công hay thất bại.

{
  "success": {success}
}

Nội dung phản hồi

Thuộc tính	Giá trị
`success`	Trả về `true` nếu có thể xóa thẻ sản phẩm được chỉ định trên File phương tiện trên Instagram. Nếu không, hệ thống sẽ trả về `false`.

cURL mẫu

Yêu cầu

curl -i -X DELETE \
  "https://graph.facebook.com/v19.0/90010778325754/product_tags?deleted_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3859448974125379'%2C%0A%20%20%20%20merchant_id%3A'90010177253934'%0A%20%20%7D%0A%5D&access_token=EAAOc..."

Bạn có thể tham khảo chuỗi phần tải dữ liệu POST được giải mã HTML dưới đây:

https://graph.facebook.com/v12.0/90010778325754/product_tags?deleted_tags=[ { product_id:'3859448974125379', merchant_id:'90010177253934' } ]&access_token=EAAOc...

Phản hồi

{
  "success": true
}