Method: projects.histories.list

指定されたプロジェクトの履歴を一覧表示します。

履歴は、変更日時の降順で並べ替えられます。historyId キーは、同じ変更日時の履歴を並べ替えるために使用されます。

次の標準的なエラーコードのいずれかを返すことがあります。

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
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

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

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

トークンは、最初の list リクエストを行ってから最大 1 時間有効です。たとえば、午後 1 時にリスト リクエストを行い、10 分後にこの最初のリクエストのトークンを使用した場合、この 2 番目のレスポンスのトークンは 50 分間のみ有効です。

認可スコープ

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

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

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