그래프 API

버전 2.5

그래프 API | 마케팅 API

그래프 API v2.5

출시 날짜: 2015년 10월 7일 | 이용 가능 기한: 2018년 4월 12일

이 버전은 2018년 4월 12일에 만료됩니다. API 업그레이드 도구를 사용하여 이 날짜 전에 앱을 업그레이드하세요. 앱 업그레이드에 대한 자세한 내용은 업그레이드 가이드를 참조하세요.

새로운 기능

페이지

  • 권한

    • 이제 GET {user_id}/accounts에는 manage_pages 또는 pages_show_list가 필요합니다. 후자는 v2.5의 새로운 권한입니다.
    • POST {page_id}/call_to_actions 및 POST/DELETE {call-to-action-id}에는 v2.5에서 도입한 새로운 권한인 pages_manage_cta가 필요합니다.

  • 행동 유도 관리 - 이제 페이지에서 행동 유도를 관리할 수 있습니다.

    • 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 필드는 v2.5부터 오류를 반환합니다.

Webhooks(이전 명칭: 실시간 업데이트)

  • 자동으로 구독 비활성화 - 콜백 URL이 7일 연속으로 실패하면 이제 Webhooks 구독을 자동으로 비활성화합니다. /subscriptions로 POST 요청을 보내 다시 활성화할 수 있습니다. 이 변경 사항은 결제 구독에는 적용되지 않습니다.

  • 기존 구독 업데이트 - 기존 Webhooks 구독은 /subscriptions API를 사용하여 수정할 수 있습니다. POST /subscriptions는 기존 필드를 덮어쓰지 않고 주어진 주제에 대한 구독을 수정합니다. 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를 통해서만 가능 - 새로운 구독은 HTTPS가 아닌 콜백 URL로 생성할 수 없습니다. 이는 User, Page, App 및 Payment 업데이트에 영향을 미칩니다.