สื่อของผู้ใช้ Instagram

คือคอลเลกชั่นอ็อบเจ็กต์สื่อบน Instagram ของผู้ใช้ Instagram

การสร้าง

POST /{ig-user-id}/media

• สร้างคอนเทนเนอร์ Instagram ของรูปภาพ, ภาพสไลด์, สตอรี่ หรือคลิป Reels สำหรับใช้ในกระบวนการเผยแพร่โพสต์ โปรดดูขั้นตอนการเผยแพร่ฉบับสมบูรณ์ในคู่มือการเผยแพร่เนื้อหา

ข้อจำกัด

ข้อจำกัดโดยทั่วไป

• คอนเทนเนอร์จะหมดอายุหลังผ่านไป 24 ชั่วโมง
• หากเพจที่เชื่อมต่อกับบัญชี Instagram Professional ที่เป็นเป้าหมายกำหนดให้ต้องผ่านขั้นตอนการอนุญาตการเผยแพร่เพจ (PPA) ก่อน คุณก็จะต้องดำเนินขั้นตอน PPA ให้เสร็จสิ้น ไม่เช่นนั้นคำขอจะล้มเหลว
• หากเพจที่เชื่อมต่อกับบัญชี Instagram Professional ที่เป็นเป้าหมายกำหนดให้ต้องผ่านขั้นตอนการยืนยันตัวตนแบบสองชั้น ผู้ใช้ Facebook จะต้องดำเนินการยืนยันตัวตนแบบสองชั้นด้วยเช่นกัน ไม่เช่นนั้นคำขอจะล้มเหลว
• ระบบไม่รองรับการเผยแพร่ไปยัง Instagram TV

ข้อจำกัดของ Reels

• คลิป Reels ไม่สามารถปรากฏในภาพสไลด์แบบอัลบั้มได้
• ระบบจะคำนึงถึงการตั้งค่าความเป็นส่วนตัวของบัญชีเมื่อเผยแพร่ ตัวอย่างเช่น หากคุณเปิดใช้งาน "อนุญาตให้รีมิกซ์" คลิป Reels ที่เผยแพร่จะได้รับอนุญาตให้รีมิกซ์ได้เมื่อเผยแพร่ แต่คุณสามารถปิดใช้งานการรีมิกซ์บนคลิป Reels ที่เผยแพร่ด้วยตนเองได้ผ่านแอพ Instagram
• การแท็กเพลงจะใช้ได้กับเสียงต้นฉบับเท่านั้น

ข้อจำกัดของสตอรี่

• สตอรี่จะหมดอายุหลังผ่านไป 24 ชั่วโมง
• รองรับ URL ของวิดีโอหรือ URL ของคลิป Reels เพียงอย่างใดอย่างหนึ่ง ไม่ได้รองรับทั้ง 2 อย่าง
• ไม่รองรับการเผยแพร่สติกเกอร์ (เช่น ลิงก์ โพลล์ ตำแหน่ง)

ข้อกำหนด

ข้อมูลจำเพาะของรูปภาพ

• รูปแบบ: JPEG
• ขนาดไฟล์: สูงสุด 8 MB
• อัตราส่วนกว้างยาว: ต้องอยู่ภายในช่วง 4:5 ถึง 1.91:1
• ความกว้างขั้นต่ำ: 320 (ระบบจะขยายให้ถึงความกว้างขั้นต่ำหากจำเป็น)
• ความกว้างสูงสุด: 1440 (ระบบจะย่อให้ไม่เกินความกว้างสูงสุดหากจำเป็น)
• ความสูง: ไม่แน่นอน ขึ้นอยู่กับความกว้างและอัตราส่วนกว้างยาว
• ปริภูมิสี: sRGB ในกรณีที่รูปภาพใช้ปริภูมิสีแบบอื่น ระบบจะแปลงปริภูมิสีของรูปภาพนั้นเป็นแบบ sRGB

ข้อมูลจำเพาะของคลิป Reels

ข้อมูลจำเพาะของคลิป Reels มีดังต่อไปนี้:

• คอนเทนเนอร์: MOV หรือ MP4 (MPEG-4 Part 14) ไม่มีรายการแก้ไข และมี Moov atom ที่ด้านหน้าของไฟล์
• การเข้ารหัสเสียง: AAC, อัตราการสุ่มสูงสุดที่ 48 khz, 1 หรือ 2 ช่อง (โมโนหรือสเตอริโอ)
• การเข้ารหัสวิดีโอ: HEVC หรือ H264, สแกนแบบโพรเกรสซีฟ, GOP แบบปิด, โครมาซับแซมปลิง (Chroma Subsampling) 4:2:0
• อัตราเฟรม: 23-60 FPS
• ขนาดรูปภาพ:

  • คอลัมน์สูงสุด (พิกเซลแนวนอน): 1920
  • อัตราส่วนกว้างยาวต้องอยู่ในช่วงระหว่าง 0.01:1 ถึง 10:1 แต่เราขอแนะนำให้ใช้อัตราส่วน 9:16 เพื่อหลีกเลี่ยงการครอบตัดหรือเกิดพื้นที่ว่าง
• อัตราบิตวิดีโอ: VBR, สูงสุด 25 Mbps
• อัตราบิตเสียง: 128 Kbps
• ระยะเวลา: สูงสุด 15 นาที, ต่ำสุด 3 วินาที
• ขนาดไฟล์: สูงสุด 1 GB

ข้อมูลจำเพาะของรูปภาพหน้าปกสำหรับคลิป Reels มีดังต่อไปนี้:

• รูปแบบ: JPEG
• ขนาดไฟล์: สูงสุด 8 MB
• ปริภูมิสี: sRGB ในกรณีที่รูปภาพใช้ปริภูมิสีแบบอื่น ระบบจะแปลงปริภูมิสีของรูปภาพนั้นเป็นแบบ sRGB
• อัตราส่วนกว้างยาว: เราขอแนะนำให้ใช้อัตราส่วน 9:16 เพื่อหลีกเลี่ยงการครอบตัดหรือเกิดพื้นที่ว่าง หากอัตราส่วนกว้างยาวของรูปภาพต้นฉบับไม่ใช่ 9:16 เราจะครอบตัดรูปภาพและใช้พื้นที่สี่เหลี่ยมผืนผ้าอัตราส่วน 9:16 ที่อยู่ตรงกลางสุดเป็นรูปภาพหน้าปกสำหรับคลิป Reels หากคุณแชร์คลิป Reels ไปที่ฟีดของคุณ เราจะครอบตัดรูปภาพและใช้พื้นที่สี่เหลี่ยมจัตุรัสอัตราส่วน 1:1 ที่อยู่ตรงกลางสุดเป็นรูปภาพหน้าปกสำหรับโพสต์บนฟีดของคุณ

ข้อมูลจำเพาะของรูปภาพในสตอรี่

• รูปแบบ: JPEG
• ขนาดไฟล์: สูงสุด 8 MB
• อัตราส่วนกว้างยาว: เราขอแนะนำให้ใช้อัตราส่วน 9:16 เพื่อหลีกเลี่ยงการครอบตัดหรือเกิดพื้นที่ว่าง
• ปริภูมิสี: sRGB ในกรณีที่รูปภาพใช้ปริภูมิสีแบบอื่น ระบบจะแปลงปริภูมิสีของรูปภาพนั้นเป็นแบบ sRGB

ข้อมูลจำเพาะของวิดีโอในสตอรี่

• คอนเทนเนอร์: MOV หรือ MP4 (MPEG-4 Part 14) ไม่มีรายการแก้ไข และมี Moov atom ที่ด้านหน้าของไฟล์
• การเข้ารหัสเสียง: AAC, อัตราการสุ่มสูงสุดที่ 48 khz, 1 หรือ 2 ช่อง (โมโนหรือสเตอริโอ)
• การเข้ารหัสวิดีโอ: HEVC หรือ H264, สแกนแบบโพรเกรสซีฟ, GOP แบบปิด, โครมาซับแซมปลิง (Chroma Subsampling) 4:2:0
• อัตราเฟรม: 23-60 FPS
• ขนาดรูปภาพ:

  • คอลัมน์สูงสุด (พิกเซลแนวนอน): 1920
  • อัตราส่วนกว้างยาวต้องอยู่ในช่วงระหว่าง 0.1:1 ถึง 10:1 แต่เราขอแนะนำให้ใช้อัตราส่วน 9:16 เพื่อหลีกเลี่ยงการครอบตัดหรือเกิดพื้นที่ว่าง
• อัตราบิตวิดีโอ: VBR, สูงสุด 25 Mbps
• อัตราบิตเสียง: 128 Kbps
• ระยะเวลา: สูงสุด 60 วินาที, ต่ำสุด 3 วินาที
• ขนาดไฟล์: สูงสุด 100 MB

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

คอนเทนเนอร์ของรูปภาพ

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &is_carousel_item={is-carousel-item}
  &caption={caption}
  &location_id={location-id}
  &user_tags={user-tags}
  &product_tags={product-tags}
  &access_token={access-token}

คอนเทนเนอร์ของคลิป Reels

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=REELS
&video_url={reel-url}
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&cover_url={cover-url}
&audio_name={audio-name}
&user_tags={user-tags}
&location_id={location-id}
&thumb_offset={thumb-offset}
&share_to_feed={share-to-feed}
&access_token={access-token}

คอนเทนเนอร์ของภาพสไลด์

คอนเทนเนอร์ของภาพสไลด์เท่านั้น หากต้องการสร้างคอนเทนเนอร์ของรายการภาพสไลด์ ให้สร้างคอนเทนเนอร์ของรูปภาพหรือวิดีโอแทน (ระบบไม่รองรับคลิป Reels) โปรดดูขั้นตอนการเผยแพร่ฉบับสมบูรณ์ในโพสต์แบบภาพสไลด์

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=CAROUSEL
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&location_id={location-id}
&product_tags={product-tags}
&children={children}
&access_token={access-token}

คอนเทนเนอร์สตอรี่ของรูปภาพ

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &media_type=STORIES
  &access_token={access-token}

คอนเทนเนอร์สตอรี่ของวิดีโอ

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?video_url={video-url}
  &media_type=STORIES
  &access_token={access-token}

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

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

การตอบกลับ

อ็อบเจ็กต์รูปแบบ JSON ที่มี ID คอนเทนเนอร์ Instagram ซึ่งคุณสามารถใช้เพื่อเผยแพร่คอนเทนเนอร์ได้

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

{
  "id":"{ig-container-id}"
}

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

POST graph.facebook.com/17841400008460056/media ?image_url=https//www.example.com/images/bronzed-fonzes.jpg &caption=#BronzedFonzes! &collaborators= [‘username1’,’username2’] &user_tags=[ { username:'kevinhart4real', x: 0.5, y: 0.8 }, { username:'therock', x: 0.3, y: 0.2 } ] 

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

{
  "id": "17889455560051444"
}

การอ่าน

GET /{ig-user-id}/media

ดึงข้อมูลสื่อบน Instagram ทั้งหมดของผู้ใช้ Instagram

ข้อจำกัด

• ส่งคืนสื่อที่สร้างขึ้นล่าสุดได้สูงสุด 10,000 รายการ
• ระบบไม่รองรับสื่อบน Instagram ที่เป็นสตอรี่ ให้ใช้ตำแหน่งข้อมูล GET /{ig-user-id}/stories แทน

ข้อกำหนด

การแบ่งหน้าโดยอิงจากเวลา

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

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

GET graph.facebook.com/17841405822304914/media 

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

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ]
}

การอัพเดต

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

การลบ

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