Skip to content

experiment: docs diff for vision api #15467

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
ohmayr wants to merge 9 commits into
base: main
Choose a base branch
from
Draft

experiment: docs diff for vision api #15467

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
391c43c
experiment: docs diff for vision api
ohmayr Jan 16, 2026
6a97d37
version 2
ohmayr Jan 16, 2026
bf5a476
version 3
ohmayr Jan 16, 2026
d8a5811
version 4
ohmayr Jan 16, 2026
f10729d
version 5
ohmayr Jan 16, 2026
9dc4768
version 6
ohmayr Jan 17, 2026
dccd6c0
version 7
ohmayr Jan 17, 2026
e2cb3b8
version 8
ohmayr Jan 17, 2026
f7972f0
version 9
ohmayr Jan 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions .librarian/generate-request.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
{
"id": "google-cloud-vision",
"version": "3.12.0",
"apis": [
{
"path": "google/cloud/vision/v1p3beta1",
"service_config": "vision_v1p3beta1.yaml"
},
{
"path": "google/cloud/vision/v1",
"service_config": "vision_v1.yaml"
},
{
"path": "google/cloud/vision/v1p1beta1",
"service_config": "vision_v1p1beta1.yaml"
},
{
"path": "google/cloud/vision/v1p2beta1",
"service_config": "vision_v1p2beta1.yaml"
},
{
"path": "google/cloud/vision/v1p4beta1",
"service_config": "vision_v1p4beta1.yaml"
}
],
Comment on lines +4 to +25
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot Jan 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For better readability and easier maintenance, consider sorting the API versions in the apis array. For example, v1, v1p1beta1, v1p2beta1, etc.

"source_roots": [
"packages/google-cloud-vision"
],
"preserve_regex": [
"packages/google-cloud-vision/CHANGELOG.md",
"docs/CHANGELOG.md",
"samples/README.txt",
"samples/snippets/README.rst",
"tests/system"
],
"remove_regex": [
"packages/google-cloud-vision/"
],
"tag_format": "{id}-v{version}"
}
13 changes: 5 additions & 8 deletions packages/google-cloud-vision/google/cloud/vision_v1/services/image_annotator/async_client.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -536,11 +536,9 @@ async def async_batch_annotate_images(
r"""Run asynchronous image detection and annotation for a list of
images.

Progress and results can be retrieved through the
``google.longrunning.Operations`` interface.
``Operation.metadata`` contains ``OperationMetadata``
(metadata). ``Operation.response`` contains
``AsyncBatchAnnotateImagesResponse`` (results).
Progress and results can be retrieved through the ``google.longrunning.Operations``
interface. ``Operation.metadata`` contains ``OperationMetadata`` (metadata).
``Operation.response`` contains ``AsyncBatchAnnotateImagesResponse`` (results).

This service will write image annotation outputs to json files
in customer GCS bucket, each json file containing
Expand Down Expand Up @@ -679,9 +677,8 @@ async def async_batch_annotate_files(
r"""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. Progress and results can be
retrieved through the ``google.longrunning.Operations``
interface. ``Operation.metadata`` contains ``OperationMetadata``
(metadata). ``Operation.response`` contains
retrieved through the ``google.longrunning.Operations`` interface. ``Operation.metadata``
contains ``OperationMetadata`` (metadata). ``Operation.response`` contains
``AsyncBatchAnnotateFilesResponse`` (results).

.. code-block:: python
Expand Down
13 changes: 5 additions & 8 deletions packages/google-cloud-vision/google/cloud/vision_v1/services/image_annotator/client.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -993,11 +993,9 @@ def async_batch_annotate_images(
r"""Run asynchronous image detection and annotation for a list of
images.

Progress and results can be retrieved through the
``google.longrunning.Operations`` interface.
``Operation.metadata`` contains ``OperationMetadata``
(metadata). ``Operation.response`` contains
``AsyncBatchAnnotateImagesResponse`` (results).
Progress and results can be retrieved through the ``google.longrunning.Operations``
interface. ``Operation.metadata`` contains ``OperationMetadata`` (metadata).
``Operation.response`` contains ``AsyncBatchAnnotateImagesResponse`` (results).

This service will write image annotation outputs to json files
in customer GCS bucket, each json file containing
Expand Down Expand Up @@ -1135,9 +1133,8 @@ def async_batch_annotate_files(
r"""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. Progress and results can be
retrieved through the ``google.longrunning.Operations``
interface. ``Operation.metadata`` contains ``OperationMetadata``
(metadata). ``Operation.response`` contains
retrieved through the ``google.longrunning.Operations`` interface. ``Operation.metadata``
contains ``OperationMetadata`` (metadata). ``Operation.response`` contains
``AsyncBatchAnnotateFilesResponse`` (results).

.. code-block:: python
Expand Down
11 changes: 7 additions & 4 deletions ...es/google-cloud-vision/google/cloud/vision_v1/services/image_annotator/transports/base.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,8 +86,6 @@ def __init__(
be used for service account credentials.
"""

scopes_kwargs = {"scopes": scopes, "default_scopes": self.AUTH_SCOPES}

# Save the scopes.
self._scopes = scopes
if not hasattr(self, "_ignore_credentials"):
Expand All @@ -102,11 +100,16 @@ def __init__(

if credentials_file is not None:
credentials, _ = google.auth.load_credentials_from_file(
credentials_file, **scopes_kwargs, quota_project_id=quota_project_id
credentials_file,
scopes=scopes,
quota_project_id=quota_project_id,
default_scopes=self.AUTH_SCOPES,
)
elif credentials is None and not self._ignore_credentials:
credentials, _ = google.auth.default(
**scopes_kwargs, quota_project_id=quota_project_id
scopes=scopes,
quota_project_id=quota_project_id,
default_scopes=self.AUTH_SCOPES,
)
# Don't apply audience if the credentials file passed from user.
if hasattr(credentials, "with_gdch_audience"):
Expand Down
13 changes: 5 additions & 8 deletions ...es/google-cloud-vision/google/cloud/vision_v1/services/image_annotator/transports/grpc.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -420,11 +420,9 @@ def async_batch_annotate_images(
Run asynchronous image detection and annotation for a list of
images.

Progress and results can be retrieved through the
``google.longrunning.Operations`` interface.
``Operation.metadata`` contains ``OperationMetadata``
(metadata). ``Operation.response`` contains
``AsyncBatchAnnotateImagesResponse`` (results).
Progress and results can be retrieved through the ``google.longrunning.Operations``
interface. ``Operation.metadata`` contains ``OperationMetadata`` (metadata).
``Operation.response`` contains ``AsyncBatchAnnotateImagesResponse`` (results).

This service will write image annotation outputs to json files
in customer GCS bucket, each json file containing
Expand Down Expand Up @@ -461,9 +459,8 @@ def async_batch_annotate_files(
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. Progress and results can be
retrieved through the ``google.longrunning.Operations``
interface. ``Operation.metadata`` contains ``OperationMetadata``
(metadata). ``Operation.response`` contains
retrieved through the ``google.longrunning.Operations`` interface. ``Operation.metadata``
contains ``OperationMetadata`` (metadata). ``Operation.response`` contains
``AsyncBatchAnnotateFilesResponse`` (results).

Returns:
Expand Down
13 changes: 5 additions & 8 deletions ...e-cloud-vision/google/cloud/vision_v1/services/image_annotator/transports/grpc_asyncio.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -429,11 +429,9 @@ def async_batch_annotate_images(
Run asynchronous image detection and annotation for a list of
images.

Progress and results can be retrieved through the
``google.longrunning.Operations`` interface.
``Operation.metadata`` contains ``OperationMetadata``
(metadata). ``Operation.response`` contains
``AsyncBatchAnnotateImagesResponse`` (results).
Progress and results can be retrieved through the ``google.longrunning.Operations``
interface. ``Operation.metadata`` contains ``OperationMetadata`` (metadata).
``Operation.response`` contains ``AsyncBatchAnnotateImagesResponse`` (results).

This service will write image annotation outputs to json files
in customer GCS bucket, each json file containing
Expand Down Expand Up @@ -471,9 +469,8 @@ def async_batch_annotate_files(
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. Progress and results can be
retrieved through the ``google.longrunning.Operations``
interface. ``Operation.metadata`` contains ``OperationMetadata``
(metadata). ``Operation.response`` contains
retrieved through the ``google.longrunning.Operations`` interface. ``Operation.metadata``
contains ``OperationMetadata`` (metadata). ``Operation.response`` contains
``AsyncBatchAnnotateFilesResponse`` (results).

Returns:
Expand Down
Loading
Loading