Phiên bản 2.5

API Đồ thị | API Marketing

API Đồ thị v2.5

Ngày phát hành 07/10/2015 | Ngày hết hạn 12/04/2018

Tính năng mới

• Trang
• Video

Trang

• Quyền

  • GET {user_id}/accounts hiện cần có quyền manage_pages hoặc pages_show_list - đây là quyền mới trong v2.5.
  • POST {page_id}/call_to_actions và POST/DELETE {call-to-action-id} cần có quyền mới pages_manage_cta - quyền này được giới thiệu trong v2.5.

• Quản lý nút kêu gọi hành động - Trang hiện có thể quản lý các nút kêu gọi hành động trên Trang:

  • GET page/call_to_actions hoặc GET {call-to-action-id} để đọc nút kêu gọi hành động.
  • POST page/call_to_actions để thêm nút kêu gọi hành động vào trang.
  • POST {call-to-action-id} để cập nhật.
  • DELETE {call-to-action-id} để xóa nút kêu gọi hành động trên Trang.

• Nút Địa điểm - Chúng tôi đã thêm trường sau vào nút Place:

  • overall_rating - Trường này cung cấp kết quả xếp hạng trung bình dựa trên những bài đánh giá công khai về một địa điểm.

Video

• Tải lên video - Chúng tôi đã thêm các thông số sau:

  • slideshow_spec - Tạo video bản trình chiếu bằng cách tải hình ảnh lên.
  • secret - Video đã đăng sẽ không xuất hiện trên Bảng tin Facebook, Dòng thời gian hoặc tab video của Trang và không thể tìm kiếm. Bạn chỉ có thể xem và chia sẻ video qua một liên kết vĩnh viễn. Chỉ dành cho người dùng trang.
  • social_actions - Cho phép hoặc cấm sử dụng các hành động trên mạng xã hội của Facebook như thích, bình luận và chia sẻ trên video ẩn. Chỉ dành cho người dùng trang.

• Chỉnh sửa video - Chúng tôi đã thêm các thông số sau:

  • publish_to_videos_tab - Phân phối công khai các mục video đến tab Video của Trang, thay vì đến Bảng tin hoặc Dòng thời gian.
  • publish_to_news_feed - Phân phối công khai các mục video đến Bảng tin, Dòng thời gian của Trang và tab Video của Trang.

Các thay đổi

• Trang
• Bài viết
• Người dùng
• Webhooks

Trang

• Điểm cuối Bài viết được gắn thẻ - GET /{page-id}/tagged sẽ bao gồm tất cả bài viết công khai mà trang đã được gắn thẻ. Bạn cần có mã truy cập trang có quyền manage_pages.

Bài viết

• story_tags - Hiện trả về mảng, thay vì đối tượng.

Người dùng

• GET /{user-id}?fields=address trả về lỗi - Trường address chỉ có trong các phiên bản trước đó và trả về giá trị trống. Kể từ v2.5, trường này sẽ trả về lỗi.

Webhooks (Trước đây gọi là Thông tin cập nhật theo thời gian thực)

• Tự động vô hiệu hóa gói đăng ký - Giờ đây, chúng tôi tự động vô hiệu hóa gói đăng ký Webhooks nếu URL gọi lại không thành công trong 7 ngày liên tục. Bạn có thể kích hoạt lại gói đăng ký bằng cách gửi yêu cầu POST đến /subscriptions. Thay đổi này không áp dụng cho gói đăng ký thanh toán.

• Cập nhật gói đăng ký hiện có - Bạn có thể sửa đổi gói đăng ký Webhooks hiện có bằng API /subscriptions. POST /subscriptions sẽ sửa đổi gói đăng ký cho một chủ đề cụ thể mà không ghi đè các trường hiện có. Bạn có thể xóa các trường cụ thể khỏi gói đăng ký bằng cách thêm thông số trường khi gọi DELETE /subscriptions.

Ngừng hoạt động

• Không có thành phần nào ngừng hoạt động.

Các thay đổi quan trọng trong 90 ngày

• Trang
• Webhooks

Trang

• Định dạng URI cho ứng dụng Tab Trang - Định dạng URI cho ứng dụng Tab Trang https://www.facebook.com/{vanity}?v={app_id} sẽ không còn hoạt động sau 90 ngày kể từ bản phát hành này. Vui lòng sử dụng https://www.facebook.com/{vanity}?sk={app_id} hoặc https://www.facebook.com/{vanity}/{app_id}.

Webhooks

• Thông tin cập nhật mới theo thời gian thực chỉ qua HTTPS - Bạn không thể tạo gói đăng ký mới qua URL gọi lại không phải HTTPS. Điều này sẽ ảnh hưởng đến thông tin cập nhật User, Page, App và Payment.