Skip to main content

apidocs_documentation

Creates, updates, deletes, gets or lists an apidocs_documentation resource.

Overview​

Nameapidocs_documentation
TypeResource
Idgoogle.apigee.apidocs_documentation

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
dataobjectOutput only. The documentation resource. (id: GoogleCloudApigeeV1ApiDocDocumentation)
errorCodestringOutput only. Unique error code for the request, if any.
messagestringOutput only. Description of the operation.
requestIdstringOutput only. Unique ID of the request.
statusstringOutput only. Status of the operation.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
organizations_sites_apidocs_get_documentationselectorganizationsId, sitesId, apidocsIdGets the documentation for the specified catalog item.
organizations_sites_apidocs_update_documentationupdateorganizationsId, sitesId, apidocsIdUpdates the documentation for the specified catalog item. Note that the documentation file contents will not be populated in the return message.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
apidocsIdstring
organizationsIdstring
sitesIdstring

SELECT examples​

Gets the documentation for the specified catalog item.

SELECT
data,
errorCode,
message,
requestId,
status
FROM google.apigee.apidocs_documentation
WHERE organizationsId = '{{ organizationsId }}' -- required
AND sitesId = '{{ sitesId }}' -- required
AND apidocsId = '{{ apidocsId }}' -- required
;

UPDATE examples​

Updates the documentation for the specified catalog item. Note that the documentation file contents will not be populated in the return message.

UPDATE google.apigee.apidocs_documentation
SET
data__asyncApiDocumentation = '{{ asyncApiDocumentation }}',
data__graphqlDocumentation = '{{ graphqlDocumentation }}',
data__oasDocumentation = '{{ oasDocumentation }}'
WHERE
organizationsId = '{{ organizationsId }}' --required
AND sitesId = '{{ sitesId }}' --required
AND apidocsId = '{{ apidocsId }}' --required
RETURNING
data,
errorCode,
message,
requestId,
status;