ความคิดเห็นบน Instagram (IG)

แสดงถึงความคิดเห็นในอ็อบเจ็กต์สื่อบน Instagram

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

ขอแนะนำช่องต่อไปนี้

legacy_instagram_comment_id

ระบบไม่รองรับช่องต่อไปนี้

comment_type
mentioned_instagram_users

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic` `instagram_business_manage_comments`	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `ads_read`

การสร้าง

ระบบไม่รองรับการดำเนินการนี้

การอ่าน

GET <HOST_URL>/<IG_COMMENT_ID>?fields=<LIST_OF_FIELDS>

ดึงข้อมูลช่องและจุดเชื่อมโยงต่างๆ ในความคิดเห็นบน Instagram

ข้อจำกัด

ไม่สามารถส่งคำขอกับความคิดเห็นที่ค้นพบผ่าน API การกล่าวถึงได้ เว้นแต่เจ้าของความคิดเห็นจะเป็นผู้ส่งคำขอ ดังนั้นให้ใช้โหนดความคิดเห็นที่มีการกล่าวถึงแทน
ระบบจะไม่ส่งคืนความคิดเห็นบนสื่อที่มีการควบคุมอายุ
ระบบจะไม่ส่งคืนความคิดเห็นที่สร้างโดยผู้ใช้ Instagram ที่ผู้ใช้แอพได้จำกัดไว้ เว้นแต่จะมีการยกเลิกการจำกัดผู้ใช้ Instagram รายนั้นและอนุมัติความคิดเห็นดังกล่าว
คุณจะอ่านความคิดเห็นในสื่อบน Instagram ที่เป็นวิดีโอถ่ายทอดสดได้ในขณะที่กำลังแพร่ภาพสื่อบน Instagram ที่มีความคิดเห็นนั้นอยู่เท่านั้น

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

GET https://<HOST_URL>/<API_VERSION>/<IG_COMMENT_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

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

ตัวยึดตำแหน่ง	ค่า
`<API_VERSION>`	เวอร์ชั่นของ API
`<HOST_URL>`	เวอร์ชั่นของ API
`<IG_COMMENT_ID>`	จำเป็นต้องระบุ ID ความคิดเห็นบน Instagram

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

คีย์	ตัวยึดตำแหน่ง	ค่า
`access_token`	`<ACCESS_TOKEN>`	จำเป็นต้องระบุ โทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ
`fields`	`<LIST_OF_FIELDS>`	รายการช่องของความคิดเห็นบน Instagram ที่คุณต้องการให้ส่งคืนสำหรับแต่ละความคิดเห็นบน Instagram ในชุดผลลัพธ์ โดยคั่นด้วยเครื่องหมายจุลภาค

ช่อง

ชื่อช่อง	คำอธิบาย
`from`	อ็อบเจ็กต์ที่ประกอบไปด้วยสิ่งต่อไปนี้ `id` — ID ใน Instagram (IGSID) ของผู้ใช้ Instagram ที่สร้างความคิดเห็นบน Instagram `username` - ชื่อผู้ใช้ของผู้ใช้ Instagram ที่สร้างความคิดเห็นบน Instagram
`hidden`	ระบุว่าความคิดเห็นถูกซ่อนไว้ (`true`) หรือไม่ได้ถูกซ่อนไว้ (`false`)
`id`	ID ความคิดเห็นบน Instagram
`like_count`	จำนวนการกดถูกใจความคิดเห็นนั้นๆ บน Instagram
`legacy_instagram_comment_id`	ID สำหรับความคิดเห็นบน Instagram ที่สร้างขึ้นสำหรับตำแหน่งข้อมูล API การตลาดสำหรับเวอร์ชั่น 21.0 และเวอร์ชั่นก่อนหน้า
`media`	อ็อบเจ็กต์ที่ประกอบไปด้วยสิ่งต่อไปนี้ `id` - ID ของสื่อบน Instagram ที่มีการแสดงความคิดเห็นบน Instagram นั้น `media_product_type` - แพลตฟอร์มที่เผยแพร่สื่อบน Instagram (กล่าวคือ จุดที่สื่อบน Instagram ไปปรากฏ) ที่มีการแสดงความคิดเห็นบน Instagram นั้น
`parent_id`	ID ของความคิดเห็นหลักบน Instagram ในกรณีที่ความคิดเห็นนี้อยู่ในอีกความคิดเห็นหนึ่งบน Instagram (กล่าวคือ เป็นการตอบกลับความคิดเห็นอีกทีหนึ่ง)
`replies`	รายการข้อความตอบกลับ (ความคิดเห็นบน Instagram) ที่แสดงไว้ในความคิดเห็นบน Instagram
`text`	ข้อความของความคิดเห็นบน Instagram
`timestamp`	ประทับเวลาในรูปแบบตามมาตรฐาน ISO 8601 ซึ่งแสดงถึงเวลาที่แสดงความคิดเห็นนั้นๆ บน Instagram ตัวอย่าง: `2017-05-19T23:27:28+0000`
`user`	ID ของผู้ใช้ Instagram ที่แสดงความคิดเห็นนั้นๆ บน Instagram มีการส่งคืนเฉพาะในกรณีที่ผู้ใช้แอพเป็นเจ้าของความคิดเห็นนั้นๆ บน Instagram มิฉะนั้น ระบบจะส่งคืน `username` แทน
`username`	ชื่อผู้ใช้ของผู้ใช้ Instagram ที่แสดงความคิดเห็นนั้นๆ บน Instagram ตั้งแต่วันที่ 27 สิงหาคม 2024 เป็นต้นไป สิทธิ์การอนุญาต `instagram_manage_comments` (หากแอพของคุณใช้การเข้าสู่ระบบด้วย Facebook) และสิทธิ์การอนุญาต `instagram_business_manage_comments` (หากแอพของคุณใช้การเข้าสู่ระบบด้วย Instagram) จะต้องเข้าถึงช่อง `username` ของผู้ใช้ Instagram ที่แสดงความคิดเห็นบนสื่อของบัญชีมืออาชีพของ Instagram

จุดเชื่อมโยง

จุดเชื่อมโยง	คำอธิบาย
`replies`	ดึงข้อมูลรายการความคิดเห็นบน Instagram ที่แสดงอยู่ในความคิดเห็นบน Instagram อีกทีหนึ่ง แสดงความคิดเห็นบน Instagram ในความคิดเห็นบน Instagram อีกทีหนึ่ง

การตอบกลับ

อ็อบเจ็กต์รูปแบบ JSON ที่ประกอบด้วยช่องและจุดเชื่อมโยงเริ่มต้นและที่ส่งคำขอ

{
  "<FIELD>":"<VALUE>",
  ...
}

ตัวอย่าง cURL

คำขอ

curl -i -X GET \
 "https://graph.instagram.com/v25.0/17881770991003328?fields=hidden%2Cmedia%2Ctimestamp&access_token=EAAOc..."

การตอบกลับ

{
  "hidden": false,
  "media": {
    "id": "17856134461174448"
  },
  "timestamp": "2017-05-19T23:27:28+0000",
  "id": "17881770991003328"
}

การอัพเดต

การซ่อน/ยกเลิกการซ่อนความคิดเห็น

POST <HOST_URL>/<IG_COMMENT_ID>?hide=<BOOLEAN>

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

{hide} (ต้องระบุ) — ตั้งค่าเป็น true เพื่อซ่อนความคิดเห็น หรือตั้งค่าเป็น false เพื่อแสดงความคิดเห็น

ข้อจำกัด

ความคิดเห็นที่สร้างโดยเจ้าของอ็อบเจ็กต์สื่อบนอ็อบเจ็กต์สื่อของตนจะแสดงอยู่ตลอด แม้ว่าจะตั้งค่าความคิดเห็นเป็น hide=true ก็ตาม
ระบบไม่รองรับความคิดเห็นในสื่อบน Instagram ที่เป็นวิดีโอถ่ายทอดสด

โทเค็นการเข้าถึง

โทเค็นการเข้าถึงผู้ใช้จากผู้ใช้ที่เป็นเจ้าของอ็อบเจ็กต์สื่อที่ได้รับการแสดงความคิดเห็น

ตัวอย่างคำขอ

การซ่อนความคิดเห็น:

POST graph.instagram.com
  /17873440459141021?hide=true

ตัวอย่างการตอบกลับ

{
  "success": true
}

การลบ

การลบความคิดเห็น

DELETE <HOST_URL>/<IG_COMMENT_ID>

โทเค็นการเข้าถึง

โทเค็นการเข้าถึงผู้ใช้จากผู้ใช้ที่สร้างความคิดเห็น

ข้อจำกัด

มีเพียงเจ้าของอ็อบเจ็กต์เท่านั้นที่สามารถลบความคิดเห็นที่แสดงต่ออ็อบเจ็กต์ดังกล่าวได้ แม้ว่าผู้ใช้ที่พยายามลบความคิดเห็นจะเป็นผู้เขียนความคิดเห็นก็ตาม
ระบบไม่รองรับความคิดเห็นในสื่อบน Instagram ที่เป็นวิดีโอถ่ายทอดสด

ตัวอย่างคำขอ

DELETE graph.instagram.com
  /17873440459141021

ตัวอย่างการตอบกลับ

{
  "success": true
}