架构预览

您可以在即将推出的功能和 GitHub GraphQL 架构变更添加至 GitHub GraphQL API 之前预览它们。

本文内容

关于架构预览

在预览期间，我们可以根据开发者的反馈更改某些功能。 如果我们确实进行了更改，我们将在开发者博客上公布这些更改，而不会事先通知。

若要访问架构预览，需要在请求的 Accept 标头中提供自定义媒体类型。 每个预览的功能文档可指定要提供的自定义媒体类型。

Note

目前无法通过 Explorer 访问处于预览状态的 GraphQL 架构成员。

Access to package version deletion preview

This preview adds support for the DeletePackageVersion mutation which enables deletion of private package versions.

若要切换此预览并访问以下架构成员，必须在 `Accept` 标头中提供自定义媒体类型：

application/vnd.github.package-deletes-preview+json

预览的架构成员:

  • Mutation.deletePackageVersion

Deployments preview

This preview adds support for deployments mutations and new deployments features.

若要切换此预览并访问以下架构成员，必须在 `Accept` 标头中提供自定义媒体类型：

application/vnd.github.flash-preview+json

预览的架构成员:

  • DeploymentStatus.environment
  • Mutation.createDeploymentStatus
  • Mutation.createDeployment

Merge info preview more detailed information about a pull request's merge state preview

This preview adds support for accessing fields that provide more detailed information about a pull request's merge state.

若要切换此预览并访问以下架构成员，必须在 `Accept` 标头中提供自定义媒体类型：

application/vnd.github.merge-info-preview+json

预览的架构成员:

  • PullRequest.canBeRebased
  • PullRequest.mergeStateStatus

Update refs preview update multiple refs in a single operation preview

This preview adds support for updating multiple refs in a single operation.

若要切换此预览并访问以下架构成员，必须在 `Accept` 标头中提供自定义媒体类型：

application/vnd.github.update-refs-preview+json

预览的架构成员:

  • Mutation.updateRefs
  • GitRefname
  • RefUpdate

Access to a repository's dependency graph preview

This preview adds support for reading a dependency graph for a repository.

若要切换此预览并访问以下架构成员，必须在 `Accept` 标头中提供自定义媒体类型：

application/vnd.github.hawkgirl-preview+json

预览的架构成员:

  • DependencyGraphManifest
  • Repository.dependencyGraphManifests
  • DependencyGraphManifestEdge
  • DependencyGraphManifestConnection
  • DependencyGraphDependency
  • DependencyGraphDependencyEdge
  • DependencyGraphDependencyConnection

Project event details preview

This preview adds project, project card, and project column details to project-related issue events.

若要切换此预览并访问以下架构成员，必须在 `Accept` 标头中提供自定义媒体类型：

application/vnd.github.starfox-preview+json

预览的架构成员:

  • AddedToProjectEvent.project
  • AddedToProjectEvent.projectCard
  • AddedToProjectEvent.projectColumnName
  • ConvertedNoteToIssueEvent.project
  • ConvertedNoteToIssueEvent.projectCard
  • ConvertedNoteToIssueEvent.projectColumnName
  • MovedColumnsInProjectEvent.project
  • MovedColumnsInProjectEvent.projectCard
  • MovedColumnsInProjectEvent.projectColumnName
  • MovedColumnsInProjectEvent.previousProjectColumnName
  • RemovedFromProjectEvent.project
  • RemovedFromProjectEvent.projectColumnName

Labels preview

This preview adds support for adding, updating, creating and deleting labels.

若要切换此预览并访问以下架构成员，必须在 `Accept` 标头中提供自定义媒体类型：

application/vnd.github.bane-preview+json

预览的架构成员:

  • Mutation.createLabel
  • Mutation.deleteLabel
  • Mutation.updateLabel

Import project preview

This preview adds support for importing projects.

若要切换此预览并访问以下架构成员，必须在 `Accept` 标头中提供自定义媒体类型：

application/vnd.github.slothette-preview+json

预览的架构成员:

  • Mutation.importProject

Team review assignments preview

This preview adds support for updating the settings for team review assignment.

若要切换此预览并访问以下架构成员，必须在 `Accept` 标头中提供自定义媒体类型：

application/vnd.github.stone-crop-preview+json

预览的架构成员:

  • Mutation.updateTeamReviewAssignment
  • TeamReviewAssignmentAlgorithm
  • Team.reviewRequestDelegationEnabled
  • Team.reviewRequestDelegationAlgorithm
  • Team.reviewRequestDelegationMemberCount
  • Team.reviewRequestDelegationNotifyTeam