# ブラウザプロファイルを変更する

既存のブラウザープロファイルを更新します。リクエストに含まれるフィールドのみが変更されます。
- **前提条件**
：プロファイルがチーム内に存在すること。エンドツーエンド暗号化されたプロファイルは更新できません。OS とブラウザー種別は変更できません。起動中のプロファイルも更新できます。
- **副作用**
：プロファイルのレコード、その拡張設定、Cookie を書き込み、高度な指紋設定をマージします（上書きされない限り既存の値は保持されます）。
- **完了シグナル**
：同期的です。
- **リトライ**
：同一のリクエストボディで繰り返しても安全です。ただし楽観ロックはありません。同一プロファイルへの同時更新は後書き優先で、指紋のマージは書き込み前に読み取るため、同時に呼び出すと変更が失われることがあります。

文書化されたビジネスエラー: `19001`, `19039`, `19104`, `19105`, `19106`, `19107`, `19108`, `19142`, `19159`, `19160`, `19175`, `19193`。 各コードの意味は [Error Codes](/ja/api-reference/getting-started/error-codes) を参照してください。どの操作でも共通コードが返る場合があります。

Endpoint: POST /api/env/update
Version: 2026-09-05

## Request fields (application/json):

  - `browserTypeId` (integer)
    ブラウザー種別 ID：1=Chrome、2=Firefox

  - `operatorSystemId` (integer)
    OS 種別 ID：1:Windows 2:macOS 3:Android 4:IOS 5:Linux

  - `isEncrypt` (integer)
    プロファイルを暗号化するかどうか：0=しない、1=する

  - `startupParams` (array)
    追加のブラウザー起動パラメーター

  - `accountInfo` (object)

  - `accountInfo.customerUrl` (string)
    カスタムプラットフォームURL — platformId=9999の場合に必須。有効なURLである必要があります。

  - `accountInfo.password` (string)
    パスワード; 最大文字数:50文字

  - `accountInfo.platformId` (string)
    プラットフォームID。カスタムURLの場合は9999を使用してください。/api/system/platform/listを参照してください。

  - `accountInfo.siteId` (string)
    サイトID。「Get Configurable Platforms」API（/api/system/platform/list）から取得します。

  - `accountInfo.username` (string)
    ユーザー名（最大文字数：64文字）

  - `advancedSetting` (object)
    高度なブラウザフィンガープリントと動作設定。

  - `advancedSetting.ua` (string)
    プロファイルのユーザーエージェント（UA）をカスタマイズします。標準のUAフォーマットに従う必要があります。
「Get Browser UA」API経由で利用可能です。

  - `advancedSetting.time_zone` (object)

  - `advancedSetting.time_zone.switcher` (integer)
    タイムゾーンオプション。デフォルト：1。1 = IPアドレスに一致、2 = カスタム。

  - `advancedSetting.time_zone.value` (string)
    switcher=2 の場合に必須です。
「タイムゾーンと言語リストの取得」APIから取得したタイムゾーンID。

  - `advancedSetting.web_rtc` (object)

  - `advancedSetting.web_rtc.switcher` (integer)
    WebRTCポリシー。デフォルト：2。1＝プライバシー、2＝置換、3＝有効、4＝無効、5＝転送。

  - `advancedSetting.geo_location` (object)

  - `advancedSetting.geo_location.switcher` (integer)
    位置情報ポリシー。デフォルト：1。1 = 確認、2 = 無効。

  - `advancedSetting.geo_location.base_on_ip` (boolean)
    IPアドレスに基づいて位置情報を生成しますか？デフォルト：true。true = プロンプト表示、false = 手動。

  - `advancedSetting.geo_location.latitude` (number)
    緯度。base_on_ip=false の場合は必須です。

  - `advancedSetting.geo_location.longitude` (number)
    経度。base_on_ip=false の場合は必須です。

  - `advancedSetting.geo_location.accuracy` (number)
    精度はメートル単位です。base_on_ip=false の場合に必須です。

  - `advancedSetting.language` (object)

  - `advancedSetting.language.switcher` (integer)
    言語ポリシー。デフォルト:1。1 = IPアドレスに一致、2 = カスタム。

  - `advancedSetting.language.value` (string)
    switcher=2 の場合に必須です。
「タイムゾーンと言語リストの取得」APIから取得した言語IDをカンマ区切りで指定します。

  - `advancedSetting.resolution` (object)

  - `advancedSetting.resolution.switcher` (integer)
    解決ポリシー。デフォルト：1。1 = リアル、2 = カスタム。

  - `advancedSetting.resolution.id` (string)
    switcher=2 の場合に必須です。
「Get Resolution List」API から取得した解決ID。

  - `advancedSetting.font` (object)

  - `advancedSetting.font.switcher` (integer)
    フォントポリシー。デフォルト：1。1 = 標準、2 = カスタム。

  - `advancedSetting.font.value` (string)
    カンマ区切りのカスタムフォント名（switcher=2 の場合は必須）。

  - `advancedSetting.canvas` (object)

  - `advancedSetting.canvas.switcher` (integer)
    キャンバスポリシー。デフォルト:1。1 = ノイズ、2 = リアル。

  - `advancedSetting.webgl_image` (object)

  - `advancedSetting.webgl_image.switcher` (integer)
    WebGL イメージ ポリシー。デフォルト: 1。1 = ノイズ、2 = リアル。

  - `advancedSetting.webgl_metadata` (object)

  - `advancedSetting.webgl_metadata.switcher` (integer)
    WebGL メタデータ ポリシー。デフォルト: 3。1 = 有効、2 = ハードウェア アクセラレーションを無効、3 = カスタム。

  - `advancedSetting.webgl_metadata.provider` (string)
    WebGLブランド文字列（例：「Google Inc.」）

  - `advancedSetting.webgl_metadata.render` (string)
    WebGLレンダラー文字列（例：「ANGLE (...)」）

  - `advancedSetting.audio_context` (object)

  - `advancedSetting.audio_context.switcher` (integer)
    AudioContext ポリシー。デフォルト: 1。1 = ノイズ、2 = リアル。

  - `advancedSetting.media_device` (object)

  - `advancedSetting.media_device.switcher` (integer)
    メディアデバイスポリシー。デフォルト：1。1 = ノイズ、2 = リアル。

  - `advancedSetting.client_rects` (object)

  - `advancedSetting.client_rects.switcher` (integer)
    ClientRects ポリシー。デフォルト: 1。1 = ノイズ、2 = 実測値。

  - `advancedSetting.speech_voise` (object)

  - `advancedSetting.speech_voise.switcher` (integer)
    SpeechVoicesポリシー。デフォルト：1。1 = プライバシー、2 = リアル

  - `advancedSetting.hardware_concurrency` (integer)
    シミュレーションされる論理CPUコア数。
デフォルト値：4。オプション：0（実数）、2、3、4、6、8、10、12。

  - `advancedSetting.memery_device` (integer)
    シミュレーション対象デバイスのメモリ容量（GB）。
デフォルト値：8。オプション：0（実容量）、2、4、6、8。

  - `advancedSetting.do_not_track` (integer)
    トラッキング拒否設定。デフォルト値：2。1＝オン、2＝オフ。

  - `advancedSetting.bluetooth` (object)

  - `advancedSetting.bluetooth.switcher` (integer)
    Bluetooth ポリシー。デフォルト: 1。1 = プライバシー、2 = 認証。

  - `advancedSetting.battery` (object)

  - `advancedSetting.battery.switcher` (integer)
    バッテリーポリシー。デフォルト：1。1 = プライバシー、2 = 認証。

  - `advancedSetting.port_scan_protection` (object)

  - `advancedSetting.port_scan_protection.switcher` (integer)
    ポートスキャン保護。デフォルト：1。1 = オン、2 = オフ。

  - `advancedSetting.port_scan_protection.value` (string)
    接続を許可するローカルネットワークポート（カンマ区切り）。

  - `advancedSetting.os_version` (string)
    macOSのシステムバージョン（例：macOS 12、macOS 13、macOS 14）。

  - `advancedSetting.web_gpu` (object)

  - `advancedSetting.web_gpu.switcher` (integer)
    WebGPU ポリシー。デフォルト: 1。1 = WebGL ベースのマッチング、2 = 有効、3 = 無効。

  - `advancedSetting.ciphers` (object)

  - `advancedSetting.ciphers.switcher` (integer)
    TLS暗号ポリシー。デフォルト：1。1 = デフォルト、2 = カスタム。

  - `advancedSetting.ciphers.value` (string)
    switcher=2 の場合に必須です。
無効にするTLSプロトコルをカンマ区切りで指定します（例：「TLSv1,TLSv1.1」）。

  - `advancedSetting.mobile_device` (string)
    電話機モデルID（文字列）。「電話機モデルリスト取得」APIを使用して取得してください。
例：「1826502391344832512」

  - `afterStartupConfig` (object)

  - `afterStartupConfig.afterStartup` (integer)
    起動後の動作。デフォルト：1。
1 = 前のページを続行、
2 = 指定したURLを開く、
3 = URLとプラットフォームを開く、
4 = 前のページを続行、プラットフォームを開く。

  - `afterStartupConfig.autoOpenUrls` (array)
    自動的に開く有効なURLのリスト（オプション2～3で必須）。

  - `browserCore` (integer)
    カーネルバージョン。デフォルト：0（自動マッチング）。利用可能なバージョンは `/api/env/advanced/ua/versions` で取得できます。

  - `cookies` (string)
    事前に読み込む Cookie 文字列（省略可）

  - `envName` (string)
    環境名

  - `envRemark` (string)
    環境の備考。最大長：1500 文字

  - `groupId` (string)
    環境グループ ID。デフォルト：未グループ（0）

  - `groupName` (string)
    グループ名（最大50文字）。指定された場合、システムはまず groupId を確認します：有効なグループが見つかればそれを使用し、見つからなければ groupName で検索します。同名のグループが存在すればそれを参照し、存在しなければ新しいグループを作成します。各チームは最大1,000グループに制限されています。

  - `proxyId` (string)
    プロキシ ID。デフォルト：0

  - `tagIds` (array)
    タグ ID。デフォルト：なし

  - `uaVersion` (integer)
    UA プリセットバージョン。デフォルト：0（すべて）

  - `disableAudio` (integer)
    音声を無効化：0 = オフ、1 = オン

  - `disableImg` (integer)
    画像の読み込みを無効化：0 = オフ、1 = オン

  - `disableVideo` (integer)
    動画の読み込みを無効化：0 = オフ、1 = オン

  - `imgLimitSize` (integer)
    画像の最大サイズ（KB）

  - `envId` (string, required)
    環境 ID

  - `hostnameSource` (integer)
    端末名のソース：
- `0`
 — カスタム
- `1`
 — 実際の値
    Enum: "0", "1"

  - `hostname` (string)
    端末名。`hostnameSource` が `0` のときに使われます。
    Example: DESKTOP-OPENAPI

  - `macAddressSource` (integer)
    MAC アドレスのソース：
- `0`
 — カスタム
- `1`
 — 実際の値
    Enum: "0", "1"

  - `macAddress` (string)
    MAC アドレス。`macAddressSource` が `0` のときに使われます。
    Example: 00:16:3E:12:34:56

## Response 200:

  - `200` (unknown)
    成功。この操作の `data` は常に null です。結果は `code` で示されます。

## Response 200 fields (application/json):

  - `code` (integer, required)

  - `msg` (string | null, required)

  - `data` (null, required)

  - `requestId` (string, required)

