Method: projects.locations.connections.gitRepositoryLinks.addPullRequestReviewComment

הוספת תגובת ביקורת (בתוך השורה ב-diff) לבקשת משיכה.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
name

string

חובה. שם המשאב של GitRepositoryLink בפורמט projects/*/locations/*/connections/*/gitRepositoryLinks/*.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
שדות
pullRequestId

string

חובה. המזהה של בקשת משיכה (pull request).
comment

object (PullRequestReviewComment)

חובה. התגובה לביקורת שרוצים להוסיף.
commitId

string

זה שינוי אופציונלי. ה-SHA של ה-commit שעליו רוצים להגיב. אם לא מציינים את הפרמטר, ברירת המחדל היא ה-commit של ה-HEAD של בקשת משיכה (pull request).

גוף התשובה

הודעה שמייצגת הערה על בדיקה של בקשת משיכה ב-SCM (בתוך השורה ב-diff).

אם הפעולה מצליחה, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
שדות
id

string

פלט בלבד. המזהה של התגובה.
body

string

חובה. גוף התגובה.
path

string

חובה. נתיב הקובץ שרוצים להגיב עליו.
firstLine

integer

זה שינוי אופציונלי. השורה הראשונה בטווח התגובות (כולל). אם לא מציינים את זה, ההערה חלה רק על lastLine.
lastLine

integer

חובה. השורה האחרונה בטווח התגובות (כולל). אם לא מציינים את firstLine, ההערה חלה רק על השורה הזו.
side

enum (DiffSide)

זה שינוי אופציונלי. הצד של ההבדל שעליו רוצים להגיב. ברירת המחדל היא HEAD.
author

string

פלט בלבד. שם המשתמש של המחבר.
createTime

string (Timestamp format)

פלט בלבד. מתי התגובה נוצרה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

פלט בלבד. מתי התגובה עודכנה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
commitId

string

פלט בלבד. ה-SHA של ה-commit שהתגובה הוחלה עליו בפועל.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

ניתן למצוא מידע נוסף כאן: Authentication Overview.

הרשאות IAM

נדרשת הרשאת IAM הבאה במשאב name:

  • developerconnect.gitRepositoryLinks.addPullRequestReviewComment

מידע נוסף זמין במאמרי העזרה בנושא IAM.

DiffSide

השדה DiffSide מייצג את הצד של ההשוואה שבו נמצאת התגובה.

טיפוסים בני מנייה (enum)
DIFF_SIDE_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
BASE הצד של ההשוואה לפני השינויים (שורות שנמחקו או שונו).
HEAD הצד של ההשוואה אחרי השינויים (שורות שנוספו או שונו).