serviceconfig

type API struct {

	// Path is the proto directory path in github.com/googleapis/googleapis.
	// If ServiceConfig is empty, the service config is assumed to live at this
	// path.
	Path string `yaml:"path,omitempty"`

	// Description provides the information for describing an API.
	Description string `yaml:"description,omitempty"`

	// Discovery is the file path to a discovery document in
	// github.com/googleapis/discovery-artifact-manager.
	// Used by sidekick languages (Rust, Dart) as an alternative to proto files.
	Discovery string `yaml:"discovery,omitempty"`

	// DocumentationURI overrides the product documentation URI from the service
	// config's publishing section.
	DocumentationURI string `yaml:"documentation_uri,omitempty"`

	// Languages restricts which languages can generate client libraries for this API.
	// Use "all" to indicate all languages can use this API.
	//
	// Restrictions exist for several reasons:
	//   - Newer languages (Rust, Dart) skip older beta versions when stable versions exist
	//   - Python has historical legacy APIs not available to other languages
	//   - Some APIs (like DIREGAPIC protos) are only used by specific languages
	Languages []string `yaml:"languages,omitempty"`

	// NewIssueURI overrides the new issue URI from the service config's
	// publishing section.
	NewIssueURI string `yaml:"new_issue_uri,omitempty"`

	// SkipRESTNumericEnums lists languages that should not pass the
	// rest-numeric-enums flag to the generator. The special value "all"
	// skips it for every language. If empty, all languages use numeric enums.
	SkipRESTNumericEnums []string `yaml:"skip_rest_numeric_enums,omitempty"`

	// OpenAPI is the file path to an OpenAPI spec, currently in internal/testdata.
	// This is not an official spec yet and exists only for Rust to validate OpenAPI support.
	OpenAPI string `yaml:"open_api,omitempty"`

	// ReleaseLevels is the release level per language.
	// Map key is the language name (e.g., "python", "rust").
	// Optional. If omitted, the generator default is used.
	//
	// TODO(https://github.com/googleapis/librarian/issues/4834): Go uses
	// "alpha", "beta", and "ga" instead of "preview" and "stable". We should
	// standardize release level vocabulary across languages.
	ReleaseLevels map[string]string `yaml:"release_level,omitempty"`

	// ShortName overrides the API short name from the service config's
	// publishing section.
	ShortName string `yaml:"short_name,omitempty"`

	// ServiceConfig is the service config file path override.
	// If empty, the service config is discovered in the directory specified by Path.
	ServiceConfig string `yaml:"service_config,omitempty"`

	// ServiceName is a DNS-like logical identifier for the service, such as `calendar.googleapis.com`.
	ServiceName string `yaml:"service_name,omitempty"`

	// Title overrides the API title from the service config.
	Title string `yaml:"title,omitempty"`

	// Transports defines the supported transports per language.
	// Map key is the language name (e.g., "python", "rust").
	// Optional. If omitted, all languages use GRPCRest by default.
	Transports map[string]Transport `yaml:"transports,omitempty"`
}

type Authentication = serviceconfig.Authentication

type AuthenticationRule = serviceconfig.AuthenticationRule

type Backend = serviceconfig.Backend

type BackendRule = serviceconfig.BackendRule

type Documentation = serviceconfig.Documentation

type DocumentationRule = serviceconfig.DocumentationRule

type OAuthRequirements = serviceconfig.OAuthRequirements

type Service = serviceconfig.Service

type Transport string