Google Cloud AutoML Projects API

The Projects API from Google Cloud AutoML — 4 operation(s) for projects.

OpenAPI Specification

google-cloud-automl-projects-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Google Cloud AutoML Projects API
  description: Trains and deploys custom machine learning models using Google's AutoML technology with transfer learning and neural architecture search.
  version: v1
  contact:
    name: Google Cloud
    url: https://cloud.google.com/automl
servers:
- url: https://automl.googleapis.com/v1
tags:
- name: Projects
paths:
  /projects/{projectId}/locations/{location}/datasets:
    get:
      operationId: listDatasets
      summary: Google Cloud AutoML List datasets
      description: Lists all datasets in the specified project and location.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      - name: location
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response with list of datasets.
          content:
            application/json:
              schema:
                type: object
                properties:
                  datasets:
                    type: array
                    items:
                      $ref: '#/components/schemas/Dataset'
      tags:
      - Projects
    post:
      operationId: createDataset
      summary: Google Cloud AutoML Create a dataset
      description: Creates a new dataset for model training.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      - name: location
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Dataset'
      responses:
        '200':
          description: Long-running operation for dataset creation.
          content:
            application/json:
              schema:
                type: object
      tags:
      - Projects
  /projects/{projectId}/locations/{location}/models:
    get:
      operationId: listModels
      summary: Google Cloud AutoML List models
      description: Lists all models in the specified project and location.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      - name: location
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response with list of models.
          content:
            application/json:
              schema:
                type: object
                properties:
                  model:
                    type: array
                    items:
                      $ref: '#/components/schemas/Model'
      tags:
      - Projects
    post:
      operationId: createModel
      summary: Google Cloud AutoML Create a model
      description: Creates and trains a new custom model.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      - name: location
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Model'
      responses:
        '200':
          description: Long-running operation for model training.
          content:
            application/json:
              schema:
                type: object
      tags:
      - Projects
  /projects/{projectId}/locations/{location}/models/{modelId}:
    get:
      operationId: getModel
      summary: Google Cloud AutoML Get a model
      description: Gets the details of a specific model.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      - name: location
        in: path
        required: true
        schema:
          type: string
      - name: modelId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response with model details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Model'
      tags:
      - Projects
    delete:
      operationId: deleteModel
      summary: Google Cloud AutoML Delete a model
      description: Deletes a model and all its associated resources.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      - name: location
        in: path
        required: true
        schema:
          type: string
      - name: modelId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Long-running operation for model deletion.
      tags:
      - Projects
  /projects/{projectId}/locations/{location}/models/{modelId}:predict:
    post:
      operationId: predict
      summary: Google Cloud AutoML Make a prediction
      description: Performs a prediction using a trained model.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      - name: location
        in: path
        required: true
        schema:
          type: string
      - name: modelId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PredictRequest'
      responses:
        '200':
          description: Successful prediction response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PredictResponse'
      tags:
      - Projects
components:
  schemas:
    PredictRequest:
      type: object
      required:
      - payload
      properties:
        payload:
          type: object
          properties:
            textSnippet:
              type: object
              properties:
                content:
                  type: string
                mimeType:
                  type: string
            image:
              type: object
              properties:
                imageBytes:
                  type: string
        params:
          type: object
          additionalProperties:
            type: string
    Model:
      type: object
      properties:
        name:
          type: string
        displayName:
          type: string
        datasetId:
          type: string
        createTime:
          type: string
        updateTime:
          type: string
        deploymentState:
          type: string
          enum:
          - DEPLOYMENT_STATE_UNSPECIFIED
          - DEPLOYED
          - UNDEPLOYED
    Dataset:
      type: object
      properties:
        name:
          type: string
        displayName:
          type: string
        description:
          type: string
        exampleCount:
          type: integer
        createTime:
          type: string
        updateTime:
          type: string
    PredictResponse:
      type: object
      properties:
        payload:
          type: array
          items:
            type: object
            properties:
              displayName:
                type: string
              classification:
                type: object
                properties:
                  score:
                    type: number
        metadata:
          type: object
          additionalProperties:
            type: string