# Apps

Apps に関する API。

 - [POST /cloudphone/app/install](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/cloudphoneappinstallpost.md): チームのアプリライブラリからクラウドフォンへアプリをインストールします。 - **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。アプリはチームライブラリまたは公開カタログに既に存在している必要があり、`appVersionId` か `packageName` + `versionCode` のいずれかで指定します。また、そのクラウドフォンを提供するデバイスサービス
 - [POST /cloudphone/app/page](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/cloudphoneapppagepost.md): クラウドフォンにインストール可能なアプリを一覧します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。クラウドフォンは関与しないため、起動している必要はありません。 - **返却内容**：公開アプリカタログ、すなわち全体公開のアプリと自チーム向けに公開されたアプリです。各エントリは `appVersionList` にバージョンを新しい順で保持します。`/cl
 - [POST /cloudphone/team/app/page](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/cloudphoneteamapppagepost.md): プリインストールアプリを含む、自チーム独自のアプリライブラリを一覧します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **返却内容**：`/cloudphone/app/page` とは別のソースで、こちらは自チームがアップロードしたアプリです。バージョンごとにネストされるのではなく、アプリバージョン 1 件を 1 行としてフラットに返されます。各エ
 - [POST /cloudphone/team/app/delete](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/deleteteamcloudphoneapp.md): v2.70.0 で追加。現在のチームに属するアプリが対象です。`/cloudphone/team/app/page` のチームアプリ ID を使用してください。端末 ID やカタログのアプリ ID ではありません。 登録とインストール範囲を削除します。端末上のアプリは削除しません。タイムアウト後は一覧を確認してから再実行してください。 **必要な権限**: `EXTENSION_DELETE`.
 - [POST /cloudphone/team/app/updateGroup](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/updateteamcloudphoneappgroup.md): v2.70.0 で追加。現在のチームに属するアプリが対象です。`/cloudphone/team/app/page` のチームアプリ ID を使用してください。端末 ID やカタログのアプリ ID ではありません。 権限のあるインストール範囲を更新します。`isAll=false` の場合、現在のチームのグループを空でない `groupIds` に指定します。保存は端末へのインストール完了を示しま
 - [POST /cloudphone/team/app/enable](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/enableteamcloudphoneapp.md): v2.70.0 で追加。現在のチームに属するアプリが対象です。`/cloudphone/team/app/page` のチームアプリ ID を使用してください。端末 ID やカタログのアプリ ID ではありません。 起動時の事前インストールを設定します。有効化にはチームのアプリ数制限が適用されます。インストール完了は示しません。 **必要な権限**: `EXTENSION_EDIT`. 文書化され
 - [POST /cloudphone/team/app/updateInstallSetting](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/updateteamcloudphoneappinstallsetting.md): v2.70.0 で追加。現在のチームに属するアプリが対象です。`/cloudphone/team/app/page` のチームアプリ ID を使用してください。端末 ID やカタログのアプリ ID ではありません。 起動時の方針を保存します。`1` は上書き、`2` は既存インストールをスキップします。 **必要な権限**: `EXTENSION_EDIT`. 文書化されたビジネスエラー: `33
 - [POST /cloudphone/team/app/updateEnableRoot](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/updateteamcloudphoneappenableroot.md): v2.70.0 で追加。現在のチームに属するアプリが対象です。`/cloudphone/team/app/page` のチームアプリ ID を使用してください。端末 ID やカタログのアプリ ID ではありません。 ROOT 設定を保存します。サービス設定で禁止されたパッケージでは有効化できません。 **必要な権限**: `EXTENSION_EDIT`. 文書化されたビジネスエラー: `3335
 - [POST /cloudphone/team/app/updateVersion](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/updateteamcloudphoneappversion.md): v2.70.0 で追加。現在のチームに属するアプリが対象です。`/cloudphone/team/app/page` のチームアプリ ID を使用してください。端末 ID やカタログのアプリ ID ではありません。 同じパッケージの別のカタログバージョンを選択します。カタログ由来のアプリのみ対応し、現在のバージョンは指定できません。起動時のインストール用に保存され、稼働中の端末は直ちに更新されませ
 - [POST /cloudphone/team/app/updateSetting](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/updateteamcloudphoneappsetting.md): v2.70.0 で追加。現在のチームに属するアプリが対象です。`/cloudphone/team/app/page` のチームアプリ ID を使用してください。端末 ID やカタログのアプリ ID ではありません。 `PERMISSION`、`KEEP_ALIVE`、`AUTO_START`、`HIDE` のいずれかを更新します。常駐はチームで最大 3 アプリです。常駐と非表示は対象の稼働端末へ非
 - [POST /cloudphone/team/app/operate](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/operateteamcloudphoneapp.md): v2.70.0 で追加。現在のチームに属するアプリが対象です。`/cloudphone/team/app/page` のチームアプリ ID を使用してください。端末 ID やカタログのアプリ ID ではありません。 範囲内の起動済みでアクセス権のある端末に `START`、`STOP`、`RESTART`、`UNINSTALL` を実行します。`onlyStartedByMe=true` は最後に
 - [POST /cloudphone/app/installedList](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/cloudphoneappinstalledlistpost.md): クラウドフォンに現在インストールされているアプリを一覧します。 - **前提条件**：クラウドフォンが自チームのものであること。他の多くのクラウドフォンコマンドと異なり、自分による占有は**不要**です。ただしデバイスサービスへ都度問い合わせるため、電源が入っていないクラウドフォンでは MoreLogin のエラーではなくデバイスサービス側で失敗するのが通常です。 - **副作用**：なし。読み取
 - [POST /cloudphone/app/start](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/cloudphoneappstartpost.md): クラウドフォンにインストール済みのアプリを起動します。 - **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。 - **完了シグナル**：レスポンスはコマンドがデバイスサービスへ到達したことを示すもので、アプリが前面に出たことは意味しません。実行中のアプリを報告するエンドポイントはないため、スクリーンキャプチャまたはシェルコマンドで確認してください。 - **リトラ
 - [POST /cloudphone/app/restart](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/cloudphoneapprestartpost.md): クラウドフォン上のアプリを再起動します。 - **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。**アプリがインストール済みかどうかは検証されません** — 存在しないパッケージを指定しても単に何も起こりません。 - **完了シグナル**：レスポンスはコマンドがデバイスサービスへ送信されたことを示すもので、アプリが再起動したことは意味しません。`/cloudphon
 - [POST /cloudphone/app/stop](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/cloudphoneappstoppost.md): クラウドフォン上で動作中のアプリを停止します。 - **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。アプリがインストール済みか、動作中かは検証されません。 - **完了シグナル**：レスポンスはコマンドがデバイスサービスへ送信されたことを示すもので、アプリが停止したことは意味しません。
 - [POST /cloudphone/app/uninstall](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/cloudphoneappuninstallpost.md): クラウドフォンからアプリをアンインストールします。 - **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。 - **副作用**：アンインストールを送信し、そのクラウドフォンのインストール記録を更新します。 - **完了シグナル**：レスポンスはリクエストが受理されたことを示します。`/cloudphone/app/installedList` で確認してください。
 - [POST /cloudphone/app/openRoot](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/cloudphoneappopenrootpost.md): クラウドフォン上の特定のアプリパッケージに ROOT 権限を付与します。 - **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。対応機種で対応。非対応の機種では呼び出しは成功しますが効果はありません。 - **副作用**：パッケージの許可リストを端末へ送信し、副作用として ROOT スイッチを ON にします。**MoreLogin 側には何も保存されない**ため、
 - [POST /cloudphone/app/setHideAccessibilityApp](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/apps/cloudphoneappsethideaccessibilityapppost.md): 1 台以上のクラウドフォンで、Android のユーザー補助サービス一覧からアプリを隠します。 - **前提条件**：クラウドフォン ID を 1〜100 件、パッケージ名を 1〜100 件。クラウドフォンは自チームのものである必要がありますが、起動済みである必要も、自分が占有している必要も**ありません**。ID がひとつも解決できない場合は、エラーではなく業務上の失敗として返されます。 - *