Creates a new catalog item.
Path parameters
Required. Name of the portal. Use the following structure in your request: organizations/{org}/sites/{site}
Request body
Optional. DEPRECATED: use the published field instead
Optional. DEPRECATED: manage documentation through the getDocumentation and updateDocumentation methods
Optional. DEPRECATED: manage documentation through the getDocumentation and updateDocumentation methods
Required. Immutable. The name field of the associated API product. A portal may have only one catalog item associated with a given API product.
Optional. The IDs of the API categories to which this catalog item belongs.
Optional. Description of the catalog item. Max length is 10,000 characters.
Optional. Immutable. DEPRECATED: use the apiProductName field instead
Optional. Boolean flag that manages user access to the catalog item. When true, the catalog item has public visibility and can be viewed anonymously; otherwise, only registered users may view it. Note: when the parent portal is enrolled in the audience management feature, and this flag is set to false, visibility is set to an indeterminate state and must be explicitly specified in the management UI (see Manage the visibility of an API in your portal). Additionally, when enrolled in the audience management feature, updates to this flag will be ignored as visibility permissions must be updated in the management UI.
Optional. Denotes whether the catalog item is published to the portal or is in a draft state. When the parent portal is enrolled in the audience management feature, the visibility can be set to public on creation by setting the anonAllowed flag to true or further managed in the management UI (see Manage the visibility of an API in your portal) before it can be visible to any users. If not enrolled in the audience management feature, the visibility is managed by the anonAllowed flag.
Output only. Time the catalog item was last modified in milliseconds since epoch.
Optional. DEPRECATED: manage documentation through the getDocumentation and updateDocumentation methods
Optional. Whether a callback URL is required when this catalog item's API product is enabled in a developer app. When true, a portal user will be required to input a URL when managing the app (this is typically used for the app's OAuth flow).
Optional. DEPRECATED: DO NOT USE
Optional. Location of the image used for the catalog item in the catalog. This can be either an image with an external URL or a file path for image files stored in the portal, for example, /files/book-tree.jpg. When specifying the URL of an external image, the image won't be uploaded to your assets; additionally, loading the image in the integrated portal will be subject to its availability, which may be blocked or restricted by content security policies. Max length of file path is 2,083 characters.
Output only. The ID of the parent portal.
Output only. The ID of the catalog item.
Required. The user-facing name of the catalog item. title must be a non-empty string with a max length of 255 characters.
Response
Successful response