Method: projects.locations.connections.gitRepositoryLinks.addPullRequestReviewComment

Menambahkan komentar ulasan (inline pada diff) ke Permintaan Pull.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama resource GitRepositoryLink dalam format projects/*/locations/*/connections/*/gitRepositoryLinks/*.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
Kolom
pullRequestId

string

Wajib. ID Permintaan Pull.

comment

object (PullRequestReviewComment)

Wajib. Komentar ulasan yang akan ditambahkan.

commitId

string

Opsional. SHA commit yang akan diberi komentar. Jika tidak ditentukan, setelan defaultnya adalah commit HEAD dari Permintaan Pull.

Isi respons

Pesan yang mewakili Komentar Peninjauan Permintaan Pull SCM (inline pada diff).

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Kolom
id

string

Hanya output. ID komentar.

body

string

Wajib. Isi komentar.

path

string

Wajib. Jalur file yang akan dikomentari.

firstLine

integer

Opsional. Baris pertama rentang komentar (inklusif). Jika tidak ditentukan, komentar hanya berlaku untuk lastLine.

lastLine

integer

Wajib. Baris terakhir rentang komentar (inklusif). Jika firstLine tidak ditentukan, komentar hanya berlaku untuk baris ini.

side

enum (DiffSide)

Opsional. Sisi diff yang akan dikomentari. Default-nya adalah HEAD.

author

string

Hanya output. Nama pengguna penulis.

createTime

string (Timestamp format)

Hanya output. Waktu saat komentar dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Hanya output. Waktu saat komentar diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

commitId

string

Hanya output. SHA commit yang sebenarnya diterapkan pada komentar.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Izin IAM

Memerlukan izin IAM berikut pada resource name:

  • developerconnect.gitRepositoryLinks.addPullRequestReviewComment

Untuk mengetahui informasi selengkapnya, baca dokumentasi IAM.

DiffSide

DiffSide menunjukkan sisi diff tempat komentar berada.

Enum
DIFF_SIDE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
BASE Sisi diff sebelum perubahan (baris yang dihapus atau diubah).
HEAD Sisi diff setelah perubahan (baris yang ditambahkan atau diubah).