Method: projects.locations.connections.gitRepositoryLinks.fetchFileBlame

אחזור מידע על האשמה בקובץ או בטווח שורות בקובץ.

בקשת HTTP

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

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

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

פרמטרים
name

string

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

פרמטרים של שאילתה

פרמטרים
ref

string

חובה. ה-SHA של ה-commit ב-SCM, או הגרסה הסמלית (לדוגמה, שם ההסתעפות, התג) שממנה צריך לאחזר את ה-blame.
path

string

חובה. נתיב הקובץ במאגר.
firstLine

integer

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

integer

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

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

הודעת התגובה ל-gitRepositoryLinks.fetchFileBlame.

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

ייצוג ב-JSON 
{
  "ranges": [
    {
      object (BlameRange)
    }
  ]
}
שדות
ranges[]

object (BlameRange)

רשימת טווחי השורות בקובץ שבהם בוצעו שינויים.

היקפי הרשאות

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

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

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

הרשאות IAM

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

  • developerconnect.gitRepositoryLinks.fetchFileBlame

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

BlameRange

BlameRange מייצג מידע על האשמה בטווח של שורות.

ייצוג ב-JSON 
{
  "firstLine": integer,
  "lastLine": integer,
  "commit": {
    object (SCMCommit)
  }
}
שדות
firstLine

integer

מספר השורה הראשונה בטווח (כולל), לפי אינדקס שמתחיל ב-1.
lastLine

integer

מספר השורה שבה מסתיים הטווח (כולל), באינדקס 1.
commit

object (SCMCommit)

המטא-נתונים של ה-commit בטווח השורות הזה.