Skip to content

Commit 0ed8657

Browse files
ohmayrohmayr
committed
rst diff
1 parent 34efb39 commit 0ed8657

File tree

982 files changed

+23164
-17095
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

982 files changed

+23164
-17095
lines changed

‎packages/google-cloud-discoveryengine/google/cloud/discoveryengine/gapic_version.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,4 +13,4 @@
1313
# See the License for the specific language governing permissions and
1414
# limitations under the License.
1515
#
16-
__version__ = "0.15.0" # {x-release-please-version}
16+
__version__ = "0.4.0" # {x-release-please-version}

‎packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/gapic_version.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,4 +13,4 @@
1313
# See the License for the specific language governing permissions and
1414
# limitations under the License.
1515
#
16-
__version__ = "0.15.0" # {x-release-please-version}
16+
__version__ = "0.4.0" # {x-release-please-version}

‎packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/services/assistant_service/async_client.py‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -345,7 +345,8 @@ async def sample_stream_assist():
345345
Args:
346346
request (Optional[Union[google.cloud.discoveryengine_v1.types.StreamAssistRequest, dict]]):
347347
The request object. Request for the
348-
[AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
348+
`AssistantService.StreamAssist
349+
<google.cloud.discoveryengine.v1.AssistantService.StreamAssist>`__
349350
method.
350351
retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any,
351352
should be retried.
@@ -358,8 +359,9 @@ async def sample_stream_assist():
358359
Returns:
359360
AsyncIterable[google.cloud.discoveryengine_v1.types.StreamAssistResponse]:
360361
Response for the
361-
[AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
362-
method.
362+
`AssistantService.StreamAssist
363+
<google.cloud.discoveryengine.v1.AssistantService.StreamAssist>`__
364+
method.
363365
364366
"""
365367
# Create or coerce a protobuf request object.

‎packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/services/assistant_service/client.py‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -862,7 +862,8 @@ def sample_stream_assist():
862862
Args:
863863
request (Union[google.cloud.discoveryengine_v1.types.StreamAssistRequest, dict]):
864864
The request object. Request for the
865-
[AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
865+
`AssistantService.StreamAssist
866+
<google.cloud.discoveryengine.v1.AssistantService.StreamAssist>`__
866867
method.
867868
retry (google.api_core.retry.Retry): Designation of what errors, if any,
868869
should be retried.
@@ -875,8 +876,9 @@ def sample_stream_assist():
875876
Returns:
876877
Iterable[google.cloud.discoveryengine_v1.types.StreamAssistResponse]:
877878
Response for the
878-
[AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
879-
method.
879+
`AssistantService.StreamAssist
880+
<google.cloud.discoveryengine.v1.AssistantService.StreamAssist>`__
881+
method.
880882
881883
"""
882884
# Create or coerce a protobuf request object.

‎packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/services/assistant_service/transports/rest.py‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -343,7 +343,8 @@ def __call__(
343343
Args:
344344
request (~.assistant_service.StreamAssistRequest):
345345
The request object. Request for the
346-
[AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
346+
`AssistantService.StreamAssist
347+
<google.cloud.discoveryengine.v1.AssistantService.StreamAssist>`__
347348
method.
348349
retry (google.api_core.retry.Retry): Designation of what errors, if any,
349350
should be retried.
@@ -356,7 +357,8 @@ def __call__(
356357
Returns:
357358
~.assistant_service.StreamAssistResponse:
358359
Response for the
359-
[AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
360+
`AssistantService.StreamAssist
361+
<google.cloud.discoveryengine.v1.AssistantService.StreamAssist>`__
360362
method.
361363
362364
"""

‎packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/services/cmek_config_service/async_client.py‎

Lines changed: 51 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -379,12 +379,13 @@ async def sample_update_cmek_config():
379379
380380
Returns:
381381
google.api_core.operation_async.AsyncOperation:
382-
An object representing a long-running operation.
383-
384-
The result type for the operation will be
382+
An object representing a long-running
383+
operation.
384+
The result type for the operation will
385+
be
385386
:class:`google.cloud.discoveryengine_v1.types.CmekConfig`
386-
Configurations used to enable CMEK data encryption with
387-
Cloud KMS keys.
387+
Configurations used to enable CMEK data
388+
encryption with Cloud KMS keys.
388389
389390
"""
390391
# Create or coerce a protobuf request object.
@@ -455,8 +456,8 @@ async def get_cmek_config(
455456
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
456457
metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
457458
) -> cmek_config_service.CmekConfig:
458-
r"""Gets the
459-
[CmekConfig][google.cloud.discoveryengine.v1.CmekConfig].
459+
r"""Gets the `CmekConfig
460+
<google.cloud.discoveryengine.v1.CmekConfig>`__.
460461
461462
.. code-block:: python
462463
@@ -490,14 +491,17 @@ async def sample_get_cmek_config():
490491
GetCmekConfigRequest method.
491492
name (:class:`str`):
492493
Required. Resource name of
493-
[CmekConfig][google.cloud.discoveryengine.v1.CmekConfig],
494-
such as ``projects/*/locations/*/cmekConfig`` or
494+
`CmekConfig
495+
<google.cloud.discoveryengine.v1.CmekConfig>`__,
496+
such as
497+
``projects/*/locations/*/cmekConfig`` or
495498
``projects/*/locations/*/cmekConfigs/*``.
496499
497-
If the caller does not have permission to access the
498-
[CmekConfig][google.cloud.discoveryengine.v1.CmekConfig],
499-
regardless of whether or not it exists, a
500-
PERMISSION_DENIED error is returned.
500+
If the caller does not have permission
501+
to access the `CmekConfig
502+
<google.cloud.discoveryengine.v1.CmekConfig>`__,
503+
regardless of whether or not it exists,
504+
a PERMISSION_DENIED error is returned.
501505
502506
This corresponds to the ``name`` field
503507
on the ``request`` instance; if ``request`` is provided, this
@@ -576,8 +580,8 @@ async def list_cmek_configs(
576580
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
577581
metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
578582
) -> cmek_config_service.ListCmekConfigsResponse:
579-
r"""Lists all the
580-
[CmekConfig][google.cloud.discoveryengine.v1.CmekConfig]s with
583+
r"""Lists all the `CmekConfig
584+
<google.cloud.discoveryengine.v1.CmekConfig>`__s with
581585
the project.
582586
583587
.. code-block:: python
@@ -609,17 +613,20 @@ async def sample_list_cmek_configs():
609613
Args:
610614
request (Optional[Union[google.cloud.discoveryengine_v1.types.ListCmekConfigsRequest, dict]]):
611615
The request object. Request message for
612-
[CmekConfigService.ListCmekConfigs][google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs]
616+
`CmekConfigService.ListCmekConfigs
617+
<google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs>`__
613618
method.
614619
parent (:class:`str`):
615-
Required. The parent location resource name, such as
620+
Required. The parent location resource
621+
name, such as
616622
``projects/{project}/locations/{location}``.
617623
618-
If the caller does not have permission to list
619-
[CmekConfig][google.cloud.discoveryengine.v1.CmekConfig]s
620-
under this location, regardless of whether or not a
621-
CmekConfig exists, a PERMISSION_DENIED error is
622-
returned.
624+
If the caller does not have permission
625+
to list `CmekConfig
626+
<google.cloud.discoveryengine.v1.CmekConfig>`__s
627+
under this location, regardless of
628+
whether or not a CmekConfig exists, a
629+
PERMISSION_DENIED error is returned.
623630
624631
This corresponds to the ``parent`` field
625632
on the ``request`` instance; if ``request`` is provided, this
@@ -635,8 +642,9 @@ async def sample_list_cmek_configs():
635642
Returns:
636643
google.cloud.discoveryengine_v1.types.ListCmekConfigsResponse:
637644
Response message for
638-
[CmekConfigService.ListCmekConfigs][google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs]
639-
method.
645+
`CmekConfigService.ListCmekConfigs
646+
<google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs>`__
647+
method.
640648
641649
"""
642650
# Create or coerce a protobuf request object.
@@ -734,11 +742,13 @@ async def sample_delete_cmek_config():
734742
Args:
735743
request (Optional[Union[google.cloud.discoveryengine_v1.types.DeleteCmekConfigRequest, dict]]):
736744
The request object. Request message for
737-
[CmekConfigService.DeleteCmekConfig][google.cloud.discoveryengine.v1.CmekConfigService.DeleteCmekConfig]
745+
`CmekConfigService.DeleteCmekConfig
746+
<google.cloud.discoveryengine.v1.CmekConfigService.DeleteCmekConfig>`__
738747
method.
739748
name (:class:`str`):
740749
Required. The resource name of the
741-
[CmekConfig][google.cloud.discoveryengine.v1.CmekConfig]
750+
`CmekConfig
751+
<google.cloud.discoveryengine.v1.CmekConfig>`__
742752
to delete, such as
743753
``projects/{project}/locations/{location}/cmekConfigs/{cmek_config}``.
744754
@@ -755,18 +765,21 @@ async def sample_delete_cmek_config():
755765
756766
Returns:
757767
google.api_core.operation_async.AsyncOperation:
758-
An object representing a long-running operation.
759-
760-
The result type for the operation will be :class:`google.protobuf.empty_pb2.Empty` A generic empty message that you can re-use to avoid defining duplicated
761-
empty messages in your APIs. A typical example is to
762-
use it as the request or the response type of an API
763-
method. For instance:
764-
765-
service Foo {
766-
rpc Bar(google.protobuf.Empty) returns
767-
(google.protobuf.Empty);
768-
769-
}
768+
An object representing a long-running
769+
operation.
770+
The result type for the operation will
771+
be
772+
:class:`google.protobuf.empty_pb2.Empty`
773+
A generic empty message that you can
774+
re-use to avoid defining duplicated
775+
empty messages in your APIs. A typical
776+
example is to use it as the request or
777+
the response type of an API method. For
778+
instance:
779+
780+
service Foo {
781+
rpc Bar(google.protobuf.Empty)
782+
returns (google.protobuf.Empty); }
770783
771784
"""
772785
# Create or coerce a protobuf request object.

‎packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/services/cmek_config_service/client.py‎

Lines changed: 51 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -853,12 +853,13 @@ def sample_update_cmek_config():
853853
854854
Returns:
855855
google.api_core.operation.Operation:
856-
An object representing a long-running operation.
857-
858-
The result type for the operation will be
856+
An object representing a long-running
857+
operation.
858+
The result type for the operation will
859+
be
859860
:class:`google.cloud.discoveryengine_v1.types.CmekConfig`
860-
Configurations used to enable CMEK data encryption with
861-
Cloud KMS keys.
861+
Configurations used to enable CMEK data
862+
encryption with Cloud KMS keys.
862863
863864
"""
864865
# Create or coerce a protobuf request object.
@@ -926,8 +927,8 @@ def get_cmek_config(
926927
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
927928
metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
928929
) -> cmek_config_service.CmekConfig:
929-
r"""Gets the
930-
[CmekConfig][google.cloud.discoveryengine.v1.CmekConfig].
930+
r"""Gets the `CmekConfig
931+
<google.cloud.discoveryengine.v1.CmekConfig>`__.
931932
932933
.. code-block:: python
933934
@@ -961,14 +962,17 @@ def sample_get_cmek_config():
961962
GetCmekConfigRequest method.
962963
name (str):
963964
Required. Resource name of
964-
[CmekConfig][google.cloud.discoveryengine.v1.CmekConfig],
965-
such as ``projects/*/locations/*/cmekConfig`` or
965+
`CmekConfig
966+
<google.cloud.discoveryengine.v1.CmekConfig>`__,
967+
such as
968+
``projects/*/locations/*/cmekConfig`` or
966969
``projects/*/locations/*/cmekConfigs/*``.
967970
968-
If the caller does not have permission to access the
969-
[CmekConfig][google.cloud.discoveryengine.v1.CmekConfig],
970-
regardless of whether or not it exists, a
971-
PERMISSION_DENIED error is returned.
971+
If the caller does not have permission
972+
to access the `CmekConfig
973+
<google.cloud.discoveryengine.v1.CmekConfig>`__,
974+
regardless of whether or not it exists,
975+
a PERMISSION_DENIED error is returned.
972976
973977
This corresponds to the ``name`` field
974978
on the ``request`` instance; if ``request`` is provided, this
@@ -1044,8 +1048,8 @@ def list_cmek_configs(
10441048
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
10451049
metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
10461050
) -> cmek_config_service.ListCmekConfigsResponse:
1047-
r"""Lists all the
1048-
[CmekConfig][google.cloud.discoveryengine.v1.CmekConfig]s with
1051+
r"""Lists all the `CmekConfig
1052+
<google.cloud.discoveryengine.v1.CmekConfig>`__s with
10491053
the project.
10501054
10511055
.. code-block:: python
@@ -1077,17 +1081,20 @@ def sample_list_cmek_configs():
10771081
Args:
10781082
request (Union[google.cloud.discoveryengine_v1.types.ListCmekConfigsRequest, dict]):
10791083
The request object. Request message for
1080-
[CmekConfigService.ListCmekConfigs][google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs]
1084+
`CmekConfigService.ListCmekConfigs
1085+
<google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs>`__
10811086
method.
10821087
parent (str):
1083-
Required. The parent location resource name, such as
1088+
Required. The parent location resource
1089+
name, such as
10841090
``projects/{project}/locations/{location}``.
10851091
1086-
If the caller does not have permission to list
1087-
[CmekConfig][google.cloud.discoveryengine.v1.CmekConfig]s
1088-
under this location, regardless of whether or not a
1089-
CmekConfig exists, a PERMISSION_DENIED error is
1090-
returned.
1092+
If the caller does not have permission
1093+
to list `CmekConfig
1094+
<google.cloud.discoveryengine.v1.CmekConfig>`__s
1095+
under this location, regardless of
1096+
whether or not a CmekConfig exists, a
1097+
PERMISSION_DENIED error is returned.
10911098
10921099
This corresponds to the ``parent`` field
10931100
on the ``request`` instance; if ``request`` is provided, this
@@ -1103,8 +1110,9 @@ def sample_list_cmek_configs():
11031110
Returns:
11041111
google.cloud.discoveryengine_v1.types.ListCmekConfigsResponse:
11051112
Response message for
1106-
[CmekConfigService.ListCmekConfigs][google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs]
1107-
method.
1113+
`CmekConfigService.ListCmekConfigs
1114+
<google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs>`__
1115+
method.
11081116
11091117
"""
11101118
# Create or coerce a protobuf request object.
@@ -1199,11 +1207,13 @@ def sample_delete_cmek_config():
11991207
Args:
12001208
request (Union[google.cloud.discoveryengine_v1.types.DeleteCmekConfigRequest, dict]):
12011209
The request object. Request message for
1202-
[CmekConfigService.DeleteCmekConfig][google.cloud.discoveryengine.v1.CmekConfigService.DeleteCmekConfig]
1210+
`CmekConfigService.DeleteCmekConfig
1211+
<google.cloud.discoveryengine.v1.CmekConfigService.DeleteCmekConfig>`__
12031212
method.
12041213
name (str):
12051214
Required. The resource name of the
1206-
[CmekConfig][google.cloud.discoveryengine.v1.CmekConfig]
1215+
`CmekConfig
1216+
<google.cloud.discoveryengine.v1.CmekConfig>`__
12071217
to delete, such as
12081218
``projects/{project}/locations/{location}/cmekConfigs/{cmek_config}``.
12091219
@@ -1220,18 +1230,21 @@ def sample_delete_cmek_config():
12201230
12211231
Returns:
12221232
google.api_core.operation.Operation:
1223-
An object representing a long-running operation.
1224-
1225-
The result type for the operation will be :class:`google.protobuf.empty_pb2.Empty` A generic empty message that you can re-use to avoid defining duplicated
1226-
empty messages in your APIs. A typical example is to
1227-
use it as the request or the response type of an API
1228-
method. For instance:
1229-
1230-
service Foo {
1231-
rpc Bar(google.protobuf.Empty) returns
1232-
(google.protobuf.Empty);
1233-
1234-
}
1233+
An object representing a long-running
1234+
operation.
1235+
The result type for the operation will
1236+
be
1237+
:class:`google.protobuf.empty_pb2.Empty`
1238+
A generic empty message that you can
1239+
re-use to avoid defining duplicated
1240+
empty messages in your APIs. A typical
1241+
example is to use it as the request or
1242+
the response type of an API method. For
1243+
instance:
1244+
1245+
service Foo {
1246+
rpc Bar(google.protobuf.Empty)
1247+
returns (google.protobuf.Empty); }
12351248
12361249
"""
12371250
# Create or coerce a protobuf request object.

0 commit comments

Comments
 (0)