Skip to main content

Utilizar parámetros de consulta para crear una solicitud de cambios

Utiliza parámetros de consulta para crear URL personalizadas para abrir las solicitudes de cambios con los campos llenados previamente.

Puedes utilizar parámetros de consulta para abrir solicitudes de cambios. Los parámetros de consulta son partes opcionañles de una URL que puedes personalizar para compartir una vista específica de una página web, tal como los resultados con filtro de búsqueda o una plantilla de solicitud de cambios en GitHub. Para crear tus propios parámetros de consulta, debes hacer coincidir el par de clave y valor.

Tip

También puedes crear plantillas de solicitud de cambios que se abran con etiquetas, usuarios asignados y un título predeterminados. Para más información, consulta Utilizar plantillas para promover informes de problemas y solicitudes de extracción útiles.

Debes tener los permisos adecuados para cualquier acción para usar el parámetro de consulta equivalente. Por ejemplo, debes tener permiso para agregar una etiqueta a una solicitud de incorporación de cambios para usar el parámetro de consulta labels. Para más información, consulta Roles de repositorio para una organización.

Si crea una URL no válida con los parámetros de consulta o si no tiene los permisos adecuados, la URL devolverá una página de error 404 Not Found. Si crea una dirección URL que supere el límite del servidor, la dirección URL devolverá una página de error 414 URI Too Long.

Parámetro de consultaEjemplo
quick_pullhttps://github.com/octo-org/octo-repo/compare/main...my-branch?quick_pull=1 crea una solicitud de incorporación de cambios que compara la rama base main y la rama principal my-branch. La consulta quick_pull=1 te lleva directamente a la página "Abrir una solicitud de incorporación de cambios".
titlehttps://github.com/octo-org/octo-repo/compare/main...my-branch?quick_pull=1&labels=bug&title=Bug+fix crea una solicitud de incorporación de cambios con la etiqueta "bug" y el título "Bug fix".
bodyhttps://github.com/octo-org/octo-repo/compare/main...my-branch?quick_pull=1&title=Bug+fix&body=Describe+the+fix. crea una solicitud de incorporación de cambios con el título "Bug fix" y el comentario "Describe the fix" en el cuerpo de la solicitud de incorporación de cambios.
labelshttps://github.com/octo-org/octo-repo/compare/main...my-branch?quick_pull=1&labels=help+wanted,bug crea una solicitud de incorporación de cambios con las etiquetas "help wanted" y "bug".
milestonehttps://github.com/octo-org/octo-repo/compare/main...my-branch?quick_pull=1&milestone=testing+milestones crea una solicitud de incorporación de cambios con el hito "testing milestones".
assigneeshttps://github.com/octo-org/octo-repo/compare/main...my-branch?quick_pull=1&assignees=octocat crea una solicitud de incorporación de cambios y la asigna a @octocat.
projectshttps://github.com/octo-org/octo-repo/compare/main...my-branch?quick_pull=1&title=Bug+fix&projects=octo-org/1 crea una incidencia con el título "Bug fix" y la agrega al proyecto 1 de la organización.
templatehttps://github.com/octo-org/octo-repo/compare/main...my-branch?quick_pull=1&template=issue_template.md crea una solicitud de incorporación de cambios con una plantilla en el cuerpo de la solicitud de incorporación de cambios. El parámetro de consulta template funciona con plantillas almacenadas en un subdirectorio de PULL_REQUEST_TEMPLATE dentro del directorio raíz, docs/ o el directorio .github/ de un repositorio. Para más información, consulta Utilizar plantillas para promover informes de problemas y solicitudes de extracción útiles.