Google の AI アシスタントである Gemini は、他のデベロッパー ツールとともに、Google Health API のドキュメントを理解し、このサイトで直接利用できる機能を通じて API 呼び出しをテストするのに役立ちます。
チャット付きの情報パネル
この機能は、閲覧中にリアルタイムでドキュメントのサポートを提供します。 チャットにアクセスするには、このサイトの技術記事の [情報パネル] サイドバーを使用します。チャットの回答は、閲覧しているページのコンテンツにのみ基づいています。 チャットで質問に回答できないと表示された場合、現在のページにその情報はありません。これにより、目的のトピックの正しいページにアクセスしていることを確認できます。この機能は、複雑なページを要約したり、テキスト内の特定の詳細をすばやく見つけたりするのに最適です。
Gemini とのチャットを使用する手順は次のとおりです。
- ページの右上にあるアイコンをクリックします。
- アカウントを作成して Google Developer Program に参加します。
- 利用規約とプライバシーに関する合意に同意します。
コードの説明
コードの説明を使用して、コードサンプルの実装の詳細を理解します。すべての コードブロックには、アイコン ボタンが含まれています。このアイコンをクリックすると、情報パネルに説明が表示されます。Gemini はコードの言語を識別し、そのロジックを説明します。情報パネルで「このコールバックが使用されたのはなぜですか？」や「別のシナリオに合わせてこれを調整するにはどうすればよいですか？」などのフォローアップの質問をして、理解を深めます。
プロンプトのベスト プラクティス
Gemini のオンサイト機能を最大限に活用するには、次のプロンプト手法を使用します。
- ペルソナを割り当てる: Gemini に役割を伝えて、回答を調整します。例: 「あなたは Google Health API を統合する経験豊富な Kotlin デベロッパーであるとします。」
- ステップごとのロジックを使用する: 1 つのプロンプトで Gemini に複雑なタスクを実行させないでください。代わりに、リクエストを分割して反復します。メモを提供し、下書きをリクエストし、フィードバックを提供し、修正をリクエストします。
- 形式の例を提供する: HTML テーブルなどの特定の出力が必要な場合は、選択した形式の小さな例をプロンプトに含めます。
インタラクティブな API Explorer
このサイトには、ローカル設定なしでブラウザで直接 API 呼び出しをテストできるインタラクティブ ツールである API Explorer が含まれています。このツールの使用方法について詳しくは、 API Explorer のドキュメントをご覧ください。
仕組み
API リファレンス ページで、[Try this method] パネルを使用してパラメータを入力し、[Execute] をクリックします。これにより、Health API にライブ リクエストが送信され、JSON レスポンスがブラウザに直接表示されます。たとえば、 users.dataTypes.dataPoints/list をご覧ください。
API Explorer にアクセスする手順は次のとおりです。
- API リファレンス ページの右側にある [Try this method] パネルを見つけます。
- Google デベロッパー アカウントにログインし、リクエストを承認するための OAuth 2.0 アクセス トークンを取得していることを確認します。
- [Try this method] パネルで、[API Key] のチェックを外し、代わりにそのフィールドにアクセス トークンを入力します。
- 必須フィールドを入力して、[Execute] をクリックします。
デベロッパーにとっての利点
- 設定不要の検証: コードを記述する前に API レスポンスを確認します。
- レスポンス構造: API レスポンスの正確な JSON 構造を表示します。 この出力を使用して、解析ロジックを作成したり、AI プロンプトのコンテキストを提供したりできます。
- 速度: 試行錯誤を減らすことで開発を加速します。