http://developers.facebook.com/docs/reference/api/photo/
アルバム内の個々の写真

目次:

Example

https://graph.facebook.com/98423808305 (A photo from the Coke fan page)

Properties

NameDescriptionPermissionsReturns
id

写真ID

デフォルトでFacebook上の全員に公開

JSON string


from

写真の投稿主(ユーザもしくはページ)のプロフィール

デフォルトでFacebook上の全員に公開

id,nameフィールドを含むJSONオブジェクト

tags

タグ付けされたユーザと、写真上のタグの位置

デフォルトでFacebook上の全員に公開

x,y軸の座標を左上からのパーセンテージで示した値を含むJSONオブジェクトの配列

name

写真のキャプション

デフォルトでFacebook上の全員に公開

JSON string

icon

写真がフィードに記載される場合にFacebookが表示するアイコン

デフォルトでFacebook上の全員に公開

有効なURLを含むJSON文字列

source

フルサイズの写真のソース

デフォルトでFacebook上の全員に公開

有効なURLを含むJSON文字列

height

写真の高さ(ピクセル)

デフォルトでFacebook上の全員に公開

JSON number


width

写真の幅(ピクセル)

デフォルトでFacebook上の全員に公開

JSON number


link

Facebook上の写真ページのリンク

デフォルトでFacebook上の全員に公開

有効なURLを含むJSON文字列

created_time

写真が最初に投稿された日時

デフォルトでFacebook上の全員に公開

IETF RFC 3339形式のdatetimeを含むJSON文字列

updated_time

写真もしくはキャプションの最終更新日時

デフォルトでFacebook上の全員に公開

IETF RFC 3339形式のdatetimeを含むJSON文字列

Connections

NameDescriptionPermissionsReturns
comments

All of the comments on this photo


デフォルトでFacebook上の全員に公開

id,from,message,created_timフィールドを含むJSONオブジェクトの配列

likes

Users who like the photo


デフォルトでFacebook上の全員に公開

id,nameフィールドを含むJSONオブジェクトの配列

picture

The album-sized view of the photo


デフォルトでFacebook上の全員に公開

写真のURL(HTTPステータス302でリダイレクト)

Publishing

publish_streamパーミッションが必要です。
写真を投稿するには、写真ファイルをmultipart/form-dataとして添付してPOST送信します。

http://graph.facebook.com/PROFILE_ID/photosへPOSTリクエストを送ることで、ユーザのプロフィールに対して個々の画像を投稿できます。アルバムが存在しない場合には、新規にアルバムが作成されます。同一アプリケーションから投稿された写真は、自動作成された同一のアルバムへまとめられます。


http://graph.facebook.com/ALBUM_ID/photosへのPOST送信によって、すでに存在する特定のアルバムに対して写真投稿できます。

If you would like to suppress the story that is automatically
generated in the user's feed when you publish a photo (usually because
you plan on generating your own), you can add a no_story=1 parameter. In this case, the user will receive a notification that your application has uploaded a photo.

写真を投稿した時にユーザのfeedへ自動でstoryが流されるのを控えたい場合は、no_story=1パラメータを加えます。この場合、ユーザはアプリケーションが写真を投稿した旨の通知を受け取ります。
curl -F 'access_token=...' \
-F 'source=@file.png' \
-F 'message=Caption for the photo' \
https://graph.facebook.com/me/photos