Method: projects.locations.connections.gitRepositoryLinks.addPullRequestReviewComment

Aggiungi un commento di revisione (incorporato nella differenza) a una richiesta di pull.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
name

string

Obbligatorio. Il nome risorsa di GitRepositoryLink nel formato projects/*/locations/*/connections/*/gitRepositoryLinks/*.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
Campi
pullRequestId

string

Obbligatorio. L'ID della richiesta di pull.
comment

object (PullRequestReviewComment)

Obbligatorio. Il commento della recensione da aggiungere.
commitId

string

Facoltativo. Lo SHA del commit da commentare. Se non specificato, il valore predefinito è il commit HEAD della richiesta di pull.

Corpo della risposta

Messaggio che rappresenta un commento alla revisione di una richiesta di pull SCM (incorporato nella differenza).

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

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

string

Solo output. L'ID del commento.
body

string

Obbligatorio. Il corpo del commento.
path

string

Obbligatorio. Il percorso del file da commentare.
firstLine

integer

Facoltativo. La prima riga dell'intervallo di commenti (inclusa). Se non specificato, il commento si applica solo a lastLine.
lastLine

integer

Obbligatorio. L'ultima riga dell'intervallo di commenti (inclusa). Se firstLine non è specificato, il commento si applica solo a questa riga.
side

enum (DiffSide)

Facoltativo. Il lato della differenza da commentare. Il valore predefinito è HEAD.
author

string

Solo output. Il nome utente dell'autore.
createTime

string (Timestamp format)

Solo output. Quando è stato creato il commento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Quando è stato aggiornato il commento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
commitId

string

Solo output. Lo SHA del commit a cui è stato effettivamente applicato il commento.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa name:

  • developerconnect.gitRepositoryLinks.addPullRequestReviewComment

Per saperne di più, consulta la documentazione di IAM.

DiffSide

DiffSide rappresenta il lato della differenza su cui si trova il commento.

Enum
DIFF_SIDE_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
BASE Il lato della differenza prima delle modifiche (righe eliminate o modificate).
HEAD Il lato della differenza dopo le modifiche (righe aggiunte o modificate).