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

วันนี้ เราจะปล่อย API กราฟเวอร์ชั่น 10.0 และ API การตลาดเวอร์ชั่น 10.0 ของ Facebook

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

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

โปรดไปที่ฮับโครงการริเริ่มของแพลตฟอร์มเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับแพลตฟอร์มผู้พัฒนาของเรา

ประกาศและการอัพเดต

การรับรองการตรวจสอบการใช้งานข้อมูล

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

ช่วงฤดูใบไม้ร่วงที่ผ่านมา Facebook ได้เปิดตัวการตรวจสอบการใช้งานข้อมูล (DUC) ซึ่งเป็นข้อกำหนดใหม่ที่จะดำเนินการทุกปีเพื่อให้ผู้พัฒนารับรองว่าสิทธิ์การเข้าถึง API ของตนและการใช้งานข้อมูลเป็นไปตามข้อกำหนดแพลตฟอร์มและนโยบายผู้พัฒนาของ Facebook

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

คุณสามารถดูเอกสารสำหรับผู้พัฒนาของเราเพื่อศึกษารายละเอียดเกี่ยวกับวิธีการกรอก DUC ได้ คุณยังสามารถดูข้อมูลเพิ่มเติมในส่วนคำถามที่พบบ่อยของ DUC โดยเฉพาะได้

ระดับของสิทธิ์การเข้าถึงข้อมูล 90 วันและขีดจำกัดข้อมูลของ API กลุ่ม:

ตั้งแต่วันที่ 24 พฤษภาคม 2021 เป็นต้นไป ขณะใช้ API กลุ่ม หน้าต่างสิทธิ์การเข้าถึงข้อมูลที่มีอยู่ของแอพพลิเคชั่นจะจำกัดอยู่ที่ 90 วัน

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

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

ในวันที่ 24 พฤษภาคม 2021 แอพในโหมดการพัฒนาจะสามารถเข้าถึงเนื้อหาของตนเองในกลุ่มสาธารณะและกลุ่มส่วนตัวที่ผู้พัฒนาเป็นผู้ดูแลได้เท่านั้น ซึ่งหมายความว่าแอพจะไม่สามารถเข้าถึงเนื้อหาที่ผู้ใช้กลุ่มอื่นๆ (ที่ไม่มีบทบาทในแอพ) ได้เผยแพร่ เช่น โพสต์และความคิดเห็น

เรียนรู้เพิ่มเติมได้ในบันทึกการเปลี่ยนแปลงเวอร์ชั่น 10.0

ระดับสิทธิ์การเข้าถึง public_profile และสิทธิ์การอนุญาตของอีเมลสำหรับแอพธุรกิจ

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

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

เรียนรู้เพิ่มเติมได้ในบันทึกการเปลี่ยนแปลงเวอร์ชั่น 10.0

การเตือนความจำคำขอการลบข้อมูล

ตามที่ประกาศในวันที่ 10 พฤศจิกายน 2020 ประเภทแอพผู้บริโภคและการเล่นเกมที่ส่งเพื่อขอรับการตรวจสอบแอพหรือเปลี่ยนจากโหมดการพัฒนาเป็นโหมดเผยแพร่จะต้องระบุการเรียกกลับคำขอลบข้อมูลหรือ URL ที่มีคำแนะนำที่ชัดเจนเกี่ยวกับวิธีการส่งคำขอการลบข้อมูลของตนให้กับผู้ใช้ เราวางแผนที่จะบังคับใช้ข้อกำหนดนี้ภายในวันที่ 10 พฤศจิกายน 2022 และจะเตือนผู้พัฒนาแอพก่อนการบังคับใช้ 60 วัน

ตัวเลือกการเปลี่ยนแปลง API AdsInsight กราฟสำหรับโปรเจ็กต์การลดอัตราการใช้งานต่อเนื่อง

UI ของตัวจัดการโฆษณาจะไม่รองรับการรายงานข้อมูลเกณฑ์ชี้วัดข้อมูลเชิงลึกของโฆษณาที่เก่ากว่า 37 เดือนอีกต่อไป API จะแสดงข้อผิดพลาดเมื่อคำขอมีช่วงวันที่เกินกว่าอัตราการใช้งานต่อเนื่อง 37 เดือน เรากำลังปิดการใช้งาน "date_preset = lifetime" และแทนที่ด้วย "date_preset = maximum"

การเปลี่ยนแปลง API กราฟเวอร์ชั่น 10.0 ไปยัง AdsInsight จะมีผลกับ API กราฟเวอร์ชั่นอื่นๆ ทั้งหมดหลังจาก 90 วัน ยกเว้น "date_preset = lifetime" ไม่จำเป็นต้องเปลี่ยนแปลงช่องกรอกข้อมูลที่เจาะจงเรียก จะมีฟังก์ชันการทำงานที่ตั้งไว้ล่วงหน้า และการเรียก "Lifetime" ทั้งหมดจะถูกตั้งค่าเริ่มต้นไว้ที่อัตราการใช้งานต่อเนื่องสูงสุด 37 เดือน

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

• วันที่ปล่อย 23/2/2021:
  • เวอร์ชั่น 10.0
    • เปิดใช้งาน "date_preset = maximum"
    • ปิดใช้งาน "date_preset = lifetime"
    • แสดงข้อผิดพลาดเมื่อคำขอมีช่วงวันที่เกินกว่าอัตราการใช้งานต่อเนื่อง 37 เดือน
  • ตั้งแต่เวอร์ชั่น 9.0 ลงมา
    • ไม่มีการเปลี่ยนแปลงฟังก์ชันการทำงานปัจจุบัน
• การปล่อยโพสต์ 90 วัน - 24/5/2021:
  • ตั้งแต่เวอร์ชั่น 9.0 ลงมา
    • เปิดใช้งาน "date_preset = maximum" (เหมือนกับเวอร์ชั่นใหม่)
    • แสดงข้อผิดพลาดเมื่อคำขอมีช่วงวันที่เกินกว่าอัตราการใช้งานต่อเนื่อง 37 เดือน (เหมือนกับเวอร์ชั่นใหม่)
    • "date_preset = lifetime" ยังสามารถใช้งานได้ แต่จะส่งคืนข้อมูลภายใน 37 เดือนเท่านั้น กล่าวคือจะทำงานเหมือน "ค่าสูงสุด"

เรียนรู้เพิ่มเติมได้ในบันทึกการเปลี่ยนแปลงเวอร์ชั่น 10.0

นโยบายการลบแบบใหม่สำหรับข้อมูลจากภายนอกบน ThreatExchange

ตั้งแต่วันที่ 24 พฤษภาคม 2021 เมื่อพาร์ทเนอร์กำหนด expire_time ในข้อมูลที่อัพโหลดไปยัง ThreatExchange แล้วเราจะ "ลบข้อมูลถาวร" เมื่อถึงเวลาหมดอายุที่ระบุไว้ หากคุณต้องการระบุว่าข้อมูลใช้งานไม่ได้อีกต่อไป ให้ตั้งค่าช่องกรอกข้อมูล "expired_on" เพื่อทำการลบโดยอัตโนมัติ

ก่อนหน้านี้ การลบแบบ "ลบรายการข้อมูล" หมายความว่าเรากำกับเนื้อหาที่หมดอายุว่าหมดอายุแล้ว เราไม่รองรับการลบแบบลบรายการข้อมูลอีกต่อไป และหลังจากเนื้อหาหมดอายุแล้ว เนื้อหาดังกล่าวจะถูกลบถาวรและจะไม่ปรากฏใน ThreatExchange อีกต่อไป

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

คลิกที่นี่เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับการเปลี่ยนแปลง

การเปลี่ยนแปลงการกำหนดเป้าหมายใน API ใหม่

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

เมื่อสร้างกลุ่มเป้าหมายที่คล้ายกัน ผู้ใช้จะเลือกแหล่งที่มาที่คล้ายกันและอัตราส่วนที่ต้องการ ตำแหน่งที่ตั้งของกลุ่มเป้าหมายที่คล้ายกันจะกำหนดตามตำแหน่งที่ตั้งของประเทศในข้อมูลจำเพาะของการกำหนดเป้าหมายแคมเปญ การเปลี่ยนแปลงนี้จะไม่มีผลกับแคมเปญที่มีอยู่ ข้อเปลี่ยนแปลงนี้จะมีผลกับแคมเปญใหม่และแคมเปญที่แก้ไขเท่านั้น

การเปิดใช้หน้าสถานะเผยแพร่ของแพลตฟอร์มใหม่

หน้าสถานะธุรกิจของ Facebook ใหม่จะเพิ่มความโปร่งใสและการสื่อสารเชิงรุกกับผู้พัฒนาภายนอกโดยใช้ผลิตภัณฑ์แพลตฟอร์มของ Facebook หน้านี้จะเป็นศูนย์กลางในการตรวจสอบสถานะแพลตฟอร์มของผลิตภัณฑ์ทางธุรกิจของ Facebook (โฆษณา, WhatsApp Business API, แพลตฟอร์มสำหรับผู้พัฒนา Facebook ฯลฯ) หน้านี้กำลังเผยแพร่สำหรับตัวจัดการโฆษณาและ Whatsapp Business API และจะมีการเพิ่มผลิตภัณฑ์ทางธุรกิจเพิ่มเติมจนถึงเดือนพฤษภาคม 2021

รายการที่เลิกใช้

การเลิกใช้กล่องโต้ตอบเริ่มถ่ายทอดสด

ในวันที่ 24 พฤษภาคม 2021 เราจะเลิกใช้ SDK กล่องโต้ตอบเริ่มถ่ายทอดสด (GLD) การเลิกใช้เครื่องมือการผลิตการถ่ายทอดสดแบบเดิมนี้จะเกิดขึ้นกับ API ทุกเวอร์ชั่น การเปลี่ยนแปลงนี้จะมีผลกับการถ่ายทอดสดบน Facebook เท่านั้น เราสนับสนุนให้ผู้พัฒนาใช้ LiveProducer และ LiveAPI สำหรับโซลูชั่นการผลิตการถ่ายทอดสดตามความต้องการทั้งหมด

โซลูชั่นในการเริ่มถ่ายทอดสดเมื่อเลิกใช้งาน SDK GLD:

• เข้าถึง Live Producer ได้โดยตรงผ่าน facebook.com/live/producer (หรือจุดเข้าใช้งานอื่นๆ บน Facebook เช่นปุ่ม “Live Video” บนเพจหรือโปรไฟล์)
• รวมโซลูชั่นที่กำหนดเองเข้ากับ Live API

เรียนรู้เพิ่มเติมได้ในบันทึกการเปลี่ยนแปลงเวอร์ชั่น 10.0

การเลิกใช้การกําหนดเป้าหมายคนที่เชื่อมต่อกัน

ในวันที่ 24 พฤษภาคม 2021 การกำหนดเป้าหมายคนที่เชื่อมต่อกันจะไม่ได้รับการสนับสนุนอีกต่อไปเมื่อสร้าง/แก้ไขชุดโฆษณา ข้อกำหนดนี้จะมีผลกับแคมเปญใหม่และแคมเปญที่แก้ไขเท่านั้นและจะไม่มีผลกับแคมเปญที่มีอยู่

เรียนรู้เพิ่มเติมได้ในบันทึกการเปลี่ยนแปลงเวอร์ชั่น 10.0

รายการที่ยกเลิกการเลิกใช้งาน

ยกเลิกการเลิกใช้งานตำแหน่งข้อมูล gr:delete:Page/tabs

เมื่อครั้งที่เราเปิดใช้ API กราฟเวอร์ชั่น 8.0 เราได้เลิกใช้ตำแหน่งข้อมูล gr:delete:Page/tabs สำหรับแท็บเพจ เราได้ตัดสินใจที่จะยกเลิกการเลิกใช้งานตำแหน่งข้อมูลนี้ทันทีสำหรับ API กราฟเวอร์ชั่น 10.0 และจะคืนสถานะสิทธิ์การเข้าถึงในวันที่ 24 พฤษภาคม 2021 ในเวอร์ชั่นกราฟอื่นๆ ทั้งหมด

เรียนรู้เพิ่มเติมได้ในบันทึกการเปลี่ยนแปลงเวอร์ชั่น 10.0

ยกเลิกการเลิกใช้งานตำแหน่งข้อมูล gr:post:Business/business_users, gr:post:Business/system_users และ gr:post:User/access_tokens

เมื่อครั้งที่เราเปิดใช้ API เวอร์ชั่น 9.0 เราได้จำกัดสิทธิ์การเข้าถึงตำแหน่งข้อมูลธุรกิจ 3 ตำแหน่ง:

• gr:post:Business/business_users
• gr:post:Business/system_users
• gr:post:User/access_tokens

ตั้งแต่มีการเปิดใช้กราฟเวอร์ชั่น 10.0 เป็นต้นไป เราจะเปิดตำแหน่งข้อมูลเหล่านี้อีกครั้งเพื่อการเรียก API เมื่อแอพตรงตามเงื่อนไขใดเงื่อนไขหนึ่งจากทั้ง 2 เงื่อนไขนี้:

• ธุรกิจเป้าหมายเป็นธุรกิจที่เป็นเจ้าของแอพที่ทำการเรียก
• ธุรกิจเป้าหมายเป็นธุรกิจรอง (ในรูปแบบธุรกิจ 2 ระดับ) ของธุรกิจที่เป็นเจ้าของแอพที่ทำการเรียก

เรียนรู้เพิ่มเติมได้ในบันทึกการเปลี่ยนแปลงเวอร์ชั่น 10.0

ปฏิทินรายการสิ่งที่ต้องทำ

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

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

• 3 มีนาคม 2021: จะเลิกใช้งานและนำ API การตลาดเวอร์ชั่น 7.0 ออกจากแพลตฟอร์ม
• 4 พฤษภาคม 2021: จะเลิกใช้งานและนำ API การตลาดเวอร์ชั่น 8.0 ออกจากแพลตฟอร์ม
• 25 สิงหาคม 2021: จะเลิกใช้งานและนำ API การตลาดเวอร์ชั่น 9.0 ออกจากแพลตฟอร์ม

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

รายการเวอร์ชั่น API กราฟที่เลิกใช้งาน:

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

• 4 พฤษภาคม 2021: จะเลิกใช้งานและนำ API กราฟเวอร์ชั่น 3.2 ออกจากแพลตฟอร์ม
• 3 สิงหาคม 2021: จะเลิกใช้งานและนำ API กราฟเวอร์ชั่น 3.3 ออกจากแพลตฟอร์ม

รายการที่เลิกใช้ทั่วไป

• 24 พฤษภาคม 2021:
  • จะเลิกใช้งานและนำกล่องโต้ตอบเริ่มถ่ายทอดสดออกจากแพลตฟอร์ม
  • จะเลิกใช้งานและนำการกำหนดเป้าหมายคนที่เชื่อมต่อกันออกจากแพลตฟอร์ม

สิ่งที่ผู้พัฒนาต้องดำเนินการ

• การลงทะเบียนแบบเริ่มใหม่: การรับรองการตรวจสอบการใช้งานข้อมูล
  • เมื่อลงทะเบียนแล้วจะต้องดำเนินการให้เสร็จภายใน 60 วัน
  • ส่วนคำถามที่พบบ่อยของ DUC โดยเฉพาะ
• 23 กุมภาพันธ์ 2021: การเปิดใช้ API AdsInsight กราฟจะเปลี่ยนแปลงเฉพาะกราฟเวอร์ชั่น 10.0
• 24 พฤษภาคม 2021:
  • การเปิดใช้ API AdsInsight กราฟจะเปลี่ยนแปลงกราฟตั้งแต่เวอร์ชั่น 9.0 ลงมา
  • การเปลี่ยนแปลงระดับสิทธิ์การเข้าถึงตามการตรวจสอบแอพจะมีผลบังคับใช้
    • การเข้าถึงข้อมูล API กลุ่มจำกัดอยู่ที่ 90 วัน
    • มีการใช้ระดับข้อมูลตามระดับของ API กลุ่ม
    • การเปลี่ยนเป็น public_profile และสิทธิ์การอนุญาตของอีเมลสำหรับแอพธุรกิจจะมีผลบังคับใช้
  • มีการนำนโยบายข้อมูลเกี่ยวกับ “การลบข้อมูลถาวร” แบบใหม่ใน ThreatExchange มาใช้
• 10 พฤศจิกายน 2022: กำหนดเวลาการส่งคำขอการลบข้อมูล