Skip to main content

apidocs

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

Overview​

Nameapidocs
TypeResource
Idgoogle.apigee.apidocs

Fields​

The following fields are returned by SELECT queries:

Successful response

NameDatatypeDescription
dataobjectThe catalog item resource. (id: GoogleCloudApigeeV1ApiDoc)
errorCodestringUnique error code for the request, if any.
messagestringDescription of the operation.
requestIdstringUnique ID of the request.
statusstringStatus of the operation.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
organizations_sites_apidocs_getselectorganizationsId, sitesId, apidocsIdGets a catalog item.
organizations_sites_apidocs_listselectorganizationsId, sitesIdpageSize, pageTokenReturns the catalog items associated with a portal.
organizations_sites_apidocs_createinsertorganizationsId, sitesIdCreates a new catalog item.
organizations_sites_apidocs_updatereplaceorganizationsId, sitesId, apidocsIdUpdates a catalog item.
organizations_sites_apidocs_deletedeleteorganizationsId, sitesId, apidocsIdDeletes a catalog item.

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
pageSizeinteger (int32)
pageTokenstring

SELECT examples​

Gets a catalog item.

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

INSERT examples​

Creates a new catalog item.

INSERT INTO google.apigee.apidocs (
data__title,
data__description,
data__published,
data__anonAllowed,
data__apiProductName,
data__requireCallbackUrl,
data__imageUrl,
data__categoryIds,
data__visibility,
data__edgeAPIProductName,
data__specId,
data__graphqlSchema,
data__graphqlEndpointUrl,
data__graphqlSchemaDisplayName,
organizationsId,
sitesId
)
SELECT 
'{{ title }}',
'{{ description }}',
{{ published }},
{{ anonAllowed }},
'{{ apiProductName }}',
{{ requireCallbackUrl }},
'{{ imageUrl }}',
'{{ categoryIds }}',
{{ visibility }},
'{{ edgeAPIProductName }}',
'{{ specId }}',
'{{ graphqlSchema }}',
'{{ graphqlEndpointUrl }}',
'{{ graphqlSchemaDisplayName }}',
'{{ organizationsId }}',
'{{ sitesId }}'
RETURNING
data,
errorCode,
message,
requestId,
status
;

REPLACE examples​

Updates a catalog item.

REPLACE google.apigee.apidocs
SET 
data__title = '{{ title }}',
data__description = '{{ description }}',
data__published = {{ published }},
data__anonAllowed = {{ anonAllowed }},
data__apiProductName = '{{ apiProductName }}',
data__requireCallbackUrl = {{ requireCallbackUrl }},
data__imageUrl = '{{ imageUrl }}',
data__categoryIds = '{{ categoryIds }}',
data__visibility = {{ visibility }},
data__edgeAPIProductName = '{{ edgeAPIProductName }}',
data__specId = '{{ specId }}',
data__graphqlSchema = '{{ graphqlSchema }}',
data__graphqlEndpointUrl = '{{ graphqlEndpointUrl }}',
data__graphqlSchemaDisplayName = '{{ graphqlSchemaDisplayName }}'
WHERE 
organizationsId = '{{ organizationsId }}' --required
AND sitesId = '{{ sitesId }}' --required
AND apidocsId = '{{ apidocsId }}' --required
RETURNING
data,
errorCode,
message,
requestId,
status;

DELETE examples​

Deletes a catalog item.

DELETE FROM google.apigee.apidocs
WHERE organizationsId = '{{ organizationsId }}' --required
AND sitesId = '{{ sitesId }}' --required
AND apidocsId = '{{ apidocsId }}' --required;