# Prediction API . trainedmodels

## Instance Methods

Delete a trained model.

Check training status of your model.

Begin training your model.

Submit model id and request a prediction

Add new data to a trained model.

### Method Details

`delete(id)`

    Delete a trained model.

    Args:
      id: string, The unique name for the predictive model. (required)

`get(id)`

    Check training status of your model.

    Args:
      id: string, The unique name for the predictive model. (required)

    Returns:
      An object of the form:

        {
          "kind": "prediction#training", # What kind of resource this is.
          "storageDataLocation": "A String", # Google storage location of the training data file.
          "storagePMMLModelLocation": "A String", # Google storage location of the pmml model file.
          "dataAnalysis": { # Data Analysis.
            "warnings": [
              "A String",
            ],
          },
          "trainingStatus": "A String", # The current status of the training job. This can be one of following: RUNNING; DONE; ERROR; ERROR: TRAINING JOB NOT FOUND
          "modelInfo": { # Model metadata.
            "confusionMatrixRowTotals": { # A list of the confusion matrix row totals
              "a_key": 3.14,
            },
            "numberLabels": "A String", # Number of class labels in the trained model [Categorical models only].
            "confusionMatrix": { # An output confusion matrix. This shows an estimate for how this model will do in predictions. This is first indexed by the true class label. For each true class label, this provides a pair {predicted_label, count}, where count is the estimated number of times the model will predict the predicted label given the true label. Will not output if more then 100 classes [Categorical models only].
              "a_key": {
                "a_key": 3.14,
              },
            },
            "meanSquaredError": 3.14, # An estimated mean squared error. The can be used to measure the quality of the predicted model [Regression models only].
            "modelType": "A String", # Type of predictive model (CLASSIFICATION or REGRESSION)
            "numberInstances": "A String", # Number of valid data instances used in the trained model.
            "classWeightedAccuracy": 3.14, # Estimated accuracy of model taking utility weights into account [Categorical models only].
            "classificationAccuracy": 3.14, # A number between 0.0 and 1.0, where 1.0 is 100% accurate. This is an estimate, based on the amount and quality of the training data, of the estimated prediction accuracy. You can use this is a guide to decide whether the results are accurate enough for your needs. This estimate will be more reliable if your real input data is similar to your training data [Categorical models only].
          },
          "storagePMMLLocation": "A String", # Google storage location of the preprocessing pmml file.
          "id": "A String", # The unique name for the predictive model.
          "selfLink": "A String", # A URL to re-request this resource.
          "utility": [ # A class weighting function, which allows the importance weights for class labels to be specified [Categorical models only].
            { # Class label (string).
              "a_key": 3.14,
            },
          ],
        }

`insert(body)`

    Begin training your model.

    Args:
      body: object, The request body. (required)
        The object takes the form of:

    {
        "kind": "prediction#training", # What kind of resource this is.
        "storageDataLocation": "A String", # Google storage location of the training data file.
        "storagePMMLModelLocation": "A String", # Google storage location of the pmml model file.
        "dataAnalysis": { # Data Analysis.
          "warnings": [
            "A String",
          ],
        },
        "trainingStatus": "A String", # The current status of the training job. This can be one of following: RUNNING; DONE; ERROR; ERROR: TRAINING JOB NOT FOUND
        "modelInfo": { # Model metadata.
          "confusionMatrixRowTotals": { # A list of the confusion matrix row totals
            "a_key": 3.14,
          },
          "numberLabels": "A String", # Number of class labels in the trained model [Categorical models only].
          "confusionMatrix": { # An output confusion matrix. This shows an estimate for how this model will do in predictions. This is first indexed by the true class label. For each true class label, this provides a pair {predicted_label, count}, where count is the estimated number of times the model will predict the predicted label given the true label. Will not output if more then 100 classes [Categorical models only].
            "a_key": {
              "a_key": 3.14,
            },
          },
          "meanSquaredError": 3.14, # An estimated mean squared error. The can be used to measure the quality of the predicted model [Regression models only].
          "modelType": "A String", # Type of predictive model (CLASSIFICATION or REGRESSION)
          "numberInstances": "A String", # Number of valid data instances used in the trained model.
          "classWeightedAccuracy": 3.14, # Estimated accuracy of model taking utility weights into account [Categorical models only].
          "classificationAccuracy": 3.14, # A number between 0.0 and 1.0, where 1.0 is 100% accurate. This is an estimate, based on the amount and quality of the training data, of the estimated prediction accuracy. You can use this is a guide to decide whether the results are accurate enough for your needs. This estimate will be more reliable if your real input data is similar to your training data [Categorical models only].
        },
        "storagePMMLLocation": "A String", # Google storage location of the preprocessing pmml file.
        "id": "A String", # The unique name for the predictive model.
        "selfLink": "A String", # A URL to re-request this resource.
        "utility": [ # A class weighting function, which allows the importance weights for class labels to be specified [Categorical models only].
          { # Class label (string).
            "a_key": 3.14,
          },
        ],
      }

    Returns:
      An object of the form:

        {
          "kind": "prediction#training", # What kind of resource this is.
          "storageDataLocation": "A String", # Google storage location of the training data file.
          "storagePMMLModelLocation": "A String", # Google storage location of the pmml model file.
          "dataAnalysis": { # Data Analysis.
            "warnings": [
              "A String",
            ],
          },
          "trainingStatus": "A String", # The current status of the training job. This can be one of following: RUNNING; DONE; ERROR; ERROR: TRAINING JOB NOT FOUND
          "modelInfo": { # Model metadata.
            "confusionMatrixRowTotals": { # A list of the confusion matrix row totals
              "a_key": 3.14,
            },
            "numberLabels": "A String", # Number of class labels in the trained model [Categorical models only].
            "confusionMatrix": { # An output confusion matrix. This shows an estimate for how this model will do in predictions. This is first indexed by the true class label. For each true class label, this provides a pair {predicted_label, count}, where count is the estimated number of times the model will predict the predicted label given the true label. Will not output if more then 100 classes [Categorical models only].
              "a_key": {
                "a_key": 3.14,
              },
            },
            "meanSquaredError": 3.14, # An estimated mean squared error. The can be used to measure the quality of the predicted model [Regression models only].
            "modelType": "A String", # Type of predictive model (CLASSIFICATION or REGRESSION)
            "numberInstances": "A String", # Number of valid data instances used in the trained model.
            "classWeightedAccuracy": 3.14, # Estimated accuracy of model taking utility weights into account [Categorical models only].
            "classificationAccuracy": 3.14, # A number between 0.0 and 1.0, where 1.0 is 100% accurate. This is an estimate, based on the amount and quality of the training data, of the estimated prediction accuracy. You can use this is a guide to decide whether the results are accurate enough for your needs. This estimate will be more reliable if your real input data is similar to your training data [Categorical models only].
          },
          "storagePMMLLocation": "A String", # Google storage location of the preprocessing pmml file.
          "id": "A String", # The unique name for the predictive model.
          "selfLink": "A String", # A URL to re-request this resource.
          "utility": [ # A class weighting function, which allows the importance weights for class labels to be specified [Categorical models only].
            { # Class label (string).
              "a_key": 3.14,
            },
          ],
        }

`predict(id, body)`

    Submit model id and request a prediction

    Args:
      id: string, The unique name for the predictive model. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
        "input": { # Input to the model for a prediction
          "csvInstance": [ # A list of input features, these can be strings or doubles.
            "",
          ],
        },
      }

    Returns:
      An object of the form:

        {
        "kind": "prediction#output", # What kind of resource this is.
        "outputLabel": "A String", # The most likely class label [Categorical models only].
        "id": "A String", # The unique name for the predictive model.
        "outputMulti": [ # A list of class labels with their estimated probabilities [Categorical models only].
          {
            "score": 3.14, # The probability of the class label.
            "label": "A String", # The class label.
          },
        ],
        "outputValue": 3.14, # The estimated regression value [Regression models only].
        "selfLink": "A String", # A URL to re-request this resource.
      }

`update(id, body)`

    Add new data to a trained model.

    Args:
      id: string, The unique name for the predictive model. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
        "output": "A String", # The generic output value - could be regression value or class label
        "csvInstance": [ # The input features for this instance
          "",
        ],
        "label": "A String", # The class label of this instance
      }

    Returns:
      An object of the form:

        {
          "kind": "prediction#training", # What kind of resource this is.
          "storageDataLocation": "A String", # Google storage location of the training data file.
          "storagePMMLModelLocation": "A String", # Google storage location of the pmml model file.
          "dataAnalysis": { # Data Analysis.
            "warnings": [
              "A String",
            ],
          },
          "trainingStatus": "A String", # The current status of the training job. This can be one of following: RUNNING; DONE; ERROR; ERROR: TRAINING JOB NOT FOUND
          "modelInfo": { # Model metadata.
            "confusionMatrixRowTotals": { # A list of the confusion matrix row totals
              "a_key": 3.14,
            },
            "numberLabels": "A String", # Number of class labels in the trained model [Categorical models only].
            "confusionMatrix": { # An output confusion matrix. This shows an estimate for how this model will do in predictions. This is first indexed by the true class label. For each true class label, this provides a pair {predicted_label, count}, where count is the estimated number of times the model will predict the predicted label given the true label. Will not output if more then 100 classes [Categorical models only].
              "a_key": {
                "a_key": 3.14,
              },
            },
            "meanSquaredError": 3.14, # An estimated mean squared error. The can be used to measure the quality of the predicted model [Regression models only].
            "modelType": "A String", # Type of predictive model (CLASSIFICATION or REGRESSION)
            "numberInstances": "A String", # Number of valid data instances used in the trained model.
            "classWeightedAccuracy": 3.14, # Estimated accuracy of model taking utility weights into account [Categorical models only].
            "classificationAccuracy": 3.14, # A number between 0.0 and 1.0, where 1.0 is 100% accurate. This is an estimate, based on the amount and quality of the training data, of the estimated prediction accuracy. You can use this is a guide to decide whether the results are accurate enough for your needs. This estimate will be more reliable if your real input data is similar to your training data [Categorical models only].
          },
          "storagePMMLLocation": "A String", # Google storage location of the preprocessing pmml file.
          "id": "A String", # The unique name for the predictive model.
          "selfLink": "A String", # A URL to re-request this resource.
          "utility": [ # A class weighting function, which allows the importance weights for class labels to be specified [Categorical models only].
            { # Class label (string).
              "a_key": 3.14,
            },
          ],
        }