この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

Group Banner Photo

グループのバナー写真を取得、作成、または削除します。

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

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

リソース

1/chatter/groups/groupId/banner-photo

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

使用可能なバージョン

36.0

Chatter が必要かどうか

はい

HTTP のメソッド

GET、HEAD、DELETE、POST

グループのバナー写真を削除および投稿できるのは、グループ所有者、グループマネージャ、および「すべてのデータの管理」権限を持つユーザです。

POST のリクエストボディ

ルート XML タグ

<bannerPhoto>

JSON の例

1{   "cropHeight" : "120",
2    "cropWidth" : "240",
3    "fileId" : "069D00000001IOh"
4}

プロパティ

名前	型	説明	必須項目/省略可能	使用可能なバージョン
`cropHeight`	Integer	トリミングする長方形の高さ (ピクセル単位)。	省略可能	36.0
`cropWidth`	Integer	トリミングする長方形の幅 (ピクセル単位)。	省略可能	36.0
`cropX`	Integer	トリミングする長方形の画像の左端からの X 位置 (ピクセル単位)。左上の位置は (0,0) です。	省略可能	36.0
`cropY`	Integer	トリミングする長方形の画像の上端からの Y 位置 (ピクセル単位)。左上の位置は (0,0) です。	省略可能	36.0
`fileId`	String	既存のファイルの ID。キープレフィックスは 069、ファイルサイズは 8 MB 未満にする必要があります。グループページおよびユーザページにアップロードされた画像にはファイル ID がないため、使用できません。メモ	既存のファイルを使用する必要があります	36.0
`versionNumber`	Integer	既存のファイルのバージョン番号。指定されていない場合、最新のバージョンが使用されます。	省略可能	36.0

POST の要求パラメータ

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

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

メモ

GET および POST のレスポンスボディ

Banner Photo

DELETE のレスポンスボディ

204: Successful Delete

Chatter REST API 開発者ガイド

Group Banner Photo