Method: projects.locations.connections.gitRepositoryLinks.addPullRequestReviewComment

Ajouter un commentaire d'examen (intégré au diff) à une demande d'extraction.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource du GitRepositoryLink au format projects/*/locations/*/connections/*/gitRepositoryLinks/*.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
Champs
pullRequestId

string

Obligatoire. ID de la demande d'extraction.
comment

object (PullRequestReviewComment)

Obligatoire. Commentaire d'examen à ajouter.
commitId

string

Facultatif. SHA du commit à commenter. Si aucune valeur n'est spécifiée, la valeur par défaut est le commit HEAD de la demande d'extraction.

Corps de la réponse

Message représentant un commentaire de révision de demande d'extraction SCM (intégré à la différence).

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Champs
id

string

Uniquement en sortie. ID du commentaire.
body

string

Obligatoire. Corps du commentaire.
path

string

Obligatoire. Chemin d'accès au fichier à commenter.
firstLine

integer

Facultatif. Première ligne de la plage de commentaires (incluse). Si aucune valeur n'est spécifiée, le commentaire ne s'applique qu'à lastLine.
lastLine

integer

Obligatoire. Dernière ligne de la plage de commentaires (incluse). Si firstLine n'est pas spécifié, le commentaire ne s'applique qu'à cette ligne.
side

enum (DiffSide)

Facultatif. Côté de la différence à commenter. La valeur par défaut est HEAD.
author

string

Uniquement en sortie. Nom d'utilisateur de l'auteur.
createTime

string (Timestamp format)

Uniquement en sortie. Date de création du commentaire.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Date de mise à jour du commentaire.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
commitId

string

Uniquement en sortie. SHA du commit auquel le commentaire a été appliqué.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • developerconnect.gitRepositoryLinks.addPullRequestReviewComment

Pour en savoir plus, consultez la documentation IAM.

DiffSide

"DiffSide" représente le côté de la différence sur lequel se trouve le commentaire.

Enums
DIFF_SIDE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
BASE Côté de la comparaison avant les modifications (lignes supprimées ou modifiées).
HEAD Côté de la comparaison après les modifications (lignes ajoutées ou modifiées).