API กราฟ

เวอร์ชั่น 3.1

ออกเมื่อ 26 กรกฎาคม 2018 | ใช้ได้ถึง 27 ตุลาคม 2020 | บล็อกโพสต์

ทั่วไป

การเปลี่ยนแปลงเหล่านี้จะนำไปใช้กับ v3.1 ขึ้นไป และจะนำไปใช้กับทุกเวอร์ชั่นในวันที่ 24 ตุลาคม 2018

ปลายทาง API กราฟทั้งหมดจะส่งกลับโครงสร้างที่ว่างทั้งหมดเป็น {} และรายการที่ว่างทั้งหมดเป็น []

API การถ่ายทอดสด

การเปลี่ยนแปลงเหล่านี้จะนำไปใช้กับ v3.1 ขึ้นไป และจะนำไปใช้กับทุกเวอร์ชั่นในวันที่ 24 ตุลาคม 2018

พารามิเตอร์ type จะถูกเลิกใช้กับจุดเชื่อมโยงต่อไปนี้ ซึ่งจะแทนที่ด้วยพารามิเตอร์ source

  • /event/live_videos
  • /group/live_videos
  • /official_events/live_videos
  • /page/live_videos
  • /user/live_videos

พารามิเตอร์ source ใหม่สามารถยอมรับหนึ่งในสองค่าที่เป็นไปได้ ได้แก่: target และ owner จุดเชื่อมโยง /live_videos ของโหนดการสืบค้นที่มี source=target จะส่งกลับวิดีโอถ่ายทอดสดที่สตรีมไปยังโหนดดังกล่าว ขณะที่การสืบค้นสำหรับ source=owner จะส่งกลับวิดีโอถ่ายทอดสดที่สตรีมโดยโหนดดังกล่าว

โหนดเหตุการณ์และกลุ่มจะรองรับการสืบค้น target เท่านั้น และการสืบค้น target บางรายการอาจล้มเหลวหากคุณไม่มีสิทธิ์การอนุญาตเพื่อดูโหนดเป้าหมาย

API การตลาด

ออกเมื่อ 26 กรกฎาคม 2018 | ใช้ได้ถึง 14 พฤษภาคม 2019 | บล็อกโพสต์

การจัดการโฆษณา

  • หมวดหมู่การกำหนดเป้าหมายตามพฤติกรรม - เราได้เลิกใช้ตัวเลือกการกำหนดเป้าหมายตามพฤติกรรมบางรายการที่ใช้ใน behaviors หากคุณพยายามสร้างโฆษณาด้วยหมวดหมู่ใดหมวดหมู่หนึ่งดังกล่าว คุณจะได้รับข้อผิดพลาด The category you selected is no longer available. หากต้องการตรวจสอบดูหมวดหมู่ใดที่ใช้ได้สำหรับการกำหนดเป้าหมาย ให้ใช้การค้นหาการกำหนดเป้าหมาย

  • เลิกใช้PAGE_ENGAGEMENTในฐานะoptimization_goal แล้ว - เราได้เลิกใช้ PAGE_ENGAGEMENT ในฐานะ optimization_goal สำหรับแคมเปญโฆษณาแล้ว ตั้งแต่เวอร์ชั่น 3.1 เป็นต้นไป คุณจะไม่สามารถสร้าง อัพเดต หรือทำแคมเปญโฆษณาซ้ำได้อีกต่อไป ด้วยการตั้งค่า optimization_goal เป็น PAGE_ENGAGEMENT หากคุณมีแคมเปญโฆษณาที่สร้างไว้ก่อนเวอร์ชั่น 3.1 คุณยังสามารถแสดงแคมเปญเหล่านี้ด้วยการตั้งค่านี้ได้ นอกจากนั้น คุณยังสามารถใช้ PAGE_ENGAGEMENT เป็นข้อมูลแยกย่อยของ API ข้อมูลเชิงลึกสำหรับข้อมูลของแคมเปญโฆษณาที่มีอยู่โดยใช้ optimization_goal

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

  • ไม่มีการดึงข้อมูลโฆษณาแบบกรอกฟอร์มผ่าน Webhooks สำหรับระดับผู้พัฒนา - เราจะหยุดส่งข้อมูลที่เก็บรวบรวมในโฆษณาแบบกรอกฟอร์มผ่าน Webhooks ไปยังแอพต่างๆ ในโหมดผู้พัฒนา เราจะเริ่มบังคับใช้การเปลี่ยนแปลงนี้ในวันที่ 1 กุมภาพันธ์ 2019

    • หากคุณสมัครรับข้อมูลการอัพเดตเวอร์ชั่น 3.1 เราจะไม่ส่งการอัพเดตใดๆ ยกเว้นว่าคุณจะกำลังใช้งานแอพจริงและอยู่ในโหมดเผยแพร่สด

    • หากคุณสร้างแอพใหม่หลังจากที่เวอร์ชั่น 3.1 มีให้ใช้งานแล้ว เราจะไม่ส่งการอัพเดตใดๆ ยกเว้นว่าคุณจะกำลังใช้งานแอพจริงและอยู่ในโหมดเผยแพร่สด

    • หากคุณมีแอพที่ใช้งานอยู่ แอพนั้นจะต้องอยู่ในโหมดเผยแพร่สดก่อนวันที่ 1 กุมภาพันธ์ 2019 คุณต้องรับการอัพเดตในโหมดผู้พัฒนาต่อไปจนกว่าจะถึงวันที่ดังกล่าว

    สำหรับข้อมูลเพิ่มเติมเกี่ยวกับระดับการเข้าถึง API การตลาดและโหมดของแอพ โปรดดูที่ "โครงสร้างใหม่สำหรับการเข้าถึง API การตลาด" และ "API การตลาด, การเข้าถึงและการยืนยันตัวตน"

ข้อมูลเชิงลึกของโฆษณาและการวัดผล

  • เราได้เปลี่ยนชื่อ cost_per_store_visit และ store_visits สำหรับส่วน API ข้อมูลเชิงลึกเป็น cost_per_store_visit_actions และ store_visit_actions สิ่งนี้ส่งผลกระทบต่อ:

    • GET {adaccount-id}/insights

    • GET {campaign-id}/insights

    • GET {adset-id}/insights

    • GET {ad-id}/insights

    • POST {adaccount-id}/insights

    • POST {campaign-id}/insights

    • POST {adset-id}/insights และ

    • POST {ad-id}/insights

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

API ตัวจัดการธุรกิจ

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

บทบาท งาน คำอธิบาย

ADMIN

['MANAGE', 'ADVERTISE', 'ANALYZE']

จัดการทุกด้านของแคมเปญ การรายงาน การเรียกเก็บเงิน และสิทธิ์การอนุญาตบัญชีผู้ใช้โฆษณา

GENERAL_USER

['ADVERTISE', 'ANALYZE']

สร้างโฆษณาโดยใช้แหล่งเงินทุนที่เกี่ยวข้องกับบัญชีผู้ใช้โฆษณา เรียกใช้รายงาน

GENERAL_USER

['ANALYZE']

เรียกใช้รายงาน

ซึ่งจะแทนบทบาทต่อไปนี้ใน API ตัวจัดการธุรกิจด้วยงานเหล่านี้:

บทบาท งาน

MANAGER

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

CONTENT_CREATOR

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

MODERATOR

['MODERATE', 'ADVERTISE', 'ANALYZE']

ADVERTISER

['ADVERTISE', 'ANALYZE']

INSIGHTS_ANALYST

['ANALYZE']

สำหรับการจัดการพิกเซลของ Facebook จะส่งผลต่อบทบาทเหล่านี้และทำให้มีงานใหม่ดังนี้:

บทบาท งาน

PIXEL_EDITOR

['EDIT', 'ANALYZE']

PIXEL_ANALYST

['ANALYZE']

เนื่องจากการเปลี่ยนแปลงนี้ เราจะเลิกใช้และแทนฟิลด์ API การจัดการธุรกิจดังต่อไปนี้:

หัวข้อ เลิกใช้แล้ว ฟิลด์ใหม่

GET {adaccount-id}/users

permissions, role

tasks

POST {adaccount-id}/users

role, uidRoles, emailRoles

tasks

GET {user-id}/adaccounts

permissions, role

tasks

GET {user-id}/assigned_ad_accounts

role, permitted_role

tasks, permitted_tasks

GET {user-id}/assigned_pages

role, permitted_role

tasks, permitted_tasks

GET {adaccount-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

POST {adaccount-id}/assigned_users

role

tasks

GET {page-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

POST {page-id}/assigned_users

role

tasks

GET {fb-pixel-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

GET {adaccount-id}/userpermissions

role

tasks

POST {adaccount-id}/userpermissions

role

tasks

GET {page-id}/userpermissions

role

tasks

POST {page-id}/userpermissions

role

tasks

GET {business-id}/client_ad_accounts

permitted_role

permitted_tasks

POST {business-id}/client_ad_accounts

permitted_role

permitted_tasks

GET {business-id}/client_pages

permitted_role

permitted_tasks

POST {business-id}/client_pages

permitted_role

permitted_tasks

GET {business-id}/client_pixels

permitted_role

permitted_tasks

GET {adaccount-id}/agencies

permitted_role

permitted_tasks

POST {adaccount-id}/agencies

permitted_role

permitted_tasks

GET {page-id}/agencies

permitted_role

permitted_tasks

POST {page-id}/agencies

permitted_role

permitted_tasks

GET {business-id}/pending_client_pages

permitted_role

permitted_tasks

GET {business-id}/pending_client_ad_accounts

permitted_role

permitted_tasks

การออกแบบใหม่นี้ยังส่งผลต่อ API เพจ โปรดดูที่ "API กราฟ 3.1, API เพจ, การเปลี่ยนแปลงที่สำคัญ" โปรดดูเอกสารประกอบเกี่ยวกับ API ตัวจัดการธุรกิจที่:

แพลตฟอร์ม Messenger

สำหรับแอพที่สร้างก่อนวันที่ 26 กรกฎาคม 2018 การเปลี่ยนแปลงเหล่านี้จะมีผลในวันที่ 8 มกราคม 2019 การเปลี่ยนแปลงเหล่านี้จะมีผลทันทีสำหรับแอพที่สร้างขึ้นหลังวันที่ 26 กรกฎาคม 2018

ในขณะนี้ API โปรไฟล์ผู้ใช้จะส่งคืนช่อง first_name, last_name และ profile_pic เท่านั้นตามค่าเริ่มต้น ในตอนนี้ ช่องเพิ่มเติมต่างๆ จะต้องมีการตรวจสอบผลิตภัณฑ์ผ่านแท็บแพลตฟอร์ม Messenger ของแดชบอร์ดของแอพ

เราได้เลิกใช้ช่อง last_ad_referral และ is_payment_enabled แล้ว และจะนำออกจาก API ในวันที่ 30 ตุลาคม 2018

API เพื่อนที่มีร่วมกัน

การเปลี่ยนแปลงเหล่านี้จะนำไปใช้กับ v3.1 ขึ้นไป และจะนำไปใช้กับทุกเวอร์ชั่นในวันที่ 24 ตุลาคม 2018

API เพื่อนที่มีร่วมกันจะถูกเลิกใช้ในวันที่ 4 เมษายน 2018 และปลายทางด้านล่างจะส่งคืนชุดข้อมูลที่มีค่าว่างเปล่า ปลายทางดังกล่าวจะถูกเลิกใช้อย่างสมบูรณ์และจะส่งคืนข้อความแสดงข้อผิดพลาด

  • /user-context/all_mutual_friends
  • /user-context/mutual_friends
  • /user-context/three_degree_mutual_friends

API เพจ

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

การเปลี่ยนแปลงต่อไปนี้จะนำไปใช้กับ v3.1 ขึ้นไป และจะนำไปใช้กับทุกเวอร์ชั่นในวันที่ 1 กุมภาพันธ์ 2019

สิทธิ์การอนุญาต pages_manage_ctaจะกำหนดให้ต้องมีการตรวจพิจารณาแอพ สำหรับคำขอ POST และ DELETE ทั้งหมด แอพที่สร้างก่อนวันที่ 26 กรกฎาคม 2018 จะยังคงใช้สิทธิ์การอนุญาตนี้ต่อไป แต่จะต้องส่งเข้ารับการตรวจพิจารณาก่อนวันที่ 1 กุมภาพันธ์ 2019 เพื่อใช้งาน pages_manage_cta ต่อ

บทบาทในเพจ

การเปลี่ยนแปลงต่อไปนี้จะนำไปใช้กับเวอร์ชั่น 3.1 ขึ้นไป

บทบาทในเพจอยู่ในระหว่างการเลิกใช้งานและจะถูกแทนที่ด้วยงานในเพจ โดยในขณะนี้ คุณจะไม่ได้มอบบทบาทในเพจให้กับผู้ใช้ แต่จะต้องมอบงานที่เทียบเท่ากันให้แก่ผู้ใช้แทน

บทบาทงานที่เทียบเท่า

Admin

ADVERTISE, ANALYZE, CREATE_CONTENT, MANAGE, MODERATE

Advertiser

ADVERTISE, ANALYZE

Analyst

ANALYZE

Editor

ADVERTISE, ANALYZE, CREATE_CONTENT, MODERATE

Moderator

ADVERTISE, ANALYZE, MODERATE

จนกว่าสิทธิ์การอนุญาตตามบทบาทจะถูกแทนที่ด้วยสิทธิ์การอนุญาตตามงานอย่างสมบูรณ์ เมื่อกำหนดงานผ่าน /page/roles คุณจะต้องกำหนดงานที่เทียบเท่าของบทบาทมิเช่นนั้นการดำเนินการ POST จะล้มเหลว

เพื่อรองรับการเปลี่ยนแปลงเหล่านี้ ช่อง perms และ role จะถูกเลิกใช้และแทนที่ด้วยช่อง tasks ใหม่ สิ่งนี้ส่งผลกระทบต่อจุดเชื่อมโยงต่อไปนี้:

  • /me/accounts
  • /page/roles
  • /user/accounts

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

Webhooks

การเปลี่ยนแปลงเหล่านี้จะนำไปใช้กับ v3.1 ขึ้นไป และจะนำไปใช้กับทุกเวอร์ชั่นในวันที่ 24 ตุลาคม 2018

ช่องผู้ใช้ Webhook ต่อไปนี้จะถูกเลิกใช้งาน

  • pic_big_with_logo
  • pic_small_with_logo
  • pic_square_with_logo
  • pic_with_logo

ช่องผู้ใช้ Webhook ต่อไปนี้จะใช้ URL แบบ HTTPS แทน HTTP

  • pic
  • pic_big
  • pic_small
  • pic_square
  • picture

นอกจากนี้ URL สำหรับช่องเหล่านี้จะหมดอายุ ซึ่งจะส่งผลต่อ API ทุกเวอร์ชั่นทันที