REST Resource: projects.locations.apis

Resource: Api

An API resource in the API Hub.

JSON representation 
{
 "name": string,
 "displayName": string,
 "description": string,
 "documentation": {
 object (Documentation )
 },
 "owner": {
 object (Owner )
 },
 "versions": [
 string
 ],
 "createTime": string,
 "updateTime": string,
 "targetUser": {
 object (AttributeValues )
 },
 "team": {
 object (AttributeValues )
 },
 "businessUnit": {
 object (AttributeValues )
 },
 "maturityLevel": {
 object (AttributeValues )
 },
 "attributes": {
 string: {
 object (AttributeValues )
 },
 ...
 },
 "apiStyle": {
 object (AttributeValues )
 },
 "selectedVersion": string,
 "apiRequirements": {
 object (AttributeValues )
 },
 "fingerprint": string,
 "sourceMetadata": [
 {
 object (SourceMetadata )
 }
 ],
 "apiFunctionalRequirements": {
 object (AttributeValues )
 },
 "apiTechnicalRequirements": {
 object (AttributeValues )
 }
}
Fields
name

string

Identifier. The name of the API resource in the API Hub.

Format: projects/{project}/locations/{location}/apis/{api}
displayName

string

Required. The display name of the API resource.
description

string

Optional. The description of the API resource.
documentation

object (Documentation )

Optional. The documentation for the API resource.
owner

object (Owner )

Optional. Owner details for the API resource.
versions[]

string

Output only. The list of versions present in an API resource. Note: An API resource can be associated with more than 1 version. Format is projects/{project}/locations/{location}/apis/{api}/versions/{version}
createTime

string (Timestamp format)

Output only. The time at which the API resource was created.

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

string (Timestamp format)

Output only. The time at which the API resource was last updated.

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

object (AttributeValues )

Optional. The target users for the API. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-target-user attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.
team

object (AttributeValues )

Optional. The team owning the API. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-team attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.
businessUnit

object (AttributeValues )

Optional. The business unit owning the API. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-business-unit attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.
maturityLevel

object (AttributeValues )

Optional. The maturity level of the API. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-maturity-level attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.
attributes

map (key: string, value: object (AttributeValues ))

Optional. The list of user defined attributes associated with the API resource. The key is the attribute name. It will be of the format: projects/{project}/locations/{location}/attributes/{attribute}. The value is the attribute values associated with the resource.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
apiStyle

object (AttributeValues )

Optional. The style of the API. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-api-style attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.
selectedVersion

string

Optional. The selected version for an API resource. This can be used when special handling is needed on client side for particular version of the API. Format is projects/{project}/locations/{location}/apis/{api}/versions/{version}
apiRequirements

object (AttributeValues )

Optional. The api requirement doc associated with the API resource. Carinality is 1 for this attribute. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-api-requirements attribute. The value of the attribute should be a proper URI, and in case of Cloud Storage URI, it should point to a Cloud Storage object, not a directory.
fingerprint

string

Optional. Fingerprint of the API resource.
sourceMetadata[]

object (SourceMetadata )

Output only. The list of sources and metadata from the sources of the API resource.
apiFunctionalRequirements

object (AttributeValues )

Optional. The api functional requirements associated with the API resource. Carinality is 1 for this attribute. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-api-functional-requirements attribute. The value of the attribute should be a proper URI, and in case of Cloud Storage URI, it should point to a Cloud Storage object, not a directory.
apiTechnicalRequirements

object (AttributeValues )

Optional. The api technical requirements associated with the API resource. Carinality is 1 for this attribute. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-api-technical-requirements attribute. The value of the attribute should be a proper URI, and in case of Cloud Storage URI, it should point to a Cloud Storage object, not a directory.

Methods

create

Create an API resource in the API hub.

delete

Delete an API resource in the API hub.

get

Get API resource details including the API versions contained in it.

list

List API resources in the API hub.

patch

Update an API resource in the API hub.

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

Last updated 2025年07月28日 UTC.