v1/doc/google/cloud/automl/v1/doc_service.js

// Copyright 2019 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

// Note: this file is purely for documentation. Any contents are not expected
// to be loaded as the JS file.

/**
 * Request message for
 * AutoMl.CreateDataset.
 *
 * @property {string} parent
 *   The resource name of the project to create the dataset for.
 *
 * @property {Object} dataset
 *   The dataset to create.
 *
 *   This object should have the same structure as [Dataset]{@link google.cloud.automl.v1.Dataset}
 *
 * @typedef CreateDatasetRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.CreateDatasetRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const CreateDatasetRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.GetDataset.
 *
 * @property {string} name
 *   The resource name of the dataset to retrieve.
 *
 * @typedef GetDatasetRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.GetDatasetRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const GetDatasetRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.ListDatasets.
 *
 * @property {string} parent
 *   The resource name of the project from which to list datasets.
 *
 * @property {string} filter
 *   An expression for filtering the results of the request.
 *
 *     * `dataset_metadata` - for existence of the case (e.g.
 *               image_classification_dataset_metadata:*).
 *   Some examples of using the filter are:
 *
 *     * `translation_dataset_metadata:*` --> The dataset has
 *                                            translation_dataset_metadata.
 *
 * @property {number} pageSize
 *   Requested page size. Server may return fewer results than requested.
 *   If unspecified, server will pick a default size.
 *
 * @property {string} pageToken
 *   A token identifying a page of results for the server to return
 *   Typically obtained via
 *   ListDatasetsResponse.next_page_token
 *   of the previous
 *   AutoMl.ListDatasets call.
 *
 * @typedef ListDatasetsRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.ListDatasetsRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const ListDatasetsRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Response message for
 * AutoMl.ListDatasets.
 *
 * @property {Object[]} datasets
 *   The datasets read.
 *
 *   This object should have the same structure as [Dataset]{@link google.cloud.automl.v1.Dataset}
 *
 * @property {string} nextPageToken
 *   A token to retrieve next page of results.
 *   Pass to
 *   ListDatasetsRequest.page_token
 *   to obtain that page.
 *
 * @typedef ListDatasetsResponse
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.ListDatasetsResponse definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const ListDatasetsResponse = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.UpdateDataset
 *
 * @property {Object} dataset
 *   The dataset which replaces the resource on the server.
 *
 *   This object should have the same structure as [Dataset]{@link google.cloud.automl.v1.Dataset}
 *
 * @property {Object} updateMask
 *   Required. The update mask applies to the resource.
 *
 *   This object should have the same structure as [FieldMask]{@link google.protobuf.FieldMask}
 *
 * @typedef UpdateDatasetRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.UpdateDatasetRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const UpdateDatasetRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.DeleteDataset.
 *
 * @property {string} name
 *   The resource name of the dataset to delete.
 *
 * @typedef DeleteDatasetRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.DeleteDatasetRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const DeleteDatasetRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.ImportData.
 *
 * @property {string} name
 *   Required. Dataset name. Dataset must already exist. All imported
 *   annotations and examples will be added.
 *
 * @property {Object} inputConfig
 *   Required. The desired input location and its domain specific semantics,
 *   if any.
 *
 *   This object should have the same structure as [InputConfig]{@link google.cloud.automl.v1.InputConfig}
 *
 * @typedef ImportDataRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.ImportDataRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const ImportDataRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.ExportData.
 *
 * @property {string} name
 *   Required. The resource name of the dataset.
 *
 * @property {Object} outputConfig
 *   Required. The desired output location.
 *
 *   This object should have the same structure as [OutputConfig]{@link google.cloud.automl.v1.OutputConfig}
 *
 * @typedef ExportDataRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.ExportDataRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const ExportDataRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.CreateModel.
 *
 * @property {string} parent
 *   Resource name of the parent project where the model is being created.
 *
 * @property {Object} model
 *   The model to create.
 *
 *   This object should have the same structure as [Model]{@link google.cloud.automl.v1.Model}
 *
 * @typedef CreateModelRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.CreateModelRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const CreateModelRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.GetModel.
 *
 * @property {string} name
 *   Resource name of the model.
 *
 * @typedef GetModelRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.GetModelRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const GetModelRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.ListModels.
 *
 * @property {string} parent
 *   Resource name of the project, from which to list the models.
 *
 * @property {string} filter
 *   An expression for filtering the results of the request.
 *
 *     * `model_metadata` - for existence of the case (e.g.
 *               video_classification_model_metadata:*).
 *     * `dataset_id` - for = or !=. Some examples of using the filter are:
 *
 *     * `image_classification_model_metadata:*` --> The model has
 *                                          image_classification_model_metadata.
 *     * `dataset_id=5` --> The model was created from a dataset with ID 5.
 *
 * @property {number} pageSize
 *   Requested page size.
 *
 * @property {string} pageToken
 *   A token identifying a page of results for the server to return
 *   Typically obtained via
 *   ListModelsResponse.next_page_token
 *   of the previous
 *   AutoMl.ListModels call.
 *
 * @typedef ListModelsRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.ListModelsRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const ListModelsRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Response message for
 * AutoMl.ListModels.
 *
 * @property {Object[]} model
 *   List of models in the requested page.
 *
 *   This object should have the same structure as [Model]{@link google.cloud.automl.v1.Model}
 *
 * @property {string} nextPageToken
 *   A token to retrieve next page of results.
 *   Pass to
 *   ListModelsRequest.page_token
 *   to obtain that page.
 *
 * @typedef ListModelsResponse
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.ListModelsResponse definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const ListModelsResponse = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.DeleteModel.
 *
 * @property {string} name
 *   Resource name of the model being deleted.
 *
 * @typedef DeleteModelRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.DeleteModelRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const DeleteModelRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.UpdateModel
 *
 * @property {Object} model
 *   The model which replaces the resource on the server.
 *
 *   This object should have the same structure as [Model]{@link google.cloud.automl.v1.Model}
 *
 * @property {Object} updateMask
 *   Required. The update mask applies to the resource.
 *
 *   This object should have the same structure as [FieldMask]{@link google.protobuf.FieldMask}
 *
 * @typedef UpdateModelRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.UpdateModelRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const UpdateModelRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.GetModelEvaluation.
 *
 * @property {string} name
 *   Resource name for the model evaluation.
 *
 * @typedef GetModelEvaluationRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.GetModelEvaluationRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const GetModelEvaluationRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for
 * AutoMl.ListModelEvaluations.
 *
 * @property {string} parent
 *   Resource name of the model to list the model evaluations for.
 *   If modelId is set as "-", this will list model evaluations from across all
 *   models of the parent location.
 *
 * @property {string} filter
 *   An expression for filtering the results of the request.
 *
 *     * `annotation_spec_id` - for =, !=  or existence. See example below for
 *                            the last.
 *
 *   Some examples of using the filter are:
 *
 *     * `annotation_spec_id!=4` --> The model evaluation was done for
 *                               annotation spec with ID different than 4.
 *     * `NOT annotation_spec_id:*` --> The model evaluation was done for
 *                                  aggregate of all annotation specs.
 *
 * @property {number} pageSize
 *   Requested page size.
 *
 * @property {string} pageToken
 *   A token identifying a page of results for the server to return.
 *   Typically obtained via
 *   ListModelEvaluationsResponse.next_page_token
 *   of the previous
 *   AutoMl.ListModelEvaluations
 *   call.
 *
 * @typedef ListModelEvaluationsRequest
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.ListModelEvaluationsRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const ListModelEvaluationsRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Response message for
 * AutoMl.ListModelEvaluations.
 *
 * @property {Object[]} modelEvaluation
 *   List of model evaluations in the requested page.
 *
 *   This object should have the same structure as [ModelEvaluation]{@link google.cloud.automl.v1.ModelEvaluation}
 *
 * @property {string} nextPageToken
 *   A token to retrieve next page of results.
 *   Pass to the
 *   ListModelEvaluationsRequest.page_token
 *   field of a new
 *   AutoMl.ListModelEvaluations
 *   request to obtain that page.
 *
 * @typedef ListModelEvaluationsResponse
 * @memberof google.cloud.automl.v1
 * @see [google.cloud.automl.v1.ListModelEvaluationsResponse definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/automl/v1/service.proto}
 */
const ListModelEvaluationsResponse = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};