Skip to content

ユーザー設定センターを更新しますか?

put

/preference_center/v1/{preferenceCenterExternalID}

このエンドポイントを使用してプリファレンスセンターを更新します。

See me in Postman

前提条件

このエンドポイントを使用するには、preference_center.update権限のある API キーが必要です。

レート制限

このエンドポイントのレート制限は、ワークスペースごとに 1 分あたり 10 リクエストです。

パスパラメーター

パラメーター 必須 データ型 説明
preferenceCenterExternalID 必須 文字列 プリファレンスセンターのID。

リクエスト本文

1
2

Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY

1
2
3
4
5
6
7
8
9

{
  "name": "preference_center_name",
  "preference_center_title": "string",
  "preference_center_page_html": "string",
  "confirmation_page_html": "string",
  "options": {
    "meta-viewport-content": "string", (optional) Only the `content` value of the meta tag
  }
}

リクエストパラメーター

パラメーター 必須 データ型 説明  
preference_center_page_html 必須 文字列 プリファレンスセンターページのHTML。  
preference_center_title オプション 文字列 プリファレンスセンターと確認ページのタイトル。タイトルが指定されていない場合、ページのタイトルはデフォルトで「プリファレンスセンター」になります。  
confirmation_page_html 必須 文字列 確認ページのHTML。  
state オプション 文字列 active draft または. を選択
options オプション オブジェクト 属性:meta-viewport-content.存在する場合、viewportcontent= <value of attribute>メタタグがでページに追加されます。  

リクエスト例

1
2
3
4
5
6
7
8
9
10
11

curl --location --request POST 'https://rest.iad-01.braze.com/preference_center/v1/{preferenceCenterExternalId}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-API-KEY-HERE' \
--data-raw '{
  "name": "Example",
  "preference_center_title": "Example Preference Center Title",
  "preference_center_page_html": "HTML for preference center here",
  "confirmation_page_html": "HTML here with a message to users here",
  "state": "active"
}
'

レスポンス例

1
2
3
4
5
6

{
  "preference_center_api_id": "8efc52aa-935e-42b7-bd6b-98f43bb9b0f1",
  "created_at": "2022-09-22T18:28:07Z",
  "updated_at": "2022-09-22T18:32:07Z",
  "message": "success"
}
  GitHub でこのページを編集
「このページはどの程度役に立ちましたか?」
New Stuff!