ApiDocDocumentation

The documentation for a catalog item.

JSON representation
{// Union fielddocumentation can be only one of the following:"oasDocumentation":{object (OASDocumentation)},"graphqlDocumentation":{object (GraphqlDocumentation)}// End of list of possible types for union fielddocumentation.}
Fields
Union fielddocumentation. The API reference documentation for this catalog item, if any.documentation can be only one of the following:
oasDocumentation

object (OASDocumentation)

Optional. OpenAPI Specification documentation.

graphqlDocumentation

object (GraphqlDocumentation)

Optional. GraphQL documentation.

OASDocumentation

OpenAPI Specification documentation for a catalog item.

JSON representation
{"spec":{object (DocumentationFile)},"format":enum (Format)}
Fields
spec

object (DocumentationFile)

Required. The documentation file contents for the OpenAPI Specification. JSON and YAML file formats are supported.

format

enum (Format)

Output only. The format of the input specification file contents.

DocumentationFile

Documentation file contents for a catalog item.

JSON representation
{"displayName":string,"contents":string}
Fields
displayName

string

Required. A display name for the file, shown in the management UI. Max length is 255 characters.

contents

string (bytes format)

Required. The file contents. The max size is 4 MB.

A base64-encoded string.

Format

A format specification for documentation file contents.

Enums
FORMAT_UNSPECIFIEDThe format is not available.
YAMLYAML format.
JSONJSON format.

GraphqlDocumentation

GraphQL documentation for a catalog item.

JSON representation
{"schema":{object (DocumentationFile)},"endpointUri":string}
Fields
schema

object (DocumentationFile)

Required. The documentation file contents for the GraphQL schema.

endpointUri

string

Required. The GraphQL endpoint URI to be queried by API consumers. Max length is 2,083 characters.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-17 UTC.