Method: projects.histories.list

特定のプロジェクトの履歴をリストします。

履歴は変更時刻の降順に並べられます。 HistoryId キーは、同じ変更時刻を持つ履歴を並べ替えるのに使用されます。

次の正規エラー コードのいずれかを返す場合があります。

  • PERMISSION_DENIED - ユーザーがプロジェクトを読み取る権限を持たない場合
  • INVALID_ARGUMENT - リクエストの形式が不正な場合
  • NOT_FOUND - 履歴が存在しない場合

HTTPリクエスト

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories

URL はgRPC トランスコーディング構文を使用します。

パスパラメータ

パラメーター
projectId

string

プロジェクト ID。

必須。

クエリパラメータ

パラメーター
pageToken

string

次の項目でクエリを再開するための継続トークン。

オプション。

pageSize

integer

取得する履歴の最大数。

デフォルト値: 20。フィールドが設定されていないか、値が 0 の場合、サーバーはこのデフォルトを使用します。100 を超える値は 100 として扱われます。

オプション。

filterByName

string

設定すると、指定された名前の履歴のみが返されます。

オプション。

リクエストボディ

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

レスポンスボディ

HistoryService.Listの応答メッセージ

成功した場合、応答本文には次の構造のデータが含まれます。

JSON表現
{
  "histories": [
    {
      object (History)
    }
  ],
  "nextPageToken": string
}
田畑
histories[]

object ( History )

歴史。

nextPageToken

string

次の項目でクエリを再開するための継続トークン。

取得する履歴がさらにある場合にのみ設定されます。

トークンは、最初のリスト要求の時点から最大 1 時間有効です。たとえば、午後 1 時にリスト リクエストを作成し、その 10 分後にこの最初のリクエストのトークンを使用した場合、この 2 番目のレスポンスのトークンは 50 分間のみ有効になります。

認可範囲

次の OAuth スコープが必要です。

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

詳細については、 「認証の概要」を参照してください。