---
description: OpenTesterのアプリ、テスター参加、フィードバック、修正作業、認証の境界を説明します。
---

# 基本概念とワークフロー {#core-concepts-and-workflow}

## アプリとテスター参加 {#apps-and-tester-enrollment}

**アプリ（App）**はフィードバック、アクセス権、修正作業の管理単位です。現在、各アプリには1人の開発者所有者がいます。APIの`appId`は登録時に発行されるUUIDで、Androidのパッケージ名とは異なります。

**参加（Enrollment）**は、テスターが特定アプリに参加する状態を表します。即時参加では申請と同時に承認され、承認制では開発者が審査します。SDKログインと認証済みリクエストの際にサーバーが承認状態を確認します。参加権限を取り消すと、既存のSDKトークンでもそのアプリにアクセスできません。

| 手順 | 目的 | 他の権限との関係 |
| --- | --- | --- |
| Google Groupへの加入 | Playテストをインストールできるグループへの参加 | OpenTesterの承認とは別 |
| Google Playのオプトイン | 対象アプリのPlayテストへの参加 | SDKログインとは別 |
| OpenTesterの参加承認 | アプリのSDK利用とフィードバック送信 | Playのインストールや参加完了を証明しない |

Playテストトラックとインストールリンクは開発者が用意します。OpenTesterは、テスターのグループ所属や各テスターのPlay Console参加状態を自動確認しません。

## フィードバックとバグ報告 {#feedback-and-bug-reports}

テキスト報告は`kind`で一般的な意見（`feedback`）とバグ（`bug`）を区別します。バグには再現手順、期待する結果、実際の結果を添えられます。

| 状態 | 意味 |
| --- | --- |
| `open` | 受付済み |
| `confirmed` | 開発者が確認中 |
| `fixed` | 開発者が修正済みとしてマーク |
| `closed` | 終了 |

報告の状態と貢献審査は別です。PRを関連付けても、自動的に`fixed`になったり報酬が付与されたりはしません。

## 修正作業とPR {#change-requests-and-prs}

**修正作業（Change request）**は、1件以上の報告を実装依頼としてまとめます。タイトル、修正指示、完了条件、フィードバックIDを保存します。記録を作成した後、コーディングエージェントがリポジトリで作業できます。

```text
フィードバック取得 → 詳細確認 → 修正作業作成 → コード変更・テスト → PR URL関連付け
      API/MCP        API/MCP       API/MCP       エージェント          API/MCP
```

新しい作業は`open`です。既存のGitHub PR URLを1件関連付けると`pr_linked`になります。これは追跡用の記録であり、サーバーはPRの存在やマージ状態を確認しません。作成、レビュー、マージ、デプロイは通常の開発フローで行います。

`clientRequestId`は再試行時の重複作成を防ぎます。新しい作業ごとにUUIDを生成し、再試行では同じUUIDと本文を使います。別のエージェントによる同じフィードバックへの別作業作成までは防がないため、先に既存作業を確認してください。

## 認証情報を使い分ける {#choose-the-right-credentials}

| 認証情報 | 用途 | 権限の範囲 |
| --- | --- | --- |
| Webセッション | Webサイト、開発者コンソール、トークン管理 | ログインユーザーとアプリ所有権 |
| SDK Bearerトークン | Androidの権限確認と報告送信 | 1つのアプリのテスター承認 |
| エージェントBearerトークン | Automation APIとMCP | 1つのアプリと付与されたスコープ |

SDKトークンとエージェントトークンは代用できません。エージェントトークンをAndroidアプリや公開ブラウザーコードに埋め込まないでください。[API認証](/ja/api/authentication)を参照してください。

## 報告はユーザー入力として扱う {#treat-reports-as-user-input}

フィードバックは修正の根拠となる資料です。本文内の命令、リンク、スクリプトをプロジェクト指示として扱わないようエージェントに伝えてください。秘密情報や個人情報を含めないようテスターに案内し、外部エージェントに共有する内容を確認します。