412 lines
12 KiB
JSON
412 lines
12 KiB
JSON
{
|
|
"kind": "discovery#restDescription",
|
|
"etag": "\"FrPV2U6xXFUq8eRv_PO3IoAURkc/AH0kDxitXVy6ezxE7JaWy7alDdY\"",
|
|
"discoveryVersion": "v1",
|
|
"id": "prediction:v1.3",
|
|
"name": "prediction",
|
|
"version": "v1.3",
|
|
"revision": "20140522",
|
|
"title": "Prediction API",
|
|
"description": "Lets you access a cloud hosted machine learning service that makes it easy to build smart apps",
|
|
"ownerDomain": "google.com",
|
|
"ownerName": "Google",
|
|
"icons": {
|
|
"x16": "http://www.google.com/images/icons/feature/predictionapi-16.png",
|
|
"x32": "http://www.google.com/images/icons/feature/predictionapi-32.png"
|
|
},
|
|
"documentationLink": "https://developers.google.com/prediction/docs/developer-guide",
|
|
"protocol": "rest",
|
|
"baseUrl": "https://www.googleapis.com/prediction/v1.3/",
|
|
"basePath": "/prediction/v1.3/",
|
|
"rootUrl": "https://www.googleapis.com/",
|
|
"servicePath": "prediction/v1.3/",
|
|
"batchPath": "batch",
|
|
"parameters": {
|
|
"alt": {
|
|
"type": "string",
|
|
"description": "Data format for the response.",
|
|
"default": "json",
|
|
"enum": [
|
|
"json"
|
|
],
|
|
"enumDescriptions": [
|
|
"Responses with Content-Type of application/json"
|
|
],
|
|
"location": "query"
|
|
},
|
|
"fields": {
|
|
"type": "string",
|
|
"description": "Selector specifying which fields to include in a partial response.",
|
|
"location": "query"
|
|
},
|
|
"key": {
|
|
"type": "string",
|
|
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
|
|
"location": "query"
|
|
},
|
|
"oauth_token": {
|
|
"type": "string",
|
|
"description": "OAuth 2.0 token for the current user.",
|
|
"location": "query"
|
|
},
|
|
"prettyPrint": {
|
|
"type": "boolean",
|
|
"description": "Returns response with indentations and line breaks.",
|
|
"default": "true",
|
|
"location": "query"
|
|
},
|
|
"quotaUser": {
|
|
"type": "string",
|
|
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. Overrides userIp if both are provided.",
|
|
"location": "query"
|
|
},
|
|
"userIp": {
|
|
"type": "string",
|
|
"description": "IP address of the site where the request originates. Use this if you want to enforce per-user limits.",
|
|
"location": "query"
|
|
}
|
|
},
|
|
"auth": {
|
|
"oauth2": {
|
|
"scopes": {
|
|
"https://www.googleapis.com/auth/devstorage.full_control": {
|
|
"description": "Manage your data and permissions in Google Cloud Storage"
|
|
},
|
|
"https://www.googleapis.com/auth/devstorage.read_only": {
|
|
"description": "View your data in Google Cloud Storage"
|
|
},
|
|
"https://www.googleapis.com/auth/devstorage.read_write": {
|
|
"description": "Manage your data in Google Cloud Storage"
|
|
},
|
|
"https://www.googleapis.com/auth/prediction": {
|
|
"description": "Manage your data in the Google Prediction API"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"schemas": {
|
|
"Input": {
|
|
"id": "Input",
|
|
"type": "object",
|
|
"properties": {
|
|
"input": {
|
|
"type": "object",
|
|
"description": "Input to the model for a prediction",
|
|
"properties": {
|
|
"csvInstance": {
|
|
"type": "array",
|
|
"description": "A list of input features, these can be strings or doubles.",
|
|
"items": {
|
|
"type": "any"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"Output": {
|
|
"id": "Output",
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"description": "The unique name for the predictive model."
|
|
},
|
|
"kind": {
|
|
"type": "string",
|
|
"description": "What kind of resource this is.",
|
|
"default": "prediction#output"
|
|
},
|
|
"outputLabel": {
|
|
"type": "string",
|
|
"description": "The most likely class [Categorical models only]."
|
|
},
|
|
"outputMulti": {
|
|
"type": "array",
|
|
"description": "A list of classes with their estimated probabilities [Categorical models only].",
|
|
"items": {
|
|
"type": "object",
|
|
"properties": {
|
|
"label": {
|
|
"type": "string",
|
|
"description": "The class label."
|
|
},
|
|
"score": {
|
|
"type": "number",
|
|
"description": "The probability of the class.",
|
|
"format": "double"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"outputValue": {
|
|
"type": "number",
|
|
"description": "The estimated regression value [Regression models only].",
|
|
"format": "double"
|
|
},
|
|
"selfLink": {
|
|
"type": "string",
|
|
"description": "A URL to re-request this resource."
|
|
}
|
|
}
|
|
},
|
|
"Training": {
|
|
"id": "Training",
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"description": "The unique name for the predictive model."
|
|
},
|
|
"kind": {
|
|
"type": "string",
|
|
"description": "What kind of resource this is.",
|
|
"default": "prediction#training"
|
|
},
|
|
"modelInfo": {
|
|
"type": "object",
|
|
"description": "Model metadata.",
|
|
"properties": {
|
|
"classWeightedAccuracy": {
|
|
"type": "number",
|
|
"description": "Estimated accuracy of model taking utility weights into account [Categorical models only].",
|
|
"format": "double"
|
|
},
|
|
"classificationAccuracy": {
|
|
"type": "number",
|
|
"description": "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].",
|
|
"format": "double"
|
|
},
|
|
"confusionMatrix": {
|
|
"type": "object",
|
|
"description": "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].",
|
|
"additionalProperties": {
|
|
"type": "object",
|
|
"description": "The true class label.",
|
|
"additionalProperties": {
|
|
"type": "number",
|
|
"description": "The pair {predicted_label, count}.",
|
|
"format": "double"
|
|
}
|
|
}
|
|
},
|
|
"confusionMatrixRowTotals": {
|
|
"type": "object",
|
|
"description": "A list of the confusion matrix row totals",
|
|
"additionalProperties": {
|
|
"type": "number",
|
|
"description": "The true class associated with how many instances it had",
|
|
"format": "double"
|
|
}
|
|
},
|
|
"meanSquaredError": {
|
|
"type": "number",
|
|
"description": "An estimated mean squared error. The can be used to measure the quality of the predicted model [Regression models only].",
|
|
"format": "double"
|
|
},
|
|
"modelType": {
|
|
"type": "string",
|
|
"description": "Type of predictive model (CLASSIFICATION or REGRESSION)"
|
|
},
|
|
"numberClasses": {
|
|
"type": "string",
|
|
"description": "Number of classes in the trained model [Categorical models only].",
|
|
"format": "int64"
|
|
},
|
|
"numberInstances": {
|
|
"type": "string",
|
|
"description": "Number of valid data instances used in the trained model.",
|
|
"format": "int64"
|
|
}
|
|
}
|
|
},
|
|
"selfLink": {
|
|
"type": "string",
|
|
"description": "A URL to re-request this resource."
|
|
},
|
|
"trainingStatus": {
|
|
"type": "string",
|
|
"description": "The current status of the training job. This can be one of following: RUNNING; DONE; ERROR; ERROR: TRAINING JOB NOT FOUND"
|
|
},
|
|
"utility": {
|
|
"type": "array",
|
|
"description": "A class weighting function, which allows the importance weights for classes to be specified [Categorical models only].",
|
|
"items": {
|
|
"type": "object",
|
|
"description": "Class label (string).",
|
|
"additionalProperties": {
|
|
"type": "number",
|
|
"format": "double"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"Update": {
|
|
"id": "Update",
|
|
"type": "object",
|
|
"properties": {
|
|
"classLabel": {
|
|
"type": "string",
|
|
"description": "The true class label of this instance"
|
|
},
|
|
"csvInstance": {
|
|
"type": "array",
|
|
"description": "The input features for this instance",
|
|
"items": {
|
|
"type": "any"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"resources": {
|
|
"hostedmodels": {
|
|
"methods": {
|
|
"predict": {
|
|
"id": "prediction.hostedmodels.predict",
|
|
"path": "hostedmodels/{hostedModelName}/predict",
|
|
"httpMethod": "POST",
|
|
"description": "Submit input and request an output against a hosted model",
|
|
"parameters": {
|
|
"hostedModelName": {
|
|
"type": "string",
|
|
"description": "The name of a hosted model",
|
|
"required": true,
|
|
"location": "path"
|
|
}
|
|
},
|
|
"parameterOrder": [
|
|
"hostedModelName"
|
|
],
|
|
"request": {
|
|
"$ref": "Input"
|
|
},
|
|
"response": {
|
|
"$ref": "Output"
|
|
},
|
|
"scopes": [
|
|
"https://www.googleapis.com/auth/prediction"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"training": {
|
|
"methods": {
|
|
"delete": {
|
|
"id": "prediction.training.delete",
|
|
"path": "training/{data}",
|
|
"httpMethod": "DELETE",
|
|
"description": "Delete a trained model",
|
|
"parameters": {
|
|
"data": {
|
|
"type": "string",
|
|
"description": "mybucket/mydata resource in Google Storage",
|
|
"required": true,
|
|
"location": "path"
|
|
}
|
|
},
|
|
"parameterOrder": [
|
|
"data"
|
|
],
|
|
"scopes": [
|
|
"https://www.googleapis.com/auth/prediction"
|
|
]
|
|
},
|
|
"get": {
|
|
"id": "prediction.training.get",
|
|
"path": "training/{data}",
|
|
"httpMethod": "GET",
|
|
"description": "Check training status of your model",
|
|
"parameters": {
|
|
"data": {
|
|
"type": "string",
|
|
"description": "mybucket/mydata resource in Google Storage",
|
|
"required": true,
|
|
"location": "path"
|
|
}
|
|
},
|
|
"parameterOrder": [
|
|
"data"
|
|
],
|
|
"response": {
|
|
"$ref": "Training"
|
|
},
|
|
"scopes": [
|
|
"https://www.googleapis.com/auth/prediction"
|
|
]
|
|
},
|
|
"insert": {
|
|
"id": "prediction.training.insert",
|
|
"path": "training",
|
|
"httpMethod": "POST",
|
|
"description": "Begin training your model",
|
|
"request": {
|
|
"$ref": "Training"
|
|
},
|
|
"response": {
|
|
"$ref": "Training"
|
|
},
|
|
"scopes": [
|
|
"https://www.googleapis.com/auth/devstorage.full_control",
|
|
"https://www.googleapis.com/auth/devstorage.read_only",
|
|
"https://www.googleapis.com/auth/devstorage.read_write",
|
|
"https://www.googleapis.com/auth/prediction"
|
|
]
|
|
},
|
|
"predict": {
|
|
"id": "prediction.training.predict",
|
|
"path": "training/{data}/predict",
|
|
"httpMethod": "POST",
|
|
"description": "Submit data and request a prediction",
|
|
"parameters": {
|
|
"data": {
|
|
"type": "string",
|
|
"description": "mybucket/mydata resource in Google Storage",
|
|
"required": true,
|
|
"location": "path"
|
|
}
|
|
},
|
|
"parameterOrder": [
|
|
"data"
|
|
],
|
|
"request": {
|
|
"$ref": "Input"
|
|
},
|
|
"response": {
|
|
"$ref": "Output"
|
|
},
|
|
"scopes": [
|
|
"https://www.googleapis.com/auth/prediction"
|
|
]
|
|
},
|
|
"update": {
|
|
"id": "prediction.training.update",
|
|
"path": "training/{data}",
|
|
"httpMethod": "PUT",
|
|
"description": "Add new data to a trained model",
|
|
"parameters": {
|
|
"data": {
|
|
"type": "string",
|
|
"description": "mybucket/mydata resource in Google Storage",
|
|
"required": true,
|
|
"location": "path"
|
|
}
|
|
},
|
|
"parameterOrder": [
|
|
"data"
|
|
],
|
|
"request": {
|
|
"$ref": "Update"
|
|
},
|
|
"response": {
|
|
"$ref": "Training"
|
|
},
|
|
"scopes": [
|
|
"https://www.googleapis.com/auth/prediction"
|
|
]
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|