グラフ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ノード - 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日間連続して失敗した場合、Webhookサブスクリプションが自動的に無効になるようになりました。/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の更新に影響します。