User Photo

[ファイル] ページからの画像をユーザの写真として使用するには、リクエストボディの fileId プロパティまたは fileId 要求パラメータでファイル ID を渡します。[ユーザ] ページでアップロードした画像にはファイル ID は含まれず、fileId としては使用できません。

バイナリファイルをユーザの写真としてアップロードするには、マルチパート/フォームデータメッセージでそのファイルを送信する必要があります。マルチパート/フォームデータメッセージを作成する方法についての詳細は、「バイナリファイルのアップロード」を参照してください。

ユーザプロファイルの写真をフィードに表示するには、ユーザの写真をキャッシュします。次に、Photo レスポンスボディの photoVersionId プロパティを使用して、いつ写真を更新する必要があるかを判断します。この方法により、制限を超えて実行することを避け、モバイルクライアントのパフォーマンスを改善できる場合があります。

リソース

1/chatter/users/userId/photo

1/connect/communities/communityId/chatter/users/userId/photo

適用開始バージョン

23.0 ～ 34.0

バージョン 35.0 以降では、/connect/user-profiles/userId/photo を使用します。

重要

Chatter が必要かどうか

はい

HTTP メソッド

GET、POST

POST のリクエストボディ

ルート XML タグ

<photo>

JSON の例

1{   "cropSize" : "120",
2    "cropX" : "0",
3    "cropY" : "0",
4    "fileId" : "069D00000001IOh"
5}

プロパティ

名前	型	説明	必須か省略可能	使用可能なバージョン
cropSize	Integer	トリミングする正方形の任意の境界の長さ (ピクセル単位)。	アップロードされたファイルまたは既存のファイルをトリミングする場合に必須。	29.0
cropX	Integer	画像の左端を起点とした、トリミングする正方形の開始位置 X (ピクセル単位)。左上の位置は (0,0) です。	アップロードされたファイルまたは既存のファイルをトリミングする場合に必須。	29.0
cropY	Integer	画像の上端を起点とした、トリミングする正方形の開始位置 Y (ピクセル単位)。左上の位置は (0,0) です。	アップロードされたファイルまたは既存のファイルをトリミングする場合に必須。	29.0
fileId	String	既存のファイルの 18 文字の ID。キープレフィックスは 069、ファイルサイズは 2 GB 未満にする必要があります。 グループページおよびユーザページにアップロードされた画像にはファイル ID がないため、使用できません。 メモ	既存のファイルを選択する場合に必須。	25.0
versionNumber	Integer	既存のファイルのバージョン番号。指定されていない場合、最新のバージョンが使用されます。	省略可能	25.0

POST の要求パラメータ

��ラメータ名	型	説明	必須か省略可能	使用可能なバージョン
cropSize	Integer	トリミングする正方形の任意の境界の長さ (ピクセル単位)。	アップロードされたファイルまたは既存のファイルをトリミングする場合に必須。	29.0
cropX	Integer	画像の左端を起点とした、トリミングする正方形の開始位置 X (ピクセル単位)。左上の位置は (0,0) です。	アップロードされたファイルまたは既存のファイルをトリミングする場合に必須。	29.0
cropY	Integer	画像の上端を起点とした、トリミングする正方形の開始位置 Y (ピクセル単位)。左上の位置は (0,0) です。	アップロードされたファイルまたは既存のファイルをトリミングする場合に必須。	29.0
fileId	String	既存のファイルの 18 文字の ID。キープレフィックスは 069、ファイルサイズは 2 GB 未満にする必要があります。 [グループ] ページおよび [ユーザプロファイル] ページでアップロードしたファイルにはファイル ID は含まれず、投稿やトリミングはできません。[ファイル] ページでアップロードしたファイルにはファイル ID は含まれず、投稿やトリミングはできません。 メモ	既存のファイルを選択する場合に必須。	25.0
versionNumber	Integer	既存のコンテンツのバージョン番号。指定されていない場合、最新のバージョンが使用されます。	省略可能	25.0

写真は非同期に処理され、すぐには表示されない場合があります。

メモ

GET のレスポンスボディ

Photo

POST のレスポンスボディ

Photo