Api is a light-weight descriptor for an API Interface.

Interfaces are also described as "protocol buffer services" in some contexts, such as by the "service" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as "APIs" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology.

Generated

from message google.protobuf.Api

Hierarchy

Constructors

  • Parameters

    Returns Api

Properties

methods: Method[]

The methods of this interface, in unspecified order.

Generated

from field: repeated google.protobuf.Method methods = 2;

mixins: Mixin[]

Included interfaces. See [Mixin][].

Generated

from field: repeated google.protobuf.Mixin mixins = 6;

name: string

The fully qualified name of this interface, including package name followed by the interface's simple name.

Generated

from field: string name = 1;

options: Option[]

Any metadata attached to the interface.

Generated

from field: repeated google.protobuf.Option options = 3;

sourceContext?: SourceContext

Source context for the protocol buffer service represented by this message.

Generated

from field: google.protobuf.SourceContext source_context = 5;

syntax: Syntax

The source syntax of the service.

Generated

from field: google.protobuf.Syntax syntax = 7;

version: string

A version string for this interface. If specified, must have the form major-version.minor-version, as in 1.10. If the minor version is omitted, it defaults to zero. If the entire version field is empty, the major version is derived from the package name, as outlined below. If the field is not empty, the version in the package name will be verified to be consistent with what is provided here.

The versioning schema uses semantic versioning where the major version number indicates a breaking change and the minor version an additive, non-breaking change. Both version numbers are signals to users what to expect from different versions, and should be carefully chosen based on the product plan.

The major version is also reflected in the package name of the interface, which must end in v<major-version>, as in google.feature.v1. For major versions 0 and 1, the suffix can be omitted. Zero major versions must only be used for experimental, non-GA interfaces.

Generated

from field: string version = 4;

fields: FieldList
runtime: ProtoRuntime
typeName: "google.protobuf.Api" = "google.protobuf.Api"

Methods

  • Create a deep copy.

    Returns Api

  • Compare with a message of the same type.

    Parameters

    Returns boolean

  • Parse from binary data, merging fields.

    Repeated fields are appended. Map entries are added, overwriting existing keys.

    If a message field is already present, it will be merged with the new data.

    Parameters

    Returns Api

  • Parse a message from a JSON value.

    Parameters

    Returns Api

  • Parse a message from a JSON string.

    Parameters

    Returns Api

  • Retrieve the MessageType of this message - a singleton that represents the protobuf message declaration and provides metadata for reflection- based operations.

    Returns MessageType<Api>

  • Serialize the message to binary data.

    Parameters

    Returns Uint8Array

  • Override for serialization behavior. This will be invoked when calling JSON.stringify on this message (i.e. JSON.stringify(msg)).

    Note that this will not serialize google.protobuf.Any with a packed message because the protobuf JSON format specifies that it needs to be unpacked, and this is only possible with a type registry to look up the message type. As a result, attempting to serialize a message with this type will throw an Error.

    This method is protected because you should not need to invoke it directly -- instead use JSON.stringify or toJsonString for stringified JSON. Alternatively, if actual JSON is desired, you should use toJson.

    Returns JsonValue

  • Serialize the message to a JSON value, a JavaScript value that can be passed to JSON.stringify().

    Parameters

    Returns JsonValue

  • Serialize the message to a JSON string.

    Parameters

    Returns string

  • Parameters

    Returns boolean

  • Parameters

    Returns Api

  • Parameters

    Returns Api

  • Parameters

    Returns Api

Generated using TypeDoc