- Solicitud HTTP
- Parámetros de ruta
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Permisos de IAM
- BlameRange
- Pruébalo
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 |
Obligatorio. Es el nombre del recurso de GitRepositoryLink en el formato |
Parámetros de consulta
| Parámetros | |
|---|---|
ref |
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 |
Obligatorio. Es la ruta de acceso al archivo dentro del repositorio. |
firstLine |
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 |
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 ( |
| Campos | |
|---|---|
ranges[] |
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 ( |
| Campos | |
|---|---|
firstLine |
Es el número de línea inicial con índice 1 del rango (inclusive). |
lastLine |
Es el número de línea final del rango (inclusive) con índice basado en 1. |
commit |
Son los metadatos de confirmación para este rango de líneas. |