ドキュメントを探す
はじめに
サインアップ前に Google の検索を試し、同じ CLI プロファイルを使用して保つために所有者のアカウントを接続します。
このページの内容
1. 既存のアクセスを確認する
エージェントの環境でこの無料チェックを実行します。 data.accessVerified が true と Google Search が許可されている場合は、3 へのアクセスとスキップを再利用します。 保存したプロファイルがない場合は、2 のステップを続けてください。 下の回復セクションを使用して保留またはブロックされたアクセスを再開します。
flashdata auth status --json --non-interactive同じプロフィールを保って下さい
ワーキングアクセスレポート data.accessVerified: true, access: ready でん data.identity.identity, , , google_search でん data.identity.permittedSources.
これらのコマンドは、デフォルトプロファイルを使用して、Bash または PowerShell で動作します。 既存の名前付きプロファイルまたはカスタムステートディレクトリには、同じ--profile NAMEと--state-dir ABSOLUTE_PATHを新しいターミナルを含むすべてのコマンドに追加します。
FLASHDATA_API_KEY は保存済みのキーより優先されます。このプロファイルの試用と認証情報の引き渡しをテストするときは、この変数を未設定にしてください。同じ OS ユーザーを使い、非公開の状態ディレクトリを保持してください。このディレクトリには認証情報、登録証明、実行履歴が保存されます。
インスペクト credentialProtection でん auth status. WindowsはDPAPI、macOSはKeychainを使用し、ヘッドレスLinuxは所有者専用の認証ファイルを使用するかもしれません。 --credential-store os では、OS ストアをご購入いただけます。
既存のオーナーキーを代わりに使用
ターミナルを操作する人は、下の非表示入力プロンプトからキーを取り込み、試用登録とアカウント連携を省略できます。エージェントは秘密情報ストアから --api-key-stdin --non-interactive を使って stdin にキーを渡してください。引数やチャットにキーを含めないでください。
プロフィールが既に異なるアクセスを保持している場合は、auth login --replaceを使用する前にそれを見直してください。 別のキーをインポートすることは、クレームハンドオフではありません。 MCP OAuthは別のホスト関係です。
flashdata auth login
flashdata auth status --json --non-interactive2. 1つの資格試験を開始
最初に discover を実行し、data.onboardingAvailable と data.onboarding.trial の利用枠を確認します。オンボーディングが利用可能なら、Google Search 用に init を 1 回実行します。サーバーが利用資格を確認し、CLI が一時キーを保存します。サインアップ画面は開かず、クエリも送信しません。
flashdata discover --json --non-interactiveflashdata init --name "Research assistant" --scopes google_search --json --non-interactive参加登録の領収書の確認
ok: true、data.status: trial、および data.connection.scopes に google_search が含まれることを確認します。data.connection.trialExpiresAt と data.startingAllowanceCredits を読み取ってください。キーは表示されず、ローカルに保存されます。data.currentBalanceAvailable が false の場合は、クエリを送る前に無料の残高確認を再実行します。
セットアップでアクセスが作成済みなら再利用します。初回登録にエージェントの情報を付けるには、--client codex --audience coding または --client openclaw --audience personal を指定します。再試行時は入力を完全に同じにしてください。このラベルによって権限が付与されることはありません。
試用手当と制限
リクエスト換算値は同じ開始時クレジット残高を使った目安です。残りリクエスト数でも、独立した利用枠でもありません。YouTube Download など所有者専用のソースでは、試用クレジットを使えません。
| 制限なし | 確認するべきこと |
|---|---|
| クレジット / 有効期限 | 現在のデフォルト: 72 時間の 1 クレジット。 助成金と生涯の発見を読みます。 領収書は、有効期限と付与された情報源を与えます。 |
| 参加申し込み | 同一 IP につき 24 時間で 3 件まで登録できます。同じ IP を使うユーザー間で共有される上限です。試用の全体上限により新規登録が一時停止される場合もあります。 |
| コンポレーション | 試用中は順番に処理してください。バッチは 1 件、未完了ジョブは 1 件までです。追加送信の前に、返された制限値を確認します。 |
3. 1つの検索を試す
まずプレビューを実行します。data.estimateAvailable が有効で、data.estimate.prices に利用可能な google_search 料金があり、availableCredits が estimatedCredits 以上であることを確認してください。確認に失敗したら停止します。プレビューは無料ですが、次のコマンドは検索を 1 回送信します。
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactiveflashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactive結果を確認
ok: true と data.status: done を確認します。タイトル、リンク、抜粋は data.results[].organic、消費クレジットは data.usage.credits にあります。organic が空でも有効な結果です。アカウント連携前に同じタスクを trial-search で再実行すると、保存済みの結果を返します。プロファイルと状態を保持し、必要な試用結果を保存してください。
flashdata account balance --json --non-interactive4. オーナーアカウントでのアクセスを保って下さい
継続利用や定期実行が必要なら、試用期限が切れる前にアカウントに連携します。所有者の準備ができたら、元のプロファイルで実行してください。所有者には data.claimUrl と data.confirmationCode だけを共有します。有効期限は data.expiresAt で確認できます。
リンクの有効期限は 15 分、またはそれより早い試用期限までです。リンクの作成だけではアクセスは承認されず、クレジットも購入されません。
flashdata auth claim --json --non-interactiveブラウザで承認する
- 所有者は、リンクとサインインを開き、新しいアカウントを作成し、電子メールを検証します。 新規登録は、確認後にクレームを再開します。
- クレームページに記載されているアカウントを確認してください。 別の所有者または新しい所有者のために、別のブラウザセッションを使用します。 署名されたアカウントは、後でリクエストを支払うアカウントです。
- そのページにある8桁のコードを入力し、製品の許可と共有バランスアクセスを見直し、承認します。 所有者は、サインアップ、法的受諾、電子メールの検証、同意を処理します。
元のターミナルで終わり
承認後、24時間内のオリジナルプロファイルでfinishを実行します。 CLIは所有者のキーを救い、それを新しいプロセスで確認し、取付けを認めます。 ブラウザからキーがコピーされていない。
flashdata auth finish --wait --timeout 10m --json --non-interactiveflashdata auth status --json --non-interactive
flashdata account balance --json --non-interactiveオーナーと残高の確認
auth status で目的の accountId、付与済みの scopes、以下の項目を確認します。最新の残高は別途確認してください。以後のリクエストは所有者の共有クレジットを消費します。未使用の一時クレジットは移行されません。新しいアカウントには通常の登録条件が適用され、連携による追加の登録特典はありません。
アカウント連携により課金先が変わります。所有者のアカウントで新しいタスクを実行するときは、新しい実行 ID を使います。試用中の実行 ID を再利用すると、新たなクエリは送信されず run_account_mismatch が返されます。その実行が所有者に移行されることはありません。
{
"ok": true,
"data": {
"accessVerified": true,
"identity": {
"identity": {
"accountType": "owned",
"access": "ready",
"installed": true,
"recurringAllowed": true
}
}
}
}製品の許可を選択します。
HTTP 権限カタログでは trialEligible と ownerAllowed を分けています。初回登録の前に、タスクに必要なソースだけを要求してください。requestedScopes は要求した権限、scopes はキーに現在付与されているアクセス権を表します。新しい製品には明示的な権限付与が必要です。
承認すると、購入済みクレジットを含む所有者の共有残高を利用できます。ソースの制限はエージェントごとの支出上限にはなりません。MCP OAuth は別の接続であり、この CLI プロファイルをアカウントに紐付けるものではありません。
YouTube Downloadだけ必要か。
youtube_download 権限のある所有者キーを取り込み、保存先ストレージを設定します。Download では一時的な試用クレジットは使えません。
CLI 1.2.1 の init には、まだ試用対象ソースが必要です。登録前に Download だけを利用する場合は、auth.md の HTTP 連携フローを使ってください。クライアントの制限を回避するために、無関係な試用ソースを追加しないでください。
停止フローを再開
| 何が止まったのか | 次のアクション |
|---|---|
| 会員登録 | 429 の場合は Retry-After に従って待機します。レスポンスを受信できなかった場合は、同じプロファイル、登録証明、完全に同じ入力で init を再試行します。既存の状態を保持し、IP を変えたり代わりの試用を作ったりしないでください。 |
| 検索 | 下の trial-search を確認します。タイムアウトだけでは、処理が受け付けられなかったとは判断できません。再試行を強制するために実行 ID を変更しないでください。 |
| クレームリンク | リンクの期限が切れていても試用が有効なら、所有者の準備ができた時点で同じプロファイルから新しいリンクを作成します。承認前に、ログイン中の所有者が正しいか確認してください。 |
| ハンドオフ | 承認後、24時間以内に元のプロフィールでauth finishを再実行して下さい。 承認の終了、中断された待ち時間、または失った承認は、新規登録を必要としません。 |
| 期限切れ/失われた状態 | 試用や認証情報の受け渡し期限が切れた場合、または非公開の状態ディレクトリを失った場合は、所有者の承認を得て再接続するか、所有者キーを取り込みます。 |
flashdata runs show trial-search --json --non-interactive