Agile Cat — in the cloud

Facebook の Graph API がアップデートされ、AD API も強化されたようだ!

Posted in Advertising, API, Facebook, Open Graph by Agile Cat on November 18, 2014

Facebook Releases Updated Graph API
http://wp.me/pwo1E-825
David Cohen – October 30, 2014
http://allfacebook.com/graph-api-2-2_b135773

_ All Facebook

Facebook announced the release of version 2.2 of its Graph API and updated software-development kits for iOS and Android to support the updated application-programming interface, also revealing that its ads API now supports versioning.

Facebook が、Graph APIVer 2.2 のリリースについて発表した。そして、最新の API をサポートするために、iOSAndroidi の SDK をアップデートし、さらには、バージョニングをサポートすることになる、Ads API についても明らかにした。

Software engineer Mahesh Sharma wrote in a post on the Facebook developer blog that applications created starting Thursday may only call version 2.2 of the Graph API or greater, adding that version 2.1 will be depreciated Oct. 30, 2016.

ソフトウェア・エンジニアである Mahesh Sharma は、この木曜日(10/30)以降に作成されるアプリのみが、Graph API の Ver 2.2 を利用できるようになり、また、2016年10月30日には、これまでの Ver 2.1 は価値を失うと、Facebook Developer Blog で述べている

Facebook had announced at its F8 global developer conference in San Francisco April 30 that version 1.0 will be depreciated April 30, 2015.

なお、今年の 4月30日に San Francisco で開催された、F8 Global Developer Conference で Facebook は、 2015年4月30日に Ver 1.0 が終了することも発表している。

Sharma offered some highlights of new features of version 2.2, saying that the full list of additions, changes and depreciations can be found in the change logs for the Graph API and the iOS and Android SDKs, as well as the upgrade guide:

Sharma は、Ver 2.2 の新機能から、いくつかのハイライトを提供している。具体的には、Graph API および iOSAndroid SDK のために、追加/変更/廃棄のフル・リストが、更新ログ内で参照できるようになり、また、Upgrade Guide も提供されると言及している:

  • アプリ群からプログラムを介して、ページ・ポスト上のコメントを表示/非表示に設定できる。
  • ユーザー・オブジェクト上に新たに提供される token_for_business フィールドにより、1つの企業が所有するマルチ・アプリ間をまたいで利用するユーザーを、容易に特定できるようになる。
  • そのために特化された subscribed apps edge を経由して、ページ・サブスクリプションをリアル・タイムで更新するための、新たな管理手法を提供する。
  • ページ・ノードおよび settings edge を介した API により、より詳細なページ属性の編集が実現される。

Sharma wrote on the addition of support for versioning to the ads API:

Sharma は、Ads API のバージョニング・サポートについて、以下の項目を追記している:

We recently announced new access levels for the ads API. In addition, from v2.2 onward, the ads API now supports versioning.

先日、私たちは、Ads API に関する、新しいアクセス・レベルについて発表した。 また、V2.2 以降より、Ads API はバージョニングをサポートするようになる。

For developers using the ads API, versioning means increased control over how you opt into new ads API features. Rather than changing a migration setting in your app dashboard, you can now control the behavior by specifying the version number in your client codebase.

Ads API を使用するデベロッパーがバージョニング機能を利用すると、新しい Ads API 機能にオプトインする際の、コントロールの幅が広がるようになる。それぞれのアプリのダッシュボードで、マイグレーション設定を変更するのではなく、クライアント・コード・ベースのバージョン番号を指定することで、その動きをコントロールできるようになる。

Our advertising products continue to evolve at a fast pace. To ensure that developers take advantage of this progress, the ads API will follow a 90-day breaking-change policy. To make this behavior clear, ads API methods will be removed from a version 90 days after the next version is released.

私たちのアド・プロダクトは、きわめて速いペースで進化し続けている。そのアドバンテージを、デベロッパーに対して保証するために、Ads API は 90日間のブレーキング・チェンジ・ポリシーに従う。具体的に言うと、Ads API における各メソッドは、次のバージョンがリリースされた90日後に削除されることになる。

As v2.2 is the first release for the ads API, ads API methods will be removed from v1.0, v2.0 and v2.1 in 90 days’ time. Developers using the Ads API should update their apps to call v2.2 before Jan. 28, 2015. After that date, all calls to ads API methods that do not specify v2.2 (including calls that do not specify any version) will result in an error.

v2.2 の Ads API が最初にリリースされた時から、90日が経過した時点で、古い広告 API メソッド群は、V1.0/V2.0/V2.1 から削除されることになる。Ads API を使用しているデベロッパーは、2015年1月28日以前に、自身のアプリから V2.2 を呼び出すよう、変更する必要がある。その日以降、V2.2 で指定されていない、すべての Ads API メソッド群への呼び出しは(バージョンを指定しない呼び出しも同様)、エラーを返すことになる。

For full details on the changes to the Ads API in v2.2, see the ads API blog and the dedicated ads API change log and upgrade guide.

Ads API V2.2 での変更に関する詳細は、ads API blog で参照できる。 また、専用の ads API change log および upgrade guide も参照して欲しい。

Finally, Sharma reminded developers of policy changes tied to the release of version 2.1 of the Graph API, which take effect at the end of their 90-day depreciation period, Nov. 5:

最後に、Sharma はでデベロッパーに対して、Graph API Ver 2.1 のリリースに関連する、ポリシーの変更について再確認している。それは、Facebook が規定した 90日後となる、11月5日に廃棄されることになる:

The recommendation bar plugin is deprecated and will stop appearing on your pages after Nov. 5. Please remove the <fb:recommendations-bar/> XFBML tag from your pages at the earliest opportunity.

Recommendation Bar プラグインが廃止されるため、11月5日以降は、ページ上での表示が行われなくなる。できるだけ早い時期に、ページの <fb:recommendations-bar/> XFBML タグを削除して欲しい。

You must not incentivize people to use social plugins or to like a page. This includes offering rewards, or gating apps or app content based on whether or not a person has liked a page. From Nov. 5, the liked field within the page property of the signed_request object will return true for all apps created before Aug. 7, 2014, when those apps are rendered inside a page tab.

ソーシャル・プラグインおよびページへの LIKE を用いて、人々にインセンティブを提供してはならない。つまり、人々がページに LIKE を付けていてもいなくても、賞金/アプリ/コンテンツなどを含む、一切の利益供与は禁止される。 11月5日以降、signed_request オブジェクトのページ・プロパティ内の LIKE フィールドは、2014年8月7日以前に作成されたアプリに関して、それらがページ・タブの内側にレンダリングされるときに、True を返すようになる。

The insights edge will be removed from the application object in v1.0 and v2.0. You should update your apps to call /v2.1/{app_id}/app_insights or /v2.2/{app_id}/app_insights to take advantage of the new app insights API.

V1.0/V2.0 の Application オブジェクトから、insights edge は削除されることになる。 新しい App Insight API のアドバンテージを得るためには、以下を呼び出すよう、あなたのアプリをアップデートする必要がある。

/v2.1/{app_id}/app_insights or /v2.2/{app_id}/app_insights

Developers: What are your initial thoughts?

デベロッパーたちへ:あなたの第一印象は どうだろう?

Related Stories

ーーーーー

今年の 2月に、「Facebook が Open Graph の デベロッパー・コレクションを停止した:とても残念!」という抄訳をポストしましたが、Graph API 自体は残っていたのでしょうね。 いずれにしろ、Facebook が Graph という考え方を捨てることはないはずであり、デベロッパーに開放する API を、新たに整理し直しているように思えます。 いずれにしろ Graph API は面白そうですし、Facebook のアーキテクチャとストラテジーを理解する重要な切り口になるはずなので、とてもワクワクしています。 そして、Open Graph というカテゴリを、残しておいて良かったと思っています 🙂

ーーーーー

<関連>

Facebook の News Feed は、どう 変わったのか? なぜ 変わったのか?
Facebook が提供する、Open Graph のベスト・プラクティスとは?
Facebook の超高速ストレージ : TAO の詳細を説明しよう
Facebook が発表した TAO : これで MySQL と Memcached を接続する
Facebook は Open Graph へと ユーザーを誘う

Comments Off on Facebook の Graph API がアップデートされ、AD API も強化されたようだ!

%d bloggers like this: