Group Photo

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

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

リソース

1/chatter/groups/groupId/photo

1/connect/communities/communityId/chatter/groups/groupId/photo

適用開始バージョン

23.0

Chatter が必要かどうか

はい

HTTP メソッド

GET、POST、DELETE、または HEAD

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 MB 未満にする必要があります。 グループページおよびユーザページにアップロードされた画像に���ファイル 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 MB 未満にする必要があります。 [グループ] ページおよび [ユーザプロファイル] ページでアップロードしたファイルにはファイル ID は含まれず、投稿やトリミングはできません。[ファイル] ページでアップロードしたファイルにはファイル ID は含まれず、投稿やトリミングはできません。 メモ	既存のファイルを選択する必要があります。	25.0
versionNumber	Integer	既存のコンテンツのバージョン番号。指定されていない場合、最新のバージョンが使用されます。	省略可能	25.0

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

メモ

GET または HEAD のレスポンスボディ

Photo

POST のレスポンスボディ

Photo