Method: projects.locations.connections.gitRepositoryLinks.fetchFileBlame

Récupère les informations de blame pour un fichier ou une plage de lignes dans un fichier.

Requête HTTP

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

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

Paramètres de requête

Paramètres
ref

string

Obligatoire. SHA du commit SCM ou révision symbolique (par exemple, nom de la branche, tag) à partir duquel récupérer le blame.
path

string

Obligatoire. Chemin d'accès au fichier dans le dépôt.
firstLine

integer

Facultatif. Numéro de ligne de début (indexé sur 1) de la plage à blâmer (inclus). Si aucune valeur n'est spécifiée, l'annotation commence à la ligne 1.
lastLine

integer

Facultatif. Numéro de ligne de fin (indexé à partir de 1) de la plage à blâmer (inclus). Si ce paramètre n'est pas spécifié, l'annotation s'étend jusqu'à la fin du fichier.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour gitRepositoryLinks.fetchFileBlame.

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

Représentation JSON 
{
  "ranges": [
    {
      object (BlameRange)
    }
  ]
}
Champs
ranges[]

object (BlameRange)

Liste des plages de blâme pour le fichier.

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

Pour en savoir plus, consultez la documentation IAM.

BlameRange

BlameRange représente les informations de responsabilité pour une plage de lignes.

Représentation JSON 
{
  "firstLine": integer,
  "lastLine": integer,
  "commit": {
    object (SCMCommit)
  }
}
Champs
firstLine

integer

Numéro de ligne de début de la plage (indexé sur 1, inclus).
lastLine

integer

Numéro de ligne de fin de la plage (indexé sur 1, inclusif).
commit

object (SCMCommit)

Métadonnées de commit pour cette plage de lignes.