- Permintaan HTTP
- Parameter jalur
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- Izin IAM
- DiffSide
- Cobalah!
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 |
Wajib. Nama resource GitRepositoryLink dalam format |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
| Representasi JSON |
|---|
{
"pullRequestId": string,
"comment": {
object ( |
| Kolom | |
|---|---|
pullRequestId |
Wajib. ID Permintaan Pull. |
comment |
Wajib. Komentar ulasan yang akan ditambahkan. |
commitId |
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 ( |
| Kolom | |
|---|---|
id |
Hanya output. ID komentar. |
body |
Wajib. Isi komentar. |
path |
Wajib. Jalur file yang akan dikomentari. |
firstLine |
Opsional. Baris pertama rentang komentar (inklusif). Jika tidak ditentukan, komentar hanya berlaku untuk |
lastLine |
Wajib. Baris terakhir rentang komentar (inklusif). Jika |
side |
Opsional. Sisi diff yang akan dikomentari. Default-nya adalah HEAD. |
author |
Hanya output. Nama pengguna penulis. |
createTime |
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: |
updateTime |
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: |
commitId |
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). |