Vertex AI Search for Retail API (retail:v2)

2023-01-24

7 new methods

Additions

    Methods
  • retail.projects.locations.catalogs.models.pause

      Parameter Order : name

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/models/{modelsId}:pause

      Parameters :

        name

          Description : Required. The name of the model to pause. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`

          Location : path

          Required : Yes

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

          Type : string

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

      Description : Pauses the training of an existing model.

      HTTP Method : POST

      Path : v2/{+name}:pause

  • retail.projects.locations.catalogs.models.delete

      HTTP Method : DELETE

      Description : Deletes an existing model.

      Parameters :

        name

          Required : Yes

          Location : path

          Type : string

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

          Description : Required. The resource name of the Model to delete. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/models/{modelsId}

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

      Parameter Order : name

      Path : v2/{+name}

  • retail.projects.locations.catalogs.models.list

      Path : v2/{+parent}/models

      Parameter Order : parent

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

      HTTP Method : GET

      Description : Lists all the models linked to this event store.

      Parameters :

        pageToken

          Location : query

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

          Type : string

        parent

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

          Type : string

          Required : Yes

          Location : path

          Description : Required. The parent for which to list models. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`

        pageSize

          Location : query

          Format : int32

          Type : integer

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

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/models

  • retail.projects.locations.catalogs.models.resume

      Parameters :

        name

          Location : path

          Required : Yes

          Description : Required. The name of the model to resume. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`

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

          Type : string

      Description : Resumes the training of an existing model.

      Parameter Order : name

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

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/models/{modelsId}:resume

      HTTP Method : POST

      Path : v2/{+name}:resume

  • retail.projects.locations.catalogs.models.tune

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

      Parameters :

        name

          Location : path

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

          Required : Yes

          Type : string

          Description : Required. The resource name of the model to tune. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`

      HTTP Method : POST

      Description : Tunes an existing model.

      Parameter Order : name

      Path : v2/{+name}:tune

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/models/{modelsId}:tune

  • retail.projects.locations.catalogs.models.patch

      Parameters :

        name

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

          Required : Yes

          Type : string

          Location : path

          Description : Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` catalog_id has char limit of 50. recommendation_model_id has char limit of 40.

        updateMask

          Format : google-fieldmask

          Description : Optional. Indicates which fields in the provided 'model' to update. If not set, by default updates all fields.

          Type : string

          Location : query

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/models/{modelsId}

      Parameter Order : name

      HTTP Method : PATCH

      Path : v2/{+name}

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

      Description : Update of model metadata. Only fields that currently can be updated are: `filtering_option` and `periodic_tuning_state`. If other values are provided, this API method ignores them.

  • retail.projects.locations.catalogs.models.create

      Description : Creates a new model.

      Parameter Order : parent

      Path : v2/{+parent}/models

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/models

      HTTP Method : POST

      Parameters :

        dryRun

          Location : query

          Type : boolean

          Description : Optional. Whether to run a dry run to validate the request (without actually creating the model).

        parent

          Description : Required. The parent resource under which to create the model. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`

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

          Location : path

          Type : string

          Required : Yes

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