แท็กสินค้าในสื่อบน Instagram

หมายถึงแท็กสินค้าในสื่อบน Instagram โปรดดูรายละเอียดการใช้งานทั้งหมดในคู่มือการแท็กสินค้า

การสร้าง

POST /{ig-media-id}/product_tags

สร้างหรืออัพเดตแท็กสินค้าในสื่อบน Instagram ที่มีอยู่

ข้อจำกัด

ระบบไม่รองรับบัญชีครีเอเตอร์บน Instagram
ระบบไม่รองรับสตอรี่, Instagram TV, Live และการกล่าวถึง
คุณสามารถแท็กสื่อเพิ่มได้เรื่อยๆ จนกว่าจะครบ 5 แท็ก หากสินค้าในคำขอมีการแท็กสื่อเป้าหมายอยู่แล้ว ค่า x และ y ของแท็กเก่าจะได้รับการอัพเดตด้วยค่าใหม่ของแท็กนั้น (โดยจะไม่มีการเพิ่มแท็กใหม่)

ข้อกำหนด

ประเภท	ข้อกำหนด
โทเค็นการเข้าถึง	ผู้ใช้
บทบาทในธุรกิจ	ผู้ใช้แอพต้องมีบทบาทผู้ดูแลในตัวจัดการธุรกิจซึ่งเป็นเจ้าของร้านค้าบน Instagram ของผู้ใช้ Instagram
ร้านค้าบน Instagram	ผู้ใช้ Instagram ที่เป็นเจ้าของสื่อบน Instagram ต้องมีร้านค้าบน Instagramที่ได้รับการอนุมัติ พร้อมแค็ตตาล็อกสินค้าที่มีสินค้าต่างๆ
สิทธิ์การอนุญาต	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` หากผู้ใช้แอพได้รับบทบาทในเพจที่เชื่อมต่อกับผู้ใช้ Instagram เป้าหมายผ่านทางตัวจัดการธุรกิจ คุณจะต้องมีสิทธิ์การอนุญาตอย่างใดอย่างหนึ่งต่อไปนี้ด้วย `ads_management` `business_management`

รูปแบบคำสั่งของคำขอ

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

พารามิเตอร์พาธ

ตัวยึดตำแหน่ง	ค่า
`{api-version}`	เวอร์ชั่นของ API
`{ig-media-id}`	จำเป็นต้องระบุ ID สื่อบน Instagram

พารามิเตอร์สตริงการสืบค้น

คีย์ ตัวยึดตำแหน่ง ค่า

access_token

{access-token}

จำเป็นต้องระบุ โทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ

updated_tags

{updated-tags}

จำเป็นต้องระบุ ใช้กับรูปภาพและวิดีโอเท่านั้น อาร์เรย์ของอ็อบเจ็กต์ที่ระบุว่าจะใช้แท็กสินค้าใดในการแท็กรูปภาพหรือวิดีโอ (สูงสุด 5 แท็ก โดยที่แท็กและ ID สินค้าต้องไม่ซ้ำกัน) อ็อบเจ็กต์แต่ละรายการควรมีข้อมูลต่อไปนี้

product_id — จำเป็นต้องระบุ ID สินค้า
x - รูปภาพเท่านั้น แบบทศนิยมทางเลือกที่บ่งบอกระยะทางเป็นเปอร์เซ็นต์จากขอบเขตด้านซ้ายของรูปภาพสื่อที่เผยแพร่ โดยที่ค่าจะต้องอยู่ในช่วง 0.0 – 1.0
y — รูปภาพเท่านั้น แบบทศนิยมทางเลือกที่บ่งบอกระยะทางเป็นเปอร์เซ็นต์จากขอบเขตด้านบนของรูปภาพสื่อที่เผยแพร่ โดยที่ค่าจะต้องอยู่ในช่วง 0.0 – 1.0

ตัวอย่างเช่น

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

การตอบกลับ

อ็อบเจ็กต์ที่ระบุว่าสำเร็จหรือล้มเหลว

{
  "success": {success}
}

เนื้อหาของการตอบกลับ

คุณสมบัติ	ค่า
`success`	หากสามารถอัพเดตแท็กสินค้าของสื่อบน Instagram ได้ ระบบจะส่งคืนเป็น `true` แต่หากไม่ได้ จะส่งคืนเป็น `false`

ตัวอย่าง cURL

คำขอ

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..."

เนื้อหาต่อไปนี้คือสตริงเพย์โหลด POST ที่ถอดรหัสด้วย HTML สำหรับใช้ในการอ้างอิง

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

การตอบกลับ

{
  "success": true
}

การอ่าน

GET /{ig-media-id}/product_tags

รับคอลเลกชั่นแท็กสินค้าในสื่อบน Instagram โปรดดูขั้นตอนการแท็กสินค้าฉบับสมบูรณ์ในคู่มือการแท็กสินค้า

ข้อจำกัด

ระบบไม่รองรับบัญชีครีเอเตอร์บน Instagram
ระบบไม่รองรับสตอรี่, Instagram TV, Reels, Live และการกล่าวถึง

ข้อกำหนด

ประเภท	ข้อกำหนด
โทเค็นการเข้าถึง	ผู้ใช้
บทบาทในธุรกิจ	ผู้ใช้แอพต้องมีบทบาทผู้ดูแลในตัวจัดการธุรกิจซึ่งเป็นเจ้าของร้านค้าบน Instagram ของผู้ใช้ Instagram
ร้านค้าบน Instagram	ผู้ใช้ Instagram ที่เป็นเจ้าของสื่อบน Instagram ต้องมีร้านค้าบน Instagram ที่ได้รับการอนุมัติ พร้อมแค็ตตาล็อกสินค้าที่มีสินค้าต่างๆ
สิทธิ์การอนุญาต	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` หากผู้ใช้แอพได้รับบทบาทในเพจที่เชื่อมต่อกับผู้ใช้ Instagram เป้าหมายผ่านทางตัวจัดการธุรกิจ คุณจะต้องมีสิทธิ์การอนุญาตอย่างใดอย่างหนึ่งต่อไปนี้ด้วย `ads_management` `business_management`

รูปแบบคำสั่งของคำขอ

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

พารามิเตอร์พาธ

ตัวยึดตำแหน่ง	ค่า
`{api-version}`	เวอร์ชั่นของ API
`{ig-media-id}`	จำเป็นต้องระบุ ID สื่อบน Instagram

พารามิเตอร์สตริงการสืบค้น

คีย์	ตัวยึดตำแหน่ง	ค่า
`access_token`	`{access-token}`	จำเป็นต้องระบุ โทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ

การตอบกลับ

อ็อบเจ็กต์ในรูปแบบ JSON ที่มีอาร์เรย์ของแท็กสินค้าในสื่อบน Instagram ซึ่งการตอบกลับอาจมีช่องในแท็กสินค้าต่อไปนี้

{
  "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}
    }
  ]
}

เนื้อหาของการตอบกลับ

คุณสมบัติ	ค่า
`product_id`	ID สินค้า
`merchant_id`	ID ผู้ขาย
`name`	ชื่อสินค้า
`price_string`	สตริงราคา
`image_url`	URL รูปภาพของสินค้า
`review_status`	สถานะการตรวจสอบสินค้า ซึ่งอาจมีค่าเป็น `approved` - สินค้าได้รับอนุมัติ `rejected` - สินค้าถูกปฏิเสธ `pending` - ยังอยู่ระหว่างการตรวจสอบ `outdated` - สินค้าได้รับการอนุมัติแล้ว แต่มีการแก้ไขสินค้าและต้องได้รับการอนุมัติใหม่ `""` - ไม่มีสถานะการตรวจสอบ
`is_checkout`	หากเป็น `true` จะสามารถซื้อสินค้าได้โดยตรงผ่านแอพ Instagram แต่หากเป็น `false` จะสามารถซื้อสินค้าได้บนเว็บไซต์ของผู้ขายเท่านั้น
`stripped_price_string`	สตริงราคาสินค้าแบบย่อ (ราคาที่แสดงในพื้นที่จำกัด เช่น `$100` แทนที่จะเป็น `100 USD`)
`string_sale_price_string`	ราคาขายของสินค้า
`x`	ทศนิยมซึ่งระบุระยะทางเป็นเปอร์เซ็นต์จากขอบด้านซ้ายของรูปภาพสื่อ โดยที่ค่าจะอยู่ในช่วง `0.0`-`1.0`
`y`	ทศนิยมซึ่งระบุระยะทางเป็นเปอร์เซ็นต์จากขอบด้านบนของรูปภาพสื่อ โดยที่ค่าจะอยู่ในช่วง `0.0`-`1.0`

ตัวอย่าง cURL

คำขอ

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

การตอบกลับ

{
  "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
    }
  ]
}

การอัพเดต

โปรดดูที่การสร้าง

การลบ

DELETE /{ig-media-id}/product_tags

ลบแท็กสินค้าในสื่อบน Instagram ที่มีอยู่

ข้อจำกัด

ระบบไม่รองรับบัญชีครีเอเตอร์บน Instagram
ระบบไม่รองรับสตอรี่, Instagram TV, Reels, Live และการกล่าวถึง

ข้อกำหนด

ประเภท	ข้อกำหนด
โทเค็นการเข้าถึง	ผู้ใช้
บทบาทในธุรกิจ	ผู้ใช้แอพต้องมีบทบาทผู้ดูแลในตัวจัดการธุรกิจซึ่งเป็นเจ้าของร้านค้าบน Instagram ของผู้ใช้ Instagram
ร้านค้าบน Instagram	ผู้ใช้ Instagram ที่เป็นเจ้าของสื่อบน Instagram ต้องมีร้านค้าบน Instagram ที่ได้รับการอนุมัติ พร้อมแค็ตตาล็อกสินค้าที่มีสินค้าต่างๆ
สิทธิ์การอนุญาต	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` หากผู้ใช้แอพได้รับบทบาทในเพจที่เชื่อมต่อกับผู้ใช้ Instagram เป้าหมายผ่านทางตัวจัดการธุรกิจ คุณจะต้องมีสิทธิ์การอนุญาตอย่างใดอย่างหนึ่งต่อไปนี้ด้วย `ads_management` `business_management`

รูปแบบคำสั่งของคำขอ

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

พารามิเตอร์พาธ

ตัวยึดตำแหน่ง	ค่า
`{api-version}`	เวอร์ชั่นของ API
`{ig-media-id}`	จำเป็นต้องระบุ ID สื่อบน Instagram

พารามิเตอร์สตริงการสืบค้น

คีย์ ตัวยึดตำแหน่ง ค่า

access_token

{access-token}

จำเป็นต้องระบุ โทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ

deleted_tags

{deleted-tags}

จำเป็นต้องระบุ อาร์เรย์ที่มีข้อมูลสำหรับแท็กสินค้าที่จะลบออกต่อไปนี้

merchant_id - จำเป็นต้องระบุ ID ผู้ขาย
product_id - จำเป็นต้องระบุ ID สินค้า

การตอบกลับ

อ็อบเจ็กต์ที่ระบุว่าสำเร็จหรือล้มเหลว

{
  "success": {success}
}

เนื้อหาของการตอบกลับ

คุณสมบัติ	ค่า
`success`	หากสามารถลบแท็กสินค้าที่กำหนดในสื่อบน Instagram ได้ ระบบจะส่งคืนเป็น `true` แต่หากไม่ได้ จะส่งคืนเป็น `false`

ตัวอย่าง cURL

คำขอ

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..."

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

การตอบกลับ

{
  "success": true
}