คอนเทนเนอร์ Instagram (IG)

หมายถึงคอนเทนเนอร์สื่อสำหรับการเผยแพร่อ็อบเจ็กต์สื่อบน Instagram

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User 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_content_publish
  • instagram_basic
  • instagram_content_publish
  • 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_CONTAINER_ID>

ดึงข้อมูลช่องและจุดเชื่อมโยงต่างๆ ในคอนเทนเนอร์ Instagram

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

GET <HOST_URL>/<API_VERSION>/<IG_CONTAINER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

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

พารามิเตอร์ค่า

access_token
จำเป็นต้องระบุ
สตริง

โทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ

fields
รายการที่คั่นด้วยเครื่องหมายจุลภาค

รายการช่องและจุดเชื่อมโยงที่คั่นด้วยเครื่องหมายจุลภาคที่คุณต้องการให้ส่งคืน หากไม่ได้ระบุ จะส่งคืนช่องเริ่มต้น

ช่อง

ชื่อช่องคำอธิบาย

copyright_check_status

ใช้เพื่อพิจารณาว่าวิดีโอที่อัพโหลดละเมิดลิขสิทธิ์หรือไม่ โดยคู่คีย์-ค่าจะส่งคืนค่าที่ประกอบด้วย:

  • matches_found ที่ตั้งค่าเป็นอย่างใดอย่างหนึ่งต่อไปนี้
    • true – วิดีโอละเมิดลิขสิทธิ์
    • false – วิดีโอไม่ละเมิดลิขสิทธิ์
  • status ที่ตั้งค่าเป็นอย่างใดอย่างหนึ่งต่อไปนี้
    • completed – กระบวนการตรวจหาเสร็จสิ้นแล้ว
    • error – มีข้อผิดพลาดเกิดขึ้นระหว่างกระบวนการตรวจหา
    • in_progress – กระบวนการตรวจหากำลังดำเนินอยู่
    • not_started – กระบวนการตรวจหายังไม่เริ่มต้น

id

ID คอนเทนเนอร์ Instagram ซึ่งจะแสดงในตัวอย่างโค้ดเป็น <IG_CONTAINER_ID>

status

สถานะการเผยแพร่ หาก status_code ระบุว่า ERROR ค่านี้จะเป็นรหัสข้อผิดพลาดย่อย

status_code

สถานะการเผยแพร่ของคอนเทนเนอร์ ค่าที่เป็นไปได้:


  • EXPIRED — คอนเทนเนอร์ไม่ได้รับการเผยแพร่ภายใน 24 ชั่วโมงและหมดอายุแล้ว
  • ERROR — คอนเทนเนอร์ไม่สามารถดำเนินกระบวนการเผยแพร่ให้เสร็จสมบูรณ์ได้
  • FINISHED — คอนเทนเนอร์และอ็อบเจ็กต์สื่อพร้อมสำหรับการเผยแพร่แล้ว
  • IN_PROGRESS — คอนเทนเนอร์ยังอยู่ระหว่างกระบวนการเผยแพร่
  • PUBLISHED — อ็อบเจ็กต์สื่อของคอนเทนเนอร์ได้รับการเผยแพร่แล้ว

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

ไม่มีจุดเชื่อมโยงบนโหนดนี้

การตอบกลับ

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

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

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

curl -X GET \
  'https://graph.instagram.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

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

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

การอัพเดต

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

การลบ

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