我们经常发布文档更新，此页面的翻译可能仍在进行中。有关最新信息，请访问英语文档。

重大更改

本文内容

了解最近和即将发生的 GitHub GraphQL API 重大变更。

关于重大变更

重大变更是指可能需要集成商采取行动的任何变更。我们将这些变更分为两类：

中断性变更：会改变对 GraphQL API 的现有查询的变更。例如，删除字段就是重大变更。
危险变更：不会改变现有查询，但会影响客户端运行时的行为的变更。添加枚举值就是一个危险变更示例。

我们努力为集成商提供稳定的 API。当某项新功能还处于完善阶段时，我们将在架构预览模式下发布此功能。

我们将在更改 GraphQL 架构前至少三个月宣布即将发生的重大变更，以便给集成商预留进行必要调整的时间。变更在季度第一天（1 月 1 日、4 月 1 日、7 月 1 日或 10 月 1 日）生效。例如，如果我们在 1 月 15 日宣布变更，将在 7 月 1 日执行。

Changes scheduled for 2022-10-01

Breaking A change will be made to UnlockAndResetMergeGroupInput.branch.
Description:
branch will be removed.
Reason:
The current merge group for the repository's default branch, the branch argument is now a no-op

Breaking A change will be made to RepositoryVulnerabilityAlert.fixReason.
Description:
fixReason will be removed.
Reason:
The fixReason field is being removed. You can still use fixedAt and dismissReason.

Breaking A change will be made to RemovePullRequestFromMergeQueueInput.branch.
Description:
branch will be removed.
Reason:
PRs are removed from the merge queue for the base branch, the branch argument is now a no-op

Breaking A change will be made to ProjectNextFieldType.TRACKS.
Description:
TRACKS will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to ProjectNextFieldType.TITLE.
Description:
TITLE will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to ProjectNextFieldType.TEXT.
Description:
TEXT will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to ProjectNextFieldType.SINGLE_SELECT.
Description:
SINGLE_SELECT will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to ProjectNextFieldType.REVIEWERS.
Description:
REVIEWERS will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to ProjectNextFieldType.REPOSITORY.
Description:
REPOSITORY will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to ProjectNextFieldType.NUMBER.
Description:
NUMBER will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to ProjectNextFieldType.MILESTONE.
Description:
MILESTONE will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to ProjectNextFieldType.LINKED_PULL_REQUESTS.
Description:
LINKED_PULL_REQUESTS will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to ProjectNextFieldType.LABELS.
Description:
LABELS will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to ProjectNextFieldType.ITERATION.
Description:
ITERATION will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to ProjectNextFieldType.DATE.
Description:
DATE will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to ProjectNextFieldType.ASSIGNEES.
Description:
ASSIGNEES will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.
Reason:
The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

Breaking A change will be made to MergeLockedMergeGroupInput.branch.
Description:
branch will be removed.
Reason:
Changes are merged into the repository's default branch, the branch argument is now a no-op

Breaking A change will be made to LockMergeQueueInput.branch.
Description:
branch will be removed.
Reason:
The merge queue is locked for the repository's default branch, the branch argument is now a no-op

Changes scheduled for 2022-07-01

Breaking A change will be made to AddPullRequestToMergeQueueInput.branch.
Description:
branch will be removed.
Reason:
PRs are added to the merge queue for the base branch, the branch argument is now a no-op

Changes scheduled for 2022-04-01

Breaking A change will be made to Repository.defaultMergeQueue.
Description:
defaultMergeQueue will be removed. Use Repository.mergeQueue instead.
Reason:
defaultMergeQueue will be removed.

Changes scheduled for 2021-10-01

Breaking A change will be made to ReactionGroup.users.
Description:
users will be removed. Use the reactors field instead.
Reason:
Reactors can now be mannequins, bots, and organizations.

Changes scheduled for 2021-06-21

Breaking A change will be made to PackageType.DOCKER.
Description:
DOCKER will be removed.
Reason:
DOCKER will be removed from this enum as this type will be migrated to only be used by the Packages REST API.

Changes scheduled for 2021-01-01

Breaking A change will be made to MergeStateStatus.DRAFT.
Description:
DRAFT will be removed. Use PullRequest.isDraft instead.
Reason:
DRAFT state will be removed from this enum and isDraft should be used instead

Changes scheduled for 2020-10-01

Breaking A change will be made to PullRequest.timeline.
Description:
timeline will be removed. Use PullRequest.timelineItems instead.
Reason:
timeline will be removed

Breaking A change will be made to Issue.timeline.
Description:
timeline will be removed. Use Issue.timelineItems instead.
Reason:
timeline will be removed

Changes scheduled for 2020-01-01

Breaking A change will be made to UnassignedEvent.user.
Description:
user will be removed. Use the assignee field instead.
Reason:
Assignees can now be mannequins.

Breaking A change will be made to AssignedEvent.user.
Description:
user will be removed. Use the assignee field instead.
Reason:
Assignees can now be mannequins.

Changes scheduled for 2019-04-01

Breaking A change will be made to LegacyMigration.uploadUrlTemplate.
Description:
uploadUrlTemplate will be removed. Use uploadUrl instead.
Reason:
uploadUrlTemplate is being removed because it is not a standard URL and adds an extra user step.