Method: projects.locations.connections.gitRepositoryLinks.fetchFileBlame

Recupera información de blame para un archivo o un rango de líneas en un archivo.

Solicitud HTTP

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

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/*.

Parámetros de consulta

Parámetros
ref

string

Obligatorio. El SHA de confirmación de SCM o la revisión simbólica (por ejemplo, el nombre de la rama o la etiqueta) desde la que se recuperará la culpa.

path

string

Obligatorio. Es la ruta de acceso al archivo dentro del repositorio.

firstLine

integer

Es opcional. Es el número de línea inicial con índice 1 del rango que se debe culpar (inclusive). Si no se especifica, la atribución comienza en la línea 1.

lastLine

integer

Es opcional. Es el número de línea final con índice 1 del rango que se debe culpar (inclusive). Si no se especifica, la atribución se extiende hasta el final del archivo.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para gitRepositoryLinks.fetchFileBlame.

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

Representación JSON
{
  "ranges": [
    {
      object (BlameRange)
    }
  ]
}
Campos
ranges[]

object (BlameRange)

Es la lista de rangos de culpa del archivo.

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.fetchFileBlame

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

BlameRange

BlameRange representa la información de blame para un rango de líneas.

Representación JSON
{
  "firstLine": integer,
  "lastLine": integer,
  "commit": {
    object (SCMCommit)
  }
}
Campos
firstLine

integer

Es el número de línea inicial con índice 1 del rango (inclusive).

lastLine

integer

Es el número de línea final del rango (inclusive) con índice basado en 1.

commit

object (SCMCommit)

Son los metadatos de confirmación para este rango de líneas.