アルバム内の個々の写真
目次:
Example
https://graph.facebook.com/98423808305 (A photo from the Coke fan page)
Properties
Name | Description | Permissions | Returns |
id | 写真ID | デフォルトでFacebook上の全員に公開 | JSON string |
from | 写真の投稿主(ユーザもしくはページ)のプロフィール | デフォルトでFacebook上の全員に公開 |
|
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
Name | Description | Permissions | Returns |
comments | All of the comments on this photo | デフォルトでFacebook上の全員に公開 |
|
likes | Users who like the photo | デフォルトでFacebook上の全員に公開 |
|
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.
curl -F 'access_token=...' \
-F 'source=@file.png' \
-F 'message=Caption for the photo' \
https://graph.facebook.com/me/photos