API กราฟ

เวอร์ชั่น 2.5

API กราฟ | API การตลาด

API กราฟเวอร์ชั่น 2.5

เผยแพร่เมื่อวันที่ 7 ตุลาคม 2015 | ใช้งานได้ถึง 12 เมษายน 2018

เวอร์ชั่นนี้หมดอายุไปเมื่อวันที่ 12 เมษายน 2018 โปรดใช้เครื่องมืออัพเกรด API เพื่ออัพเกรดแอพของคุณก่อนวันดังกล่าว เรียนรู้เพิ่มเติมเกี่ยวกับการอัพเกรดแอพได้ที่คู่มือการอัพเกรด

ฟีเจอร์ใหม่

เพจ

  • สิทธิ์การอนุญาต

    • ขณะนี้ GET {user_id}/accounts จำเป็นต้องใช้ manage_pages หรือ pages_show_list โดยอย่างหลังคือสิทธิ์การอนุญาตใหม่ในเวอร์ชั่น 2.5
    • POST {page_id}/call_to_actions และ POST/DELETE {call-to-action-id} จำเป็นต้องใช้สิทธิ์การอนุญาต pages_manage_cta ใหม่ ที่เรานำมาใช้ในเวอร์ชั่น 2.5

  • การจัดการการกระตุ้นให้ดำเนินการ - เพจต่างๆ สามารถจัดการการกระตุ้นให้ดำเนินการบนเพจได้แล้วในขณะนี้ ได้แก่

    • GET page/call_to_actions หรือ GET {call-to-action-id} เพื่ออ่านการกระตุ้นให้ดำเนินการ
    • POST page/call_to_actions เพื่อเพิ่มการกระตุ้นให้ดำเนินการไปยังเพจ
    • POST {call-to-action-id} เพื่ออัพเดต
    • DELETE {call-to-action-id} เพื่อลบการกระตุ้นให้ดำเนินการของเพจ

  • โหนดสถานที่ - มีการเพิ่มช่องต่อไปนี้ไปยังโหนด Place

    • overall_rating - ระบุคะแนนโดยเฉลี่ยตามรีวิวสถานที่แบบสาธารณะ

วิดีโอ

  • การอัพโหลดวิดีโอ - มีการเพิ่มพารามิเตอร์ต่อไปนี้เข้ามา

    • slideshow_spec - สร้างวิดีโอแบบสไลด์โชว์โดยการอัพโหลดรูปภาพ
    • secret - วิดีโอที่เผยแพร่จะไม่ปรากฏบนฟีดข่าวของ Facebook ไทม์ไลน์ หรือแท็บวิดีโอของเพจ และจะไม่สามารถค้นหาได้ ผู้ใช้จะสามารถรับชมและแชร์วิดีโอได้โดยใช้ลิงก์ถาวรเท่านั้น และมีไว้สำหรับผู้ใช้ของเพจเท่านั้น
    • social_actions - เปิดใช้งานหรือห้ามใช้การดำเนินการในโซเชียลของ Facebook เช่น การกดถูกใจ การแสดงความคิดเห็น และการแชร์บนวิดีโอที่ซ่อนไว้ และมีไว้สำหรับผู้ใช้ของเพจเท่านั้น

  • การแก้ไขวิดีโอ - มีการเพิ่มพารามิเตอร์ต่อไปนี้เข้ามา

    • publish_to_videos_tab - เผยแพร่รายการวิดีโอแบบสาธารณะไปยังแท็บวิดีโอของเพจแต่ไม่เผยแพร่ไปยังฟีดข่าวหรือไทม์ไลน์
    • publish_to_news_feed - เผยแพร่รายการวิดีโอแบบสาธารณะไปยังฟีดข่าว ไทม์ไลน์ของเพจ และแท็บวิดีโอของเพจ

การเปลี่ยนแปลง

เพจ

  • ตำแหน่งข้อมูลของโพสต์ที่ถูกแท็ก - GET /{page-id}/tagged จะรวมโพสต์สาธารณะทั้งหมดที่เพจนี้ถูกแท็ก จำเป็นต้องใช้โทเค็นการเข้าถึงเพจที่มีสิทธิ์การอนุญาต manage_pages

โพสต์

  • story_tags - ขณะนี้จะส่งคืนอาร์เรย์ แต่ไม่ส่งคืนอ็อบเจ็กต์

ผู้ใช้

  • GET /{user-id}?fields=address จะส่งคืนข้อผิดพลาด - ช่อง address ซึ่งมีให้ใช้งานในเวอร์ชั่นก่อนหน้าและส่งคืนค่าว่างจะส่งคืนข้อผิดพลาดในเวอร์ชั่น 2.5

Webhooks (ชื่อเดิมคือ “การอัพเดตแบบเรียลไทม์”)

  • ปิดใช้งานการสมัครใช้งานโดยอัตโนมัติ - ตอนนี้เราจะปิดใช้งานการสมัครรับข้อมูล Webhooks โดยอัตโนมัติหากการเรียกกลับ URL ล้มเหลวเป็นเวลา 7 วันติดต่อกัน คุณสามารถเปิดใช้งานใหม่ได้ด้วยการส่งคำขอ POST ไปยัง /subscriptions การเปลี่ยนแปลงนี้ไม่มีผลกับการสมัครรับข้อมูลการชำระเงิน

  • การอัพเดตการสมัครรับข้อมูลที่มีอยู่แล้ว - การสมัครรับข้อมูล Webhooks ที่มีอยู่แล้วอาจได้รับการแก้ไขผ่าน API /subscriptions ส่วน POST /subscriptions จะแก้ไขการสมัครรับข้อมูลหัวข้อที่กำหนดโดยไม่เขียนทับช่องที่มีอยู่แล้ว คุณสามารถลบช่องที่ต้องการออกจากการสมัครรับข้อมูลได้โดยระบุพารามิเตอร์ "fields" เมื่อส่งคำขอ DELETE /subscriptions

การเลิกใช้งาน

  • ไม่มีการเลิกใช้งาน

การเปลี่ยนแปลงที่สำคัญใน 90 วัน

เพจ

  • รูปแบบ URI ของแอพที่อยู่ในแท็บ "เพจ" - รูปแบบ URI ของแอพที่อยู่ในแท็บ "เพจ" https://www.facebook.com/{vanity}?v={app_id} จะใช้งานไม่ได้อีกต่อไปหลังจากเปิดตัวเวอร์ชั่นนี้ไปแล้ว 90 วัน โปรดใช้ https://www.facebook.com/{vanity}?sk={app_id} หรือ https://www.facebook.com/{vanity}/{app_id}

Webhooks

  • การอัพเดตแบบเรียลไทม์แบบใหม่ผ่าน HTTPS เท่านั้น - การสมัครรับข้อมูลแบบใหม่จะไม่สามารถสร้างขึ้นโดยใช้ URL การเรียกกลับที่ไม่ใช่ HTTPS การเปลี่ยนแปลงนี้จะมีผลกับการอัพเดต User, Page, App และ Payment