# Cloud Vision API

Integrates Google Vision features, including image labeling, face, logo, and landmark detection, optical character recognition (OCR), and detection of explicit content, into applications.

- [REST Resource: v1.files](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.files)
- [REST Resource: v1.images](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.images)
- [REST Resource: v1.locations.operations](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.locations.operations)
- [REST Resource: v1.operations](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.operations)
- [REST Resource: v1.projects.files](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.projects.files)
- [REST Resource: v1.projects.images](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.projects.images)
- [REST Resource: v1.projects.locations.files](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.projects.locations.files)
- [REST Resource: v1.projects.locations.images](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.projects.locations.images)
- [REST Resource: v1.projects.locations.operations](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.projects.locations.operations)
- [REST Resource: v1.projects.locations.productSets](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.projects.locations.productSets)
- [REST Resource: v1.projects.locations.productSets.products](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.projects.locations.productSets.products)
- [REST Resource: v1.projects.locations.products](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.projects.locations.products)
- [REST Resource: v1.projects.locations.products.referenceImages](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.projects.locations.products.referenceImages)
- [REST Resource: v1.projects.operations](https://docs.cloud.google.com/vision/product-search/docs/reference/rest#v1.projects.operations)

## Service: vision.googleapis.com

We recommend that you call this service using Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to call this service using your own libraries, you should use the following information when making the API requests.

### Discovery document

A [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:

- <https://vision.googleapis.com/$discovery/rest?version=v1>

### Service endpoint

A [service endpoint](https://cloud.google.com/apis/design/glossary) is a base URL that specifies the network address of an API service. One service may have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

- `https://vision.googleapis.com`

## REST Resource: [v1.files](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/files)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/files/annotate` | `POST /v1/files:annotate` Service that performs image detection and annotation for a batch of files. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/files/asyncBatchAnnotate` | `POST /v1/files:asyncBatchAnnotate` Run asynchronous image detection and annotation for a list of generic files, such as PDF files, which may contain multiple pages and multiple images per page. |

## REST Resource: [v1.images](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/images)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/images/annotate` | `POST /v1/images:annotate` Run image detection and annotation for a batch of images. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/images/asyncBatchAnnotate` | `POST /v1/images:asyncBatchAnnotate` Run asynchronous image detection and annotation for a list of images. |

## REST Resource: [v1.locations.operations](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/locations.operations)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/locations.operations/get` | `GET /v1/{name=locations/*/operations/*}` Gets the latest state of a long-running operation. |

## REST Resource: [v1.operations](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/operations)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/operations/get` | `GET /v1/{name=operations/*}` Gets the latest state of a long-running operation. |

## REST Resource: [v1.projects.files](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.files)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.files/annotate` | `POST /v1/{parent=projects/*}/files:annotate` Service that performs image detection and annotation for a batch of files. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.files/asyncBatchAnnotate` | `POST /v1/{parent=projects/*}/files:asyncBatchAnnotate` Run asynchronous image detection and annotation for a list of generic files, such as PDF files, which may contain multiple pages and multiple images per page. |

## REST Resource: [v1.projects.images](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.images)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.images/annotate` | `POST /v1/{parent=projects/*}/images:annotate` Run image detection and annotation for a batch of images. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.images/asyncBatchAnnotate` | `POST /v1/{parent=projects/*}/images:asyncBatchAnnotate` Run asynchronous image detection and annotation for a list of images. |

## REST Resource: [v1.projects.locations.files](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.files)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.files/annotate` | `POST /v1/{parent=projects/*/locations/*}/files:annotate` Service that performs image detection and annotation for a batch of files. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.files/asyncBatchAnnotate` | `POST /v1/{parent=projects/*/locations/*}/files:asyncBatchAnnotate` Run asynchronous image detection and annotation for a list of generic files, such as PDF files, which may contain multiple pages and multiple images per page. |

## REST Resource: [v1.projects.locations.images](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.images)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.images/annotate` | `POST /v1/{parent=projects/*/locations/*}/images:annotate` Run image detection and annotation for a batch of images. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.images/asyncBatchAnnotate` | `POST /v1/{parent=projects/*/locations/*}/images:asyncBatchAnnotate` Run asynchronous image detection and annotation for a list of images. |

## REST Resource: [v1.projects.locations.operations](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.operations)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.operations/get` | `GET /v1/{name=projects/*/locations/*/operations/*}` Gets the latest state of a long-running operation. |

## REST Resource: [v1.projects.locations.productSets](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.productSets)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.productSets/addProduct` | `POST /v1/{name=projects/*/locations/*/productSets/*}:addProduct` Adds a Product to the specified ProductSet. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.productSets/create` | `POST /v1/{parent=projects/*/locations/*}/productSets` Creates and returns a new ProductSet resource. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.productSets/delete` | `DELETE /v1/{name=projects/*/locations/*/productSets/*}` Permanently deletes a ProductSet. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.productSets/get` | `GET /v1/{name=projects/*/locations/*/productSets/*}` Gets information associated with a ProductSet. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.productSets/import` | `POST /v1/{parent=projects/*/locations/*}/productSets:import` Asynchronous API that imports a list of reference images to specified product sets based on a list of image information. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.productSets/list` | `GET /v1/{parent=projects/*/locations/*}/productSets` Lists ProductSets in an unspecified order. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.productSets/patch` | `PATCH /v1/{productSet.name=projects/*/locations/*/productSets/*}` Makes changes to a ProductSet resource. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.productSets/removeProduct` | `POST /v1/{name=projects/*/locations/*/productSets/*}:removeProduct` Removes a Product from the specified ProductSet. |

## REST Resource: [v1.projects.locations.productSets.products](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.productSets.products)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.productSets.products/list` | `GET /v1/{name=projects/*/locations/*/productSets/*}/products` Lists the Products in a ProductSet, in an unspecified order. |

## REST Resource: [v1.projects.locations.products](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.products)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.products/create` | `POST /v1/{parent=projects/*/locations/*}/products` Creates and returns a new product resource. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.products/delete` | `DELETE /v1/{name=projects/*/locations/*/products/*}` Permanently deletes a product and its reference images. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.products/get` | `GET /v1/{name=projects/*/locations/*/products/*}` Gets information associated with a Product. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.products/list` | `GET /v1/{parent=projects/*/locations/*}/products` Lists products in an unspecified order. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.products/patch` | `PATCH /v1/{product.name=projects/*/locations/*/products/*}` Makes changes to a Product resource. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.products/purge` | `POST /v1/{parent=projects/*/locations/*}/products:purge` Asynchronous API to delete all Products in a ProductSet or all Products that are in no ProductSet. |

## REST Resource: [v1.projects.locations.products.referenceImages](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.products.referenceImages)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.products.referenceImages/create` | `POST /v1/{parent=projects/*/locations/*/products/*}/referenceImages` Creates and returns a new ReferenceImage resource. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.products.referenceImages/delete` | `DELETE /v1/{name=projects/*/locations/*/products/*/referenceImages/*}` Permanently deletes a reference image. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.products.referenceImages/get` | `GET /v1/{name=projects/*/locations/*/products/*/referenceImages/*}` Gets information associated with a ReferenceImage. |
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.locations.products.referenceImages/list` | `GET /v1/{parent=projects/*/locations/*/products/*}/referenceImages` Lists reference images. |

## REST Resource: [v1.projects.operations](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.operations)

| Methods ||
|---|---|
| `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1/projects.operations/get` | `GET /v1/{name=projects/*/operations/*}` Gets the latest state of a long-running operation. |