Method: projects.locations.connections.gitRepositoryLinks.addPullRequestReviewComment

Agrega un comentario de revisión (intercalado en la diferencia) a una solicitud de extracción.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
name

string

Obligatorio. Es el nombre del recurso de GitRepositoryLink en el formato projects/*/locations/*/connections/*/gitRepositoryLinks/*.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
Campos
pullRequestId

string

Obligatorio. Es el ID de la solicitud de extracción.
comment

object (PullRequestReviewComment)

Obligatorio. Es el comentario de la opinión que se agregará.
commitId

string

Es opcional. Es el SHA de la confirmación sobre la que se comentará. Si no se especifica, se usa de forma predeterminada la confirmación HEAD de la solicitud de extracción.

Cuerpo de la respuesta

Es un mensaje que representa un comentario de revisión de solicitud de extracción de SCM (intercalado en diff).

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Campos
id

string

Solo salida. Es el ID del comentario.
body

string

Obligatorio. Es el cuerpo del comentario.
path

string

Obligatorio. Es la ruta de acceso del archivo sobre el que se agregará el comentario.
firstLine

integer

Es opcional. Es la primera línea del rango de comentarios (inclusive). Si no se especifica, el comentario se aplica solo a lastLine.
lastLine

integer

Obligatorio. Es la última línea del rango de comentarios (inclusive). Si no se especifica firstLine, el comentario se aplica solo a esta línea.
side

enum (DiffSide)

Es opcional. El lado de la diferencia que se comentará. La configuración predeterminada es HEAD.
author

string

Solo salida. Es el nombre de usuario del autor.
createTime

string (Timestamp format)

Solo salida. Cuándo se creó el comentario.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Cuándo se actualizó el comentario.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
commitId

string

Solo salida. Es el SHA de confirmación al que se aplicó el comentario.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • developerconnect.gitRepositoryLinks.addPullRequestReviewComment

Para obtener más información, consulta la documentación de IAM.

DiffSide

DiffSide representa en qué lado de la diferencia se encuentra el comentario.

Enums
DIFF_SIDE_UNSPECIFIED Valor predeterminado. Este valor no se usa.
BASE El lado de la diferencia antes de los cambios (líneas borradas o modificadas).
HEAD El lado de la diferencia después de los cambios (líneas agregadas o modificadas).