Skip to content

Commit 3d0ff1a

Browse files
chore: upgrade gapic-generator-python (googleapis#10774)
* feat: new APIs added to reflect updates to the filestore service - Add ENTERPRISE Tier - Add snapshot APIs: RevertInstance, ListSnapshots, CreateSnapshot, DeleteSnapshot, UpdateSnapshot - Add multi-share APIs: ListShares, GetShare, CreateShare, DeleteShare, UpdateShare - Add ConnectMode to NetworkConfig (for Private Service Access support) - New status codes (SUSPENDED/SUSPENDING, REVERTING/RESUMING) - Add SuspensionReason (for KMS related suspension) - Add new fields to Instance information: max_capacity_gb, capacity_step_size_gb, max_share_count, capacity_gb, multi_share_enabled PiperOrigin-RevId: 487492758 Source-Link: googleapis/googleapis@5be5981 Source-Link: https://github.com/googleapis/googleapis-gen/commit/ab0e217f560cc2c1afc11441c2eab6b6950efd2b Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRpc2NvdmVyeWVuZ2luZS8uT3dsQm90LnlhbWwiLCJoIjoiYWIwZTIxN2Y1NjBjYzJjMWFmYzExNDQxYzJlYWI2YjY5NTBlZmQyYiJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * fix docs build Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com> Co-authored-by: Anthonios Partheniou <partheniou@google.com>
1 parent 4033c78 commit 3d0ff1a

27 files changed

Lines changed: 409 additions & 1915 deletions

File tree

packages/google-cloud-discoveryengine/docs/discoveryengine_v1beta/types.rst

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,5 +3,4 @@ Types for Google Cloud Discoveryengine v1beta API
33

44
.. automodule:: google.cloud.discoveryengine_v1beta.types
55
:members:
6-
:undoc-members:
76
:show-inheritance:

packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1beta/services/document_service/async_client.py

Lines changed: 41 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,17 @@
1616
from collections import OrderedDict
1717
import functools
1818
import re
19-
from typing import Dict, Mapping, Optional, Sequence, Tuple, Type, Union
19+
from typing import (
20+
Dict,
21+
Mapping,
22+
MutableMapping,
23+
MutableSequence,
24+
Optional,
25+
Sequence,
26+
Tuple,
27+
Type,
28+
Union,
29+
)
2030

2131
from google.api_core import exceptions as core_exceptions
2232
from google.api_core import gapic_v1
@@ -171,9 +181,9 @@ def transport(self) -> DocumentServiceTransport:
171181
def __init__(
172182
self,
173183
*,
174-
credentials: ga_credentials.Credentials = None,
184+
credentials: Optional[ga_credentials.Credentials] = None,
175185
transport: Union[str, DocumentServiceTransport] = "grpc_asyncio",
176-
client_options: ClientOptions = None,
186+
client_options: Optional[ClientOptions] = None,
177187
client_info: gapic_v1.client_info.ClientInfo = DEFAULT_CLIENT_INFO,
178188
) -> None:
179189
"""Instantiates the document service client.
@@ -217,11 +227,11 @@ def __init__(
217227

218228
async def get_document(
219229
self,
220-
request: Union[document_service.GetDocumentRequest, dict] = None,
230+
request: Optional[Union[document_service.GetDocumentRequest, dict]] = None,
221231
*,
222-
name: str = None,
232+
name: Optional[str] = None,
223233
retry: OptionalRetry = gapic_v1.method.DEFAULT,
224-
timeout: float = None,
234+
timeout: Optional[float] = None,
225235
metadata: Sequence[Tuple[str, str]] = (),
226236
) -> document.Document:
227237
r"""Gets a [Document][google.cloud.discoveryengine.v1beta.Document].
@@ -253,7 +263,7 @@ async def sample_get_document():
253263
print(response)
254264
255265
Args:
256-
request (Union[google.cloud.discoveryengine_v1beta.types.GetDocumentRequest, dict]):
266+
request (Optional[Union[google.cloud.discoveryengine_v1beta.types.GetDocumentRequest, dict]]):
257267
The request object. Request message for
258268
[DocumentService.GetDocument][google.cloud.discoveryengine.v1beta.DocumentService.GetDocument]
259269
method.
@@ -332,11 +342,11 @@ async def sample_get_document():
332342

333343
async def list_documents(
334344
self,
335-
request: Union[document_service.ListDocumentsRequest, dict] = None,
345+
request: Optional[Union[document_service.ListDocumentsRequest, dict]] = None,
336346
*,
337-
parent: str = None,
347+
parent: Optional[str] = None,
338348
retry: OptionalRetry = gapic_v1.method.DEFAULT,
339-
timeout: float = None,
349+
timeout: Optional[float] = None,
340350
metadata: Sequence[Tuple[str, str]] = (),
341351
) -> pagers.ListDocumentsAsyncPager:
342352
r"""Gets a list of
@@ -370,7 +380,7 @@ async def sample_list_documents():
370380
print(response)
371381
372382
Args:
373-
request (Union[google.cloud.discoveryengine_v1beta.types.ListDocumentsRequest, dict]):
383+
request (Optional[Union[google.cloud.discoveryengine_v1beta.types.ListDocumentsRequest, dict]]):
374384
The request object. Request message for
375385
[DocumentService.ListDocuments][google.cloud.discoveryengine.v1beta.DocumentService.ListDocuments]
376386
method.
@@ -457,13 +467,13 @@ async def sample_list_documents():
457467

458468
async def create_document(
459469
self,
460-
request: Union[document_service.CreateDocumentRequest, dict] = None,
470+
request: Optional[Union[document_service.CreateDocumentRequest, dict]] = None,
461471
*,
462-
parent: str = None,
463-
document: gcd_document.Document = None,
464-
document_id: str = None,
472+
parent: Optional[str] = None,
473+
document: Optional[gcd_document.Document] = None,
474+
document_id: Optional[str] = None,
465475
retry: OptionalRetry = gapic_v1.method.DEFAULT,
466-
timeout: float = None,
476+
timeout: Optional[float] = None,
467477
metadata: Sequence[Tuple[str, str]] = (),
468478
) -> gcd_document.Document:
469479
r"""Creates a
@@ -501,7 +511,7 @@ async def sample_create_document():
501511
print(response)
502512
503513
Args:
504-
request (Union[google.cloud.discoveryengine_v1beta.types.CreateDocumentRequest, dict]):
514+
request (Optional[Union[google.cloud.discoveryengine_v1beta.types.CreateDocumentRequest, dict]]):
505515
The request object. Request message for
506516
[DocumentService.CreateDocument][google.cloud.discoveryengine.v1beta.DocumentService.CreateDocument]
507517
method.
@@ -606,10 +616,10 @@ async def sample_create_document():
606616

607617
async def update_document(
608618
self,
609-
request: Union[document_service.UpdateDocumentRequest, dict] = None,
619+
request: Optional[Union[document_service.UpdateDocumentRequest, dict]] = None,
610620
*,
611621
retry: OptionalRetry = gapic_v1.method.DEFAULT,
612-
timeout: float = None,
622+
timeout: Optional[float] = None,
613623
metadata: Sequence[Tuple[str, str]] = (),
614624
) -> document.Document:
615625
r"""Updates a
@@ -645,7 +655,7 @@ async def sample_update_document():
645655
print(response)
646656
647657
Args:
648-
request (Union[google.cloud.discoveryengine_v1beta.types.UpdateDocumentRequest, dict]):
658+
request (Optional[Union[google.cloud.discoveryengine_v1beta.types.UpdateDocumentRequest, dict]]):
649659
The request object. Request message for
650660
[DocumentService.UpdateDocument][google.cloud.discoveryengine.v1beta.DocumentService.UpdateDocument]
651661
method.
@@ -694,11 +704,11 @@ async def sample_update_document():
694704

695705
async def delete_document(
696706
self,
697-
request: Union[document_service.DeleteDocumentRequest, dict] = None,
707+
request: Optional[Union[document_service.DeleteDocumentRequest, dict]] = None,
698708
*,
699-
name: str = None,
709+
name: Optional[str] = None,
700710
retry: OptionalRetry = gapic_v1.method.DEFAULT,
701-
timeout: float = None,
711+
timeout: Optional[float] = None,
702712
metadata: Sequence[Tuple[str, str]] = (),
703713
) -> None:
704714
r"""Deletes a
@@ -728,7 +738,7 @@ async def sample_delete_document():
728738
await client.delete_document(request=request)
729739
730740
Args:
731-
request (Union[google.cloud.discoveryengine_v1beta.types.DeleteDocumentRequest, dict]):
741+
request (Optional[Union[google.cloud.discoveryengine_v1beta.types.DeleteDocumentRequest, dict]]):
732742
The request object. Request message for
733743
[DocumentService.DeleteDocument][google.cloud.discoveryengine.v1beta.DocumentService.DeleteDocument]
734744
method.
@@ -797,10 +807,10 @@ async def sample_delete_document():
797807

798808
async def import_documents(
799809
self,
800-
request: Union[import_config.ImportDocumentsRequest, dict] = None,
810+
request: Optional[Union[import_config.ImportDocumentsRequest, dict]] = None,
801811
*,
802812
retry: OptionalRetry = gapic_v1.method.DEFAULT,
803-
timeout: float = None,
813+
timeout: Optional[float] = None,
804814
metadata: Sequence[Tuple[str, str]] = (),
805815
) -> operation_async.AsyncOperation:
806816
r"""Bulk import of multiple
@@ -847,7 +857,7 @@ async def sample_import_documents():
847857
print(response)
848858
849859
Args:
850-
request (Union[google.cloud.discoveryengine_v1beta.types.ImportDocumentsRequest, dict]):
860+
request (Optional[Union[google.cloud.discoveryengine_v1beta.types.ImportDocumentsRequest, dict]]):
851861
The request object. Request message for Import methods.
852862
retry (google.api_core.retry.Retry): Designation of what errors, if any,
853863
should be retried.
@@ -914,10 +924,10 @@ async def sample_import_documents():
914924

915925
async def list_operations(
916926
self,
917-
request: operations_pb2.ListOperationsRequest = None,
927+
request: Optional[operations_pb2.ListOperationsRequest] = None,
918928
*,
919929
retry: OptionalRetry = gapic_v1.method.DEFAULT,
920-
timeout: float = None,
930+
timeout: Optional[float] = None,
921931
metadata: Sequence[Tuple[str, str]] = (),
922932
) -> operations_pb2.ListOperationsResponse:
923933
r"""Lists operations that match the specified filter in the request.
@@ -968,10 +978,10 @@ async def list_operations(
968978

969979
async def get_operation(
970980
self,
971-
request: operations_pb2.GetOperationRequest = None,
981+
request: Optional[operations_pb2.GetOperationRequest] = None,
972982
*,
973983
retry: OptionalRetry = gapic_v1.method.DEFAULT,
974-
timeout: float = None,
984+
timeout: Optional[float] = None,
975985
metadata: Sequence[Tuple[str, str]] = (),
976986
) -> operations_pb2.Operation:
977987
r"""Gets the latest state of a long-running operation.

packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1beta/services/document_service/client.py

Lines changed: 36 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,18 @@
1616
from collections import OrderedDict
1717
import os
1818
import re
19-
from typing import Dict, Mapping, Optional, Sequence, Tuple, Type, Union, cast
19+
from typing import (
20+
Dict,
21+
Mapping,
22+
MutableMapping,
23+
MutableSequence,
24+
Optional,
25+
Sequence,
26+
Tuple,
27+
Type,
28+
Union,
29+
cast,
30+
)
2031

2132
from google.api_core import client_options as client_options_lib
2233
from google.api_core import exceptions as core_exceptions
@@ -67,7 +78,7 @@ class DocumentServiceClientMeta(type):
6778

6879
def get_transport_class(
6980
cls,
70-
label: str = None,
81+
label: Optional[str] = None,
7182
) -> Type[DocumentServiceTransport]:
7283
"""Returns an appropriate transport class.
7384
@@ -373,7 +384,7 @@ def __init__(
373384
self,
374385
*,
375386
credentials: Optional[ga_credentials.Credentials] = None,
376-
transport: Union[str, DocumentServiceTransport, None] = None,
387+
transport: Optional[Union[str, DocumentServiceTransport]] = None,
377388
client_options: Optional[Union[client_options_lib.ClientOptions, dict]] = None,
378389
client_info: gapic_v1.client_info.ClientInfo = DEFAULT_CLIENT_INFO,
379390
) -> None:
@@ -474,11 +485,11 @@ def __init__(
474485

475486
def get_document(
476487
self,
477-
request: Union[document_service.GetDocumentRequest, dict] = None,
488+
request: Optional[Union[document_service.GetDocumentRequest, dict]] = None,
478489
*,
479-
name: str = None,
490+
name: Optional[str] = None,
480491
retry: OptionalRetry = gapic_v1.method.DEFAULT,
481-
timeout: float = None,
492+
timeout: Optional[float] = None,
482493
metadata: Sequence[Tuple[str, str]] = (),
483494
) -> document.Document:
484495
r"""Gets a [Document][google.cloud.discoveryengine.v1beta.Document].
@@ -589,11 +600,11 @@ def sample_get_document():
589600

590601
def list_documents(
591602
self,
592-
request: Union[document_service.ListDocumentsRequest, dict] = None,
603+
request: Optional[Union[document_service.ListDocumentsRequest, dict]] = None,
593604
*,
594-
parent: str = None,
605+
parent: Optional[str] = None,
595606
retry: OptionalRetry = gapic_v1.method.DEFAULT,
596-
timeout: float = None,
607+
timeout: Optional[float] = None,
597608
metadata: Sequence[Tuple[str, str]] = (),
598609
) -> pagers.ListDocumentsPager:
599610
r"""Gets a list of
@@ -714,13 +725,13 @@ def sample_list_documents():
714725

715726
def create_document(
716727
self,
717-
request: Union[document_service.CreateDocumentRequest, dict] = None,
728+
request: Optional[Union[document_service.CreateDocumentRequest, dict]] = None,
718729
*,
719-
parent: str = None,
720-
document: gcd_document.Document = None,
721-
document_id: str = None,
730+
parent: Optional[str] = None,
731+
document: Optional[gcd_document.Document] = None,
732+
document_id: Optional[str] = None,
722733
retry: OptionalRetry = gapic_v1.method.DEFAULT,
723-
timeout: float = None,
734+
timeout: Optional[float] = None,
724735
metadata: Sequence[Tuple[str, str]] = (),
725736
) -> gcd_document.Document:
726737
r"""Creates a
@@ -863,10 +874,10 @@ def sample_create_document():
863874

864875
def update_document(
865876
self,
866-
request: Union[document_service.UpdateDocumentRequest, dict] = None,
877+
request: Optional[Union[document_service.UpdateDocumentRequest, dict]] = None,
867878
*,
868879
retry: OptionalRetry = gapic_v1.method.DEFAULT,
869-
timeout: float = None,
880+
timeout: Optional[float] = None,
870881
metadata: Sequence[Tuple[str, str]] = (),
871882
) -> document.Document:
872883
r"""Updates a
@@ -952,11 +963,11 @@ def sample_update_document():
952963

953964
def delete_document(
954965
self,
955-
request: Union[document_service.DeleteDocumentRequest, dict] = None,
966+
request: Optional[Union[document_service.DeleteDocumentRequest, dict]] = None,
956967
*,
957-
name: str = None,
968+
name: Optional[str] = None,
958969
retry: OptionalRetry = gapic_v1.method.DEFAULT,
959-
timeout: float = None,
970+
timeout: Optional[float] = None,
960971
metadata: Sequence[Tuple[str, str]] = (),
961972
) -> None:
962973
r"""Deletes a
@@ -1055,10 +1066,10 @@ def sample_delete_document():
10551066

10561067
def import_documents(
10571068
self,
1058-
request: Union[import_config.ImportDocumentsRequest, dict] = None,
1069+
request: Optional[Union[import_config.ImportDocumentsRequest, dict]] = None,
10591070
*,
10601071
retry: OptionalRetry = gapic_v1.method.DEFAULT,
1061-
timeout: float = None,
1072+
timeout: Optional[float] = None,
10621073
metadata: Sequence[Tuple[str, str]] = (),
10631074
) -> operation.Operation:
10641075
r"""Bulk import of multiple
@@ -1177,10 +1188,10 @@ def __exit__(self, type, value, traceback):
11771188

11781189
def list_operations(
11791190
self,
1180-
request: operations_pb2.ListOperationsRequest = None,
1191+
request: Optional[operations_pb2.ListOperationsRequest] = None,
11811192
*,
11821193
retry: OptionalRetry = gapic_v1.method.DEFAULT,
1183-
timeout: float = None,
1194+
timeout: Optional[float] = None,
11841195
metadata: Sequence[Tuple[str, str]] = (),
11851196
) -> operations_pb2.ListOperationsResponse:
11861197
r"""Lists operations that match the specified filter in the request.
@@ -1231,10 +1242,10 @@ def list_operations(
12311242

12321243
def get_operation(
12331244
self,
1234-
request: operations_pb2.GetOperationRequest = None,
1245+
request: Optional[operations_pb2.GetOperationRequest] = None,
12351246
*,
12361247
retry: OptionalRetry = gapic_v1.method.DEFAULT,
1237-
timeout: float = None,
1248+
timeout: Optional[float] = None,
12381249
metadata: Sequence[Tuple[str, str]] = (),
12391250
) -> operations_pb2.Operation:
12401251
r"""Gets the latest state of a long-running operation.

packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1beta/services/document_service/transports/base.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ def __init__(
5252
self,
5353
*,
5454
host: str = DEFAULT_HOST,
55-
credentials: ga_credentials.Credentials = None,
55+
credentials: Optional[ga_credentials.Credentials] = None,
5656
credentials_file: Optional[str] = None,
5757
scopes: Optional[Sequence[str]] = None,
5858
quota_project_id: Optional[str] = None,

0 commit comments

Comments
 (0)