バージョン2.10

グラフAPI | マーケティングAPI

更新履歴のエントリーは、以下の方法で分類されています。

  • 新機能 — 新しいノード、エッジ、フィールドなどを含む、新しい製品やサービス。
  • 変更 — 既存の製品やサービスへの変更点(廃止されたものを除く)。
  • 廃止 — 既存の製品やサービスのうち削除されたもの。
  • 90日後の重要な変更点 — バージョンのリリース日から90日後に変更、廃止される内容。

新機能変更廃止は、このバージョンにのみ適用されます。90日後の重要な変更点は、すべてのバージョンに影響します。

重要な変更点は、特定のリリースに適用される内容ではないため、ここには含まれていません。


グラフAPI

2017年7月18日リリース | 2019年11月7日まで利用可能


新機能

Webhooks

  • ページイベントのWebhooks — ページのfeedフィールドのサブスクリプションでは、今後は以下のアクションでアップデートがトリガーされます。

    • 予定されたイベントの自動公開
    • イベントのストーリーへのコメント
    • イベントの作成と公開
    • イベントの下書きの公開

変更内容

クレジットの割り当て

  • GET /{extended-credit-id} — 次のフィールドの名前が変更されました。

    • invoice_emailextended_credit_emailsに変更しました
    • invoice_groupextended_credit_invoice_groupsに変更しました
    • sequential_liability_amountallocated_amountに変更しました
  • GET /{extended-credit-id} — 次のフィールドが追加されました。

    • liable_biz_name fields
    • owner_business field (idnameのサブフィールドを持つ)
    • owning_credit_allocation_configs
    • send_bill_to_biz_name
  • GET /{extended-credit-id} — 次のフィールドは削除されました。

    • business_id field
  • extended_credit_invoice_groups — 次のサブフィールドが追加されました。

    • ad_accounts (account_idnameのサブフィールドを持つ)
    • email
    • id
    • name
  • CurrencyAmount — 次のフィールドでは、金額だけでなくCurrencyAmountオブジェクトが返されるようになりました。

    • allocated_amount
    • balance
    • max_balance
    • online_max_balance

Facebookページ

User (ユーザー)

Webhooks

  • アプリの制限の実施 — アプリの制限にかかる利用者(国や年齢など)のアクセストークンを指定すると、リクエストにappsecret_proofが指定されていない限り、エラーが生じます。

廃止されたもの

イベント

  • GET /{event-id}/videos — このエッジは削除されました。

90日後の重要な変更点について

コメント

  • POSTDELETE /{comment-id} — このノードには、有効なページアクセストークンが必要になりました。

  • POST and DELETE /{object-id}/comments — このノードには、有効なページアクセストークンが必要になりました。

  • GET /{object-id}/comments — このエッジには、有効なアクセストークンが必要になりました。

URL

  • POST /{url} — このノードには、有効なアクセストークンが必要になりました。

  • GET /{url} — デフォルトでog_objectが返されなくなりました。ただし、フィールドパラメーターには含める必要があります。

  • /{url}スクレイピングGETリクエストでは、URLがスクレイピングされなくなりました。URLのスクレイピングには、POST /{url}が必要になります。

投稿

  • /{post-id} — このノードには、有効なアクセストークンが必要になりました。

動画

  • /{video-id} — このノードには、有効なページアクセストークンが必要になりました。

Marketing API

Released July 18, 2017 | Available until May 8, 2018


New Features

  • No new features.

Changes

  • No changes.

Deprecations

  • No deprecations.

90-Day Breaking Changes

  • No 90-day breaking changes.

Breaking Changes in Marketing API v2.10

Ads Management

  • Holdout fields - The following fields have been deprecated from POST /{ad_account_id}/ads and GET /{ad_id}:

    • holdout_end
    • holdout_hash
    • holdout_start
    • no_show_offset
    • no_show_percentage
    • show_end
    • show_start
  • POST /{ad_account_id}/adcreatives - The following parameter is now deprecated:

    • follow_redirect
  • creative_rotation_parameter and creative_rotation type from GET ADSET_ID and POST AD_ACCOUNT_ID/adsets are deprecated.

  • Real-time bidding partner GET endpoints are deprecated. This includes GET /RTB_PARTNER_ID and GET /RTB_PARTNER_ID/stats endpoints. We also removed the field rtb_flag from POST /ADSET_ID and POST /ADGROUP_ID.

Signals and Targeting

  • Reach and Frequency Predictions - As of 2.10 we now provide target_spec as a JSON object; you no longer have to parse the response into JSON.

Insights

  • Breakdowns - The following types have been deprecated for the action_link_click_destination breakdown. See Insights, Breakdowns.

    • app_store_clicks
    • deeplink_clicks
    • website_clicks

Replaced by:

  • click_to_app_store
  • click_to_app_deeplink
  • click_to_website