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 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 または HEAD のレスポンスボディ

Photo

POST のレスポンスボディ

Photo