REST Resource: projects.locations.services

Resource: Service

Represents a user-defined Service.

JSON representation 
{
  "name": string,
  "displayName": string,
  "description": string,
  "interfaces": [
    {
      object (Interface)
    }
  ],
  "registryResource": string,
  "createTime": string,
  "updateTime": string,

  // Union field spec can be only one of the following:
  "agentSpec": {
    object (AgentSpec)
  },
  "mcpServerSpec": {
    object (McpServerSpec)
  },
  "endpointSpec": {
    object (EndpointSpec)
  }
  // End of list of possible types for union field spec.
}
Fields
name

string

Identifier. The resource name of the Service. Format: projects/{project}/locations/{location}/services/{service}.
displayName

string

Optional. User-defined display name for the Service. Can have a maximum length of 63 characters.
description

string

Optional. User-defined description of an Service. Can have a maximum length of 2048 characters.
interfaces[]

object (Interface)

Optional. The connection details for the Service.
registryResource

string

Output only. The resource name of the resulting Agent, MCP Server, or Endpoint. Format:

  • projects/{project}/locations/{location}/mcpServers/{mcpServer}
  • projects/{project}/locations/{location}/agents/{agent}
  • projects/{project}/locations/{location}/endpoints/{endpoint}
createTime

string (Timestamp format)

Output only. Create time.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Output only. Update time.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Union field spec. The spec of the service. At least one of the specs must be set. spec can be only one of the following:
agentSpec

object (AgentSpec)

Optional. The spec of the Agent. When agentSpec is set, the type of the service is Agent.
mcpServerSpec

object (McpServerSpec)

Optional. The spec of the MCP Server. When mcpServerSpec is set, the type of the service is MCP Server.
endpointSpec

object (EndpointSpec)

Optional. The spec of the Endpoint. When endpointSpec is set, the type of the service is Endpoint.

AgentSpec

The spec of the agent.

JSON representation 
{
  "type": enum (Type),
  "content": {
    object
  }
}
Fields
type

enum (Type)

Required. The type of the agent spec content.
content

object (Struct format)

Optional. The content of the Agent spec in the JSON format. This payload is validated against the schema for the specified type. The content size is limited to 10KB.

Type

The type of the agent spec.

Enums
TYPE_UNSPECIFIED Unspecified type.
NO_SPEC There is no spec for the Agent. The content field must be empty.
A2A_AGENT_CARD The content is an A2A Agent Card following the A2A specification. The interfaces field must be empty.

McpServerSpec

The spec of the MCP Server.

JSON representation 
{
  "type": enum (Type),
  "content": {
    object
  }
}
Fields
type

enum (Type)

Required. The type of the MCP Server spec content.
content

object (Struct format)

Optional. The content of the MCP Server spec. This payload is validated against the schema for the specified type. The content size is limited to 10KB.

Type

The type of the MCP Server spec.

Enums
TYPE_UNSPECIFIED Unspecified type.
NO_SPEC There is no spec for the MCP Server. The content field must be empty.
TOOL_SPEC The content is a MCP Tool Spec following the One MCP specification. The payload is the same as the tools/list response.

EndpointSpec

The spec of the endpoint.

JSON representation 
{
  "type": enum (Type),
  "content": {
    object
  }
}
Fields
type

enum (Type)

Required. The type of the endpoint spec content.
content

object (Struct format)

Optional. The content of the endpoint spec. Reserved for future use.

Type

The type of the endpoint spec.

Enums
TYPE_UNSPECIFIED Unspecified type.
NO_SPEC There is no spec for the Endpoint. The content field must be empty.

Methods

create

 Creates a new Service in a given project and location.

delete

 Deletes a single Service.

get

 Gets details of a single Service.

list

 Lists Services in a given project and location.

patch

 Updates the parameters of a single Service.