Introducing Facebook Graph API v12.0 and Marketing API v12.0

โดย Mengjiao Zhu

ในวันนี้ เรากำลังเปิดให้ใช้งาน API กราฟเวอร์ชั่น 12.0 และ API การตลาดเวอร์ชั่น 12.0 ของ Facebook โดยเราได้กล่าวถึงการเปลี่ยนแปลงที่จะส่งผลต่อชุมชนผู้พัฒนาในส่วนต่างๆ ไว้ที่ด้านล่างนี้ การเปลี่ยนแปลงเหล่านี้ ได้แก่ การประกาศและการอัพเดตผลิตภัณฑ์ การเตือนความจำจากการเปิดตัวก่อนหน้านี้ และการแจ้งเตือนเกี่ยวกับการเลิกใช้งานในวงกว้าง ซึ่งอาจส่งผลกระทบต่อการผสานการทำงานแอพพลิเคชั่นของคุณกับแพลตฟอร์มของเรา

โปรดไปที่บันทึกการเปลี่ยนแปลงของเราเพื่อดูรายการที่ครบถ้วนเกี่ยวกับการเปลี่ยนแปลงและรายละเอียดทั้งหมด

การประกาศและการอัพเดตทั่วไป

API คอนเวอร์ชั่น: การขยายเวอร์ชั่นขั้นต่ำที่เรียกใช้ได้

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

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

API โปรไฟล์ผู้ใช้สำหรับการส่งข้อความบน Instagram: ช่องใหม่

เรากำลังดำเนินการเพิ่มประสิทธิภาพ API โปรไฟล์ผู้ใช้สำหรับการส่งข้อความบน Instagram ก่อนหน้านี้ API โปรไฟล์ผู้ใช้สำหรับ Instagram รองรับช่องอยู่ 2 รายการ ได้แก่ 1) ชื่อและ 2) URL ของรูปโปรไฟล์ ทั้งนี้ เพื่อช่วยให้ธุรกิจต่างๆ ปรับข้อความให้เหมาะกับแต่ละบุคคลและจัดลำดับความสำคัญได้ยิ่งดีขึ้นตามข้อมูลของผู้ใช้ที่เผยแพร่แบบสาธารณะ เราจึงได้อัพเดต API ให้รวมข้อมูลต่อไปนี้ด้วย:

1. จำนวนผู้ติดตาม
2. เครื่องหมายการตรวจสอบยืนยัน
3. ธุรกิจติดตามบัญชีผู้ใช้ [ใช่/ไม่ใช่]
4. บัญชีผู้ใช้ติดตามบัญชีธุรกิจ [ใช่/ไม่ใช่]

โปรดดูรายละเอียดในเอกสารประกอบของผู้พัฒนา

โอกาสใหม่ๆ ในการกำหนดเป้าหมายแบบละเอียด

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

API วิดีโอ: ช่องใหม่

เราได้เพิ่มช่องใหม่ 2 ช่อง ได้แก่ views และ post_views ไปยังโหนด [วิดีโอ] โปรดดูข้อมูลเพิ่มเติมที่เอกสารประกอบของผู้พัฒนาเกี่ยวกับ API วิดีโอ

การเลิกใช้งานและการเปลี่ยนแปลงที่มีผลต่อการทำงาน

ความโปร่งใสของข้อผิดพลาด

ลักษณะการทำงานเริ่มต้นของ API กราฟและ API การตลาด คือ จะส่งข้อผิดพลาด (Error) เมื่อแอพส่งคำขอช่องหรือจุดเชื่อมโยงบนโหนดที่ส่งคืนโหนดที่เกี่ยวข้องจำนวน 1 โหนดหรือมากกว่านั้น แต่ไม่มีสิทธิ์การอนุญาตที่เหมาะสมที่โหนดที่เกี่ยวข้องจำเป็นต้องใช้ อย่างไรก็ตาม หากแอพที่เรียกใช้ไม่มีสิทธิ์การอนุญาตที่เหมาะสม ช่องและจุดเชื่อมโยงมากมายเหล่านี้ก็จะถือว่าไม่เป็นไปตามโปรโตคอลดังกล่าวและจะไม่รวมอยู่ในการตอบกลับ API

ตั้งแต่เวอร์ชั่น 12.0 เป็นต้นไป ช่องและจุดเชื่อมโยงเหล่านี้จะเป็นไปตามลักษณะการทำงานเริ่มต้น โดยการเปลี่ยนแปลงนี้จะมีผลกับทุกเวอร์ชั่นในวันที่ 13 ธันวาคม 2021

ผู้ใช้ระบบและบทบาทในแอพ

เรากำลังจะยกเลิกไม่ให้มีการมอบบทบาทในแอพให้แก่ผู้ใช้ระบบ เว้นแต่ผู้ใช้และแอพต่างอยู่ในธุรกิจเดียวกัน เราขอแนะนำให้ลบผู้ใช้ระบบเหล่านี้ออกจากแอพของคุณและใช้ API การดำเนินการในนามธุรกิจแทนเพื่อป้องกันไม่ให้แอพและธุรกิจของคุณต้องหยุดชะงักลง การเปลี่ยนแปลงที่มีผลต่อการทำงานนี้จะมีผลบังคับใช้ในวันที่ 13 ธันวาคม 2021

การถ่ายทอดสดที่กำหนดเวลา

เรากำลังจะเลิกใช้งานพารามิเตอร์ planned_start_time ภายในขีดความสามารถในการกำหนดเวลาใน Live API และการเปลี่ยนแปลงที่มีผลต่อการทำงานนี้จะมีผลบังคับใช้ในวันที่ 13 ธันวาคม 2021 เราจะประกาศใช้พารามิเตอร์ใหม่ในภายหลัง

แพลตฟอร์ม Messenger: API การสนทนา

เรากำลังจะเลิกใช้ช่อง user_id จากเมตาดาต้าเธรดใน API การสนทนา ผู้พัฒนาทุกรายจะต้องย้ายข้อมูลอ้างอิงต่างๆ ไปยัง user_id (IGID) และใช้ IGSID เป็นตัวระบุหลักของเธรดระหว่างผู้ใช้กับธุรกิจอย่างเต็มรูปแบบ

การเปลี่ยนแปลงที่มีผลต่อการทำงานนี้จะมีผลบังคับใช้กับ API กราฟเวอร์ชั่นต่างๆ ก่อนหน้านี้ในวันที่ 13 ธันวาคม 2021 โปรดดูข้อมูลเพิ่มเติมที่เอกสารประกอบของผู้พัฒนาเกี่ยวกับ API การสนทนา

แพลตฟอร์ม Messenger: Webhooks สำหรับ Instagram

เรากำลังอัพเดต Messenger API สำหรับ Webhook ความรู้สึกบน IG เพื่อให้รองรับการแสดงความรู้สึกผ่านอีโมจิได้ดียิ่งขึ้น เวอร์ชั่นปัจจุบันจะส่งคืนช่อง “emoji” เป็นแบบสตริง แต่การอัพเดตนี้จะทำให้ Webhooks ความรู้สึกส่งคืนช่องดังกล่าวเป็นรูปแบบ Unicode ใหม่ โปรดทราบว่าช่อง “reaction” จะรองรับเฉพาะอีโมจิเริ่มต้นเท่านั้น สำหรับอีโมจิอื่นๆ ทั้งหมด ช่อง “reaction” จะส่งคืนค่า “other” เช่นเดียวกับ MSGR

ตั้งแต่วันที่ 13 ธันวาคม 2021 เป็นต้นไป การเปลี่ยนแปลงที่มีผลต่อการทำงานนี้จะมีผลบังคับใช้กับ API กราฟเวอร์ชั่นต่างๆ ก่อนหน้านี้ หากต้องการรองรับการแสดงความรู้สึกผ่านอีโมจิต่อไป ผู้พัฒนาทุกรายจำเป็นต้องย้ายไปใช้ Unicode แบบใหม่ที่เราจะส่งคืน โดยให้ดำเนินการภายในวันที่ 13 ธันวาคม 2021 โปรดดูรายละเอียดในเอกสารประกอบของผู้พัฒนาเกี่ยวกับ Webhook

การเลิกใช้งาน API เวอร์ชั่นต่างๆ:

โปรดทราบว่าเรากำลังจะเลิกใช้งานเวอร์ชั่นต่อไปนี้ โดยถือเป็นส่วนหนึ่งของกำหนดเวลาในการกำหนดเวอร์ชั่น API กราฟและ API การตลาดของ Facebook:

API กราฟ

2 พฤศจิกายน 2021: API กราฟเวอร์ชั่น 4.0 จะถูกเลิกใช้งานและลบออกจากแพลตฟอร์ม
3 กุมภาพันธ์ 2022: API กราฟเวอร์ชั่น 5.0 จะถูกเลิกใช้งานและลบออกจากแพลตฟอร์ม
22 พฤษภาคม 2022: API กราฟเวอร์ชั่น 6.0 จะถูกเลิกใช้งานและลบออกจากแพลตฟอร์ม

เราขอแนะนำให้ย้ายการเรียกใช้ทั้งหมดไปยัง API เวอร์ชั่นล่าสุดที่เปิดตัวในวันนี้ เพื่อหลีกเลี่ยงไม่ให้ธุรกิจของคุณต้องหยุดชะงักลง

API การตลาด

API การตลาดเวอร์ชั่น 10.0 จะถูกเลิกใช้งานในวันที่ 4 ตุลาคม 2021
API การตลาดเวอร์ชั่น 11.0 จะถูกเลิกใช้งานในวันที่ 23 กุมภาพันธ์ 2022

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

SDK ของแพลตฟอร์ม Facebook

เมื่อวันที่ 19 มกราคม 2021 เราได้ประกาศกำหนดเวลาในการเลิกใช้งานภายในระยะเวลา 2 ปีสำหรับ SDK ของแพลตฟอร์ม Facebook เวอร์ชั่น 8.x และเวอร์ชั่นที่เก่ากว่านั้น โดยเวอร์ชั่นเหล่านี้จะสิ้นสุดลงในเดือนมกราคม 2023
เมื่อวันที่ 8 มิถุนายน 2021 เราได้เปิดตัว SDK ของแพลตฟอร์ม Facebook เวอร์ชั่น 11.0 ซึ่งเป็นการเริ่มต้นการเลิกใช้งาน SDK ของแพลตฟอร์ม Facebook เวอร์ชั่น 9.0 ภายในระยะเวลา 2 ปี โดย SDK เวอร์ชั่น 9.0 จะสิ้นสุดลงในเดือนมิถุนายน 2023