Vertex AI Search for Retail API (retail:v2beta)

2022-01-25

12 new methods

Additions

    Methods
  • retail.projects.locations.catalogs.controls.get

      Parameter Order : name

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/controls/{controlsId}

      Parameters :

        name

          Required : Yes

          Type : string

          Description : Required. The resource name of the Control to delete. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}

          Pattern : ^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/controls/[^/]+$

          Location : path

      HTTP Method : GET

      Path : v2beta/{+name}

      Description : Gets a Control.

      Scopes : https://www.googleapis.com/auth/cloud-platform

  • retail.projects.locations.catalogs.controls.create

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/controls

      HTTP Method : POST

      Path : v2beta/{+parent}/controls

      Parameter Order : parent

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Description : Creates a Control. If the Control to create already exists, an ALREADY_EXISTS error is returned.

      Parameters :

        controlId

          Location : query

          Type : string

          Description : Required. The ID to use for the Control, which will become the final component of the Control's resource name. This value should be 4-63 characters, and valid characters are /a-z-_/.

        parent

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$

          Type : string

          Location : path

          Description : Required. Full resource name of parent catalog. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}

  • retail.projects.locations.catalogs.controls.list

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Parameters :

        filter

          Type : string

          Location : query

          Description : Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. * List controls that are used in a single ServingConfig: 'serving_config = "boosted_home_page_cvr"'

        pageSize

          Description : Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.

          Location : query

          Type : integer

          Format : int32

        parent

          Description : Required. The catalog resource name. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}

          Type : string

          Pattern : ^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$

          Location : path

          Required : Yes

        pageToken

          Description : Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.

          Type : string

          Location : query

      Path : v2beta/{+parent}/controls

      Parameter Order : parent

      HTTP Method : GET

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/controls

      Description : Lists all Controls linked to this catalog.

  • retail.projects.locations.catalogs.controls.delete

      Description : Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.

      HTTP Method : DELETE

      Parameters :

        name

          Location : path

          Description : Required. The resource name of the Control to delete. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}

          Pattern : ^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/controls/[^/]+$

          Required : Yes

          Type : string

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/controls/{controlsId}

      Parameter Order : name

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Path : v2beta/{+name}

  • retail.projects.locations.catalogs.controls.patch

      Description : Updates a Control. Control cannot be set to a different oneof field, if so an INVALID_ARGUMENT is returned. If the Control to delete does not exist, a NOT_FOUND error is returned.

      HTTP Method : PATCH

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Parameter Order : name

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/controls/{controlsId}

      Parameters :

        updateMask

          Type : string

          Location : query

          Description : Indicates which fields in the provided Control to update. The following are NOT supported: * Control.name If not set or empty, all supported fields are updated.

          Format : google-fieldmask

        name

          Required : Yes

          Description : Immutable. Fully qualified name projects/*/locations/global/catalogs/*/controls/*

          Type : string

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/controls/[^/]+$

      Path : v2beta/{+name}

  • retail.projects.locations.catalogs.servingConfigs.patch

      Parameters :

        name

          Location : path

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$

          Description : Immutable. Fully qualified name projects/*/locations/global/catalogs/*/servingConfig/*

          Type : string

        updateMask

          Location : query

          Format : google-fieldmask

          Description : Indicates which fields in the provided ServingConfig to update. The following are NOT supported: * ServingConfig.name If not set, all supported fields are updated.

          Type : string

      Description : Updates a ServingConfig.

      Path : v2beta/{+name}

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs/{servingConfigsId}

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : PATCH

      Parameter Order : name

  • retail.projects.locations.catalogs.servingConfigs.addControl

      Parameters :

        servingConfig

          Required : Yes

          Description : Required. The source ServingConfig resource name . Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}

          Pattern : ^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$

          Location : path

          Type : string

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs/{servingConfigsId}:addControl

      Path : v2beta/{+servingConfig}:addControl

      Parameter Order : servingConfig

      HTTP Method : POST

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Description : Enables a Control on the specified ServingConfig. The control is added in the last position of the list of controls it belongs to (e.g. if it's a facet spec control it will be applied in the last position of servingConfig.facetSpecIds) Returns a ALREADY_EXISTS error if the control has already been applied. Returns a FAILED_PRECONDITION error if the addition could exceed maximum number of control allowed for that type of control.

  • retail.projects.locations.catalogs.servingConfigs.get

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs/{servingConfigsId}

      Description : Gets a ServingConfig. Returns a NotFound error if the ServingConfig does not exist.

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Path : v2beta/{+name}

      HTTP Method : GET

      Parameters :

        name

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$

          Type : string

          Location : path

          Description : Required. The resource name of the ServingConfig to get. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}

      Parameter Order : name

  • retail.projects.locations.catalogs.servingConfigs.removeControl

      Path : v2beta/{+servingConfig}:removeControl

      Parameters :

        servingConfig

          Pattern : ^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$

          Type : string

          Location : path

          Description : Required. The source ServingConfig resource name . Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}

          Required : Yes

      Parameter Order : servingConfig

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs/{servingConfigsId}:removeControl

      Description : Disables a Control on the specified ServingConfig. The control is removed from the ServingConfig. Returns a NOT_FOUND error if the Control is not enabled for the ServingConfig.

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : POST

  • retail.projects.locations.catalogs.servingConfigs.list

      Parameter Order : parent

      Description : Lists all ServingConfigs linked to this catalog.

      Parameters :

        pageSize

          Format : int32

          Type : integer

          Location : query

          Description : Optional. Maximum number of results to return. If unspecified, defaults to 100. If a value greater than 100 is provided, at most 100 results are returned.

        parent

          Required : Yes

          Description : Required. The catalog resource name. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}

          Location : path

          Type : string

          Pattern : ^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$

        pageToken

          Description : Optional. A page token, received from a previous `ListServingConfigs` call. Provide this to retrieve the subsequent page.

          Location : query

          Type : string

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs

      Path : v2beta/{+parent}/servingConfigs

      HTTP Method : GET

  • retail.projects.locations.catalogs.servingConfigs.delete

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs/{servingConfigsId}

      Parameters :

        name

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$

          Type : string

          Required : Yes

          Description : Required. The resource name of the ServingConfig to delete. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}

      Parameter Order : name

      Path : v2beta/{+name}

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : DELETE

      Description : Deletes a ServingConfig. Returns a NotFound error if the ServingConfig does not exist.

  • retail.projects.locations.catalogs.servingConfigs.create

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Parameters :

        servingConfigId

          Location : query

          Type : string

          Description : 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-_/.

        parent

          Pattern : ^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$

          Location : path

          Required : Yes

          Description : Required. Full resource name of parent. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}

          Type : string

      Parameter Order : parent

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs

      HTTP Method : POST

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

      Path : v2beta/{+parent}/servingConfigs