Method: projects.locations.connections.gitRepositoryLinks.addPullRequestReviewComment

Fügen Sie einem Pull-Anfrage einen Überprüfungskommentar (inline im Diff) hinzu.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Pflichtangabe. Der Ressourcenname des GitRepositoryLink im Format projects/*/locations/*/connections/*/gitRepositoryLinks/*.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
Felder
pullRequestId

string

Pflichtangabe. Die ID des Pull-Requests.
comment

object (PullRequestReviewComment)

Pflichtangabe. Der hinzuzufügende Überprüfungskommentar.
commitId

string

Optional. Der Commit-SHA, der kommentiert werden soll. Wenn nicht angegeben, wird standardmäßig der HEAD-Commit der Pull-Anfrage verwendet.

Antworttext

Nachricht, die einen SCM-Pull-Anfrage-Überprüfungskommentar darstellt (inline im Diff).

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

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

string

Nur Ausgabe. Die ID des Kommentars.
body

string

Pflichtangabe. Der Text des Kommentars.
path

string

Pflichtangabe. Der Dateipfad, zu dem ein Kommentar hinzugefügt werden soll.
firstLine

integer

Optional. Die erste Zeile des Kommentarbereichs (einschließlich). Wenn nichts angegeben ist, gilt der Kommentar nur für die lastLine.
lastLine

integer

Pflichtangabe. Die letzte Zeile des Kommentarbereichs (einschließlich). Wenn firstLine nicht angegeben ist, gilt der Kommentar nur für diese Zeile.
side

enum (DiffSide)

Optional. Die Seite des Diff, die kommentiert werden soll. Die Standardeinstellung ist HEAD.
author

string

Nur Ausgabe. Der Nutzername des Autors.
createTime

string (Timestamp format)

Nur Ausgabe. Wann der Kommentar erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Wann der Kommentar aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
commitId

string

Nur Ausgabe. Der Commit-SHA, auf den der Kommentar tatsächlich angewendet wurde.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • developerconnect.gitRepositoryLinks.addPullRequestReviewComment

Weitere Informationen finden Sie in der IAM-Dokumentation.

DiffSide

„DiffSide“ gibt an, auf welcher Seite des Vergleichs sich der Kommentar befindet.

Enums
DIFF_SIDE_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
BASE Die Seite des Diff vor den Änderungen (gelöschte oder geänderte Zeilen).
HEAD Die Seite des Diff nach den Änderungen (hinzugefügte oder geänderte Zeilen).