Method: projects.locations.connections.gitRepositoryLinks.fetchCommitList

Git リポジトリのリンクから commit のリストを取得します。

HTTP リクエスト

GET https://developerconnect.googleapis.com/v1/{name=projects/*/locations/*/connections/*/gitRepositoryLinks/*}:fetchCommitList

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

パスパラメータ

パラメータ
name

string

必須。GitRepositoryLink のリソース名(projects/*/locations/*/connections/*/gitRepositoryLinks/* 形式)。

クエリ パラメータ

パラメータ
ref

string

省略可。commit SHA、または commit の一覧表示を開始するシンボリック リビジョン(ブランチ名、タグ、Git 参照など)。

pageSize

integer

省略可。リストで返す結果の数。デフォルトは 50 です。最大値は 100 です。

pageToken

string

省略可。前回の gitRepositoryLinks.fetchCommitList 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページ分割を行う場合、gitRepositoryLinks.fetchCommitList に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。

view

enum (CommitView)

省略可。レスポンスで返される commit の詳細のレベル。BASIC のみがサポートされています。FULL は INVALID_ARGUMENT を返します。指定しない場合のデフォルトは BASIC です。gitRepositoryLinks.fetchCommit を使用して、1 つの commit のファイルの差分を取得します。

リクエストの本文

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

レスポンスの本文

gitRepositoryLinks.fetchCommitList のレスポンス メッセージ。

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

JSON 表現
{
  "commits": [
    {
      object (SCMCommit)
    }
  ],
  "nextPageToken": string
}
フィールド
commits[]

object (SCMCommit)

commit メタデータのリスト。

nextPageToken

string

次のページを取得するために pageToken として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

認可スコープ

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

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

詳細については、Authentication Overview をご覧ください。

IAM 権限

name リソースに対する次の IAM 権限が必要です。

  • developerconnect.gitRepositoryLinks.fetchCommitList

詳細については、IAM のドキュメントをご覧ください。