Method: projects.locations.catalogs.servingConfigs.create

Stay organized with collections Save and categorize content based on your preferences.

Creates a ServingConfig.

A maximum of 100 ServingConfigs are allowed in a Catalog, otherwise a FAILED_PRECONDITION error is returned.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. Full resource name of parent. Format: projects/{projectNumber}/locations/{locationId}/catalogs/{catalogId}

Query parameters



Required. The ID to use for the ServingConfig, which will become the final component of the ServingConfig's resource name.

This value should be 4-63 characters, and valid characters are /[a-z][0-9]-_/.

Request body

The request body contains an instance of ServingConfig.

Response body

If successful, the response body contains a newly created instance of ServingConfig.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • retail.servingConfigs.create

For more information, see the IAM documentation.