Console
    Contact Us Start free

    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-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15: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-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15: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.
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: