Method: projects.apps.generatePlayIntegrityChallenge

Play Integrity API に対する完全性判定の結果リクエストの直後の完全性を保護するチャレンジを生成します。生成された完全性トークンを使用して apps.exchangePlayIntegrityToken を次に呼び出すと、チャレンジの存在と有効性が検証されます。チャレンジは複数回の呼び出しで再利用できません。

HTTP リクエスト

POST https://firebaseappcheck.googleapis.com/v1beta/{app=projects/*/apps/*}:generatePlayIntegrityChallenge

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
app

string

必須。アプリの相対的なリソース名。形式は次のとおりです。

projects/{project_number}/apps/{app_id}

必要に応じて、project_number 要素を Firebase プロジェクトのプロジェクト ID に置き換えることができます。Google の AIP 2510 規格でのプロジェクト ID の使用方法の詳細。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

apps.generatePlayIntegrityChallenge メソッドに対するレスポンス メッセージ。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "challenge": string,
  "ttl": string
}
フィールド
challenge

string

クライアントが Play Integrity API に渡すための 1 回限りのチャレンジ。
ttl

string (Duration format)

このチャレンジが作成されてから有効期限が切れるまでの時間。このフィールドは、クライアントサイドのトークン管理を容易にすることを目的としています。クライアントはクロックにずれがある可能性はありますが、それでも期間を正確に測定できます。

「s」で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

承認スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/firebase

詳細については、認証の概要をご覧ください。