# Recommendations AI . projects . locations . catalogs

## Instance Methods

Returns the catalogItems Resource.

Returns the eventStores Resource.

Returns the operations Resource.

Lists all the catalog configurations associated with the project.

Retrieves the next page of results.

Updates the catalog configuration.

### Method Details

`list(parent, pageSize=None, pageToken=None, x__xgafv=None)`

    Lists all the catalog configurations associated with the project.

    Args:
      parent: string, Required. The account resource name with an associated location. (required)
      pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults
    to 50. Max allowed value is 1000.
      pageToken: string, Optional. A page token, received from a previous `ListCatalogs`
    call. Provide this to retrieve the subsequent page.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Response for ListCatalogs method.
        "catalogs": [ # Output only. All the customer's catalogs.
          { # The catalog configuration.
              # Next ID: 5.
            "defaultEventStoreId": "A String", # Required. The id of the default event store.
            "displayName": "A String", # Required. The catalog display name.
            "name": "A String", # The fully qualified resource name of the catalog.
            "catalogItemLevelConfig": { # Configures what level the catalog should be uploaded with regards to # Required. The catalog item level configuration.
                # how users will be send events and how predictions will be made.
              "eventItemLevel": "A String", # Optional. What level of the catalog are events uploaded at.
                  # See https://cloud.google.com/recommendations-ai/docs/catalog#catalog-levels
                  # for more details.
              "predictItemLevel": "A String", # Optional. What level of the catalog are predictions made at.
                  # See https://cloud.google.com/recommendations-ai/docs/catalog#catalog-levels
                  # for more details.
            },
          },
        ],
        "nextPageToken": "A String", # Pagination token, if not returned indicates the last page.
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.

`patch(name, body=None, updateMask=None, x__xgafv=None)`

    Updates the catalog configuration.

    Args:
      name: string, The fully qualified resource name of the catalog. (required)
      body: object, The request body.
        The object takes the form of:

    { # The catalog configuration.
        # Next ID: 5.
      "defaultEventStoreId": "A String", # Required. The id of the default event store.
      "displayName": "A String", # Required. The catalog display name.
      "name": "A String", # The fully qualified resource name of the catalog.
      "catalogItemLevelConfig": { # Configures what level the catalog should be uploaded with regards to # Required. The catalog item level configuration.
          # how users will be send events and how predictions will be made.
        "eventItemLevel": "A String", # Optional. What level of the catalog are events uploaded at.
            # See https://cloud.google.com/recommendations-ai/docs/catalog#catalog-levels
            # for more details.
        "predictItemLevel": "A String", # Optional. What level of the catalog are predictions made at.
            # See https://cloud.google.com/recommendations-ai/docs/catalog#catalog-levels
            # for more details.
      },
    }

      updateMask: string, Optional. Indicates which fields in the provided 'recommendation_model' to
    update. If not set, will only update the catalog_item_level_config field.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # The catalog configuration.
          # Next ID: 5.
        "defaultEventStoreId": "A String", # Required. The id of the default event store.
        "displayName": "A String", # Required. The catalog display name.
        "name": "A String", # The fully qualified resource name of the catalog.
        "catalogItemLevelConfig": { # Configures what level the catalog should be uploaded with regards to # Required. The catalog item level configuration.
            # how users will be send events and how predictions will be made.
          "eventItemLevel": "A String", # Optional. What level of the catalog are events uploaded at.
              # See https://cloud.google.com/recommendations-ai/docs/catalog#catalog-levels
              # for more details.
          "predictItemLevel": "A String", # Optional. What level of the catalog are predictions made at.
              # See https://cloud.google.com/recommendations-ai/docs/catalog#catalog-levels
              # for more details.
        },
      }