# Recommender API . projects . locations . insightTypes

## Instance Methods

Returns the insights Resource.

Close httplib2 connections.

Gets the requested InsightTypeConfig. There is only one instance of the config for each InsightType.

Updates an InsightTypeConfig change. This will create a new revision of the config.

### Method Details

`close()`

    Close httplib2 connections.

`getConfig(name, x__xgafv=None)`

    Gets the requested InsightTypeConfig. There is only one instance of the config for each InsightType.

    Args:
      name: string, Required. Name of the InsightTypeConfig to get. Acceptable formats: * `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config` * `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config` * `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config` (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Configuration for an InsightType.
      "annotations": { # Allows clients to store small amounts of arbitrary data. Annotations must follow the Kubernetes syntax. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.
        "a_key": "A String",
      },
      "displayName": "A String", # A user-settable field to provide a human-readable name to be used in user interfaces.
      "etag": "A String", # Fingerprint of the InsightTypeConfig. Provides optimistic locking when updating.
      "insightTypeGenerationConfig": { # A configuration to customize the generation of insights. Eg, customizing the lookback period considered when generating a insight. # InsightTypeGenerationConfig which configures the generation of insights for this insight type.
        "params": { # Parameters for this InsightTypeGenerationConfig. These configs can be used by or are applied to all subtypes.
          "a_key": "", # Properties of the object.
        },
      },
      "name": "A String", # Name of insight type config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config
      "revisionId": "A String", # Output only. Immutable. The revision ID of the config. A new revision is committed whenever the config is changed in any way. The format is an 8-character hexadecimal string.
      "updateTime": "A String", # Last time when the config was updated.
    }

`updateConfig(name, body, updateMask=None, validateOnly=None, x__xgafv=None)`

    Updates an InsightTypeConfig change. This will create a new revision of the config.

    Args:
      name: string, Name of insight type config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config (required)
      body: object, The request body.
        The object takes the form of:

    { # Configuration for an InsightType.
      "annotations": { # Allows clients to store small amounts of arbitrary data. Annotations must follow the Kubernetes syntax. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.
        "a_key": "A String",
      },
      "displayName": "A String", # A user-settable field to provide a human-readable name to be used in user interfaces.
      "etag": "A String", # Fingerprint of the InsightTypeConfig. Provides optimistic locking when updating.
      "insightTypeGenerationConfig": { # A configuration to customize the generation of insights. Eg, customizing the lookback period considered when generating a insight. # InsightTypeGenerationConfig which configures the generation of insights for this insight type.
        "params": { # Parameters for this InsightTypeGenerationConfig. These configs can be used by or are applied to all subtypes.
          "a_key": "", # Properties of the object.
        },
      },
      "name": "A String", # Name of insight type config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config
      "revisionId": "A String", # Output only. Immutable. The revision ID of the config. A new revision is committed whenever the config is changed in any way. The format is an 8-character hexadecimal string.
      "updateTime": "A String", # Last time when the config was updated.
    }

      updateMask: string, The list of fields to be updated.
      validateOnly: boolean, If true, validate the request and preview the change, but do not actually update it.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Configuration for an InsightType.
      "annotations": { # Allows clients to store small amounts of arbitrary data. Annotations must follow the Kubernetes syntax. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.
        "a_key": "A String",
      },
      "displayName": "A String", # A user-settable field to provide a human-readable name to be used in user interfaces.
      "etag": "A String", # Fingerprint of the InsightTypeConfig. Provides optimistic locking when updating.
      "insightTypeGenerationConfig": { # A configuration to customize the generation of insights. Eg, customizing the lookback period considered when generating a insight. # InsightTypeGenerationConfig which configures the generation of insights for this insight type.
        "params": { # Parameters for this InsightTypeGenerationConfig. These configs can be used by or are applied to all subtypes.
          "a_key": "", # Properties of the object.
        },
      },
      "name": "A String", # Name of insight type config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config
      "revisionId": "A String", # Output only. Immutable. The revision ID of the config. A new revision is committed whenever the config is changed in any way. The format is an 8-character hexadecimal string.
      "updateTime": "A String", # Last time when the config was updated.
    }