docs: [google-apps-meet] improve docs for GetSpaceRequest, EndActiveConferenceRequest, ListConferenceRecordsRequest (#13471)

- [ ] Regenerate this pull request now.

BEGIN_COMMIT_OVERRIDE

docs: improve docs for GetSpaceRequest, EndActiveConferenceRequest,
ListConferenceRecordsRequest
feat: Add methods for configuring meeting spaces and members
(https://developers.google.com/meet/api/guides/beta/configuration-beta)
docs: Improve docs for `GetSpaceRequest`, `EndActiveConferenceRequest`,
`ListConferenceRecordsRequest`
docs: Remove *Developer Preview* label from methods that are now
generally available
feat: Add new OAuth scope
`https://www.googleapis.com/auth/meetings.space.settings` to service
`SpacesService`

END_COMMIT_OVERRIDE


feat: Add new OAuth scope
`https://www.googleapis.com/auth/meetings.space.settings` to service
`SpacesService`

PiperOrigin-RevId: 720567690

Source-Link:
googleapis/googleapis@6dedc05

Source-Link:
googleapis/googleapis-gen@cb6d86d
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWFwcHMtbWVldC8uT3dsQm90LnlhbWwiLCJoIjoiY2I2ZDg2ZDIzNTI2NThiYmZjNTQzYzQ0ZTQzZTRkYzM4MjdmZGIwYiJ9

BEGIN_NESTED_COMMIT
feat: [google-apps-meet] Add methods for [configuring meeting spaces and
members](https://developers.google.com/meet/api/guides/beta/configuration-beta)
docs: Improve docs for `GetSpaceRequest`, `EndActiveConferenceRequest`,
`ListConferenceRecordsRequest`
docs: Remove *Developer Preview* label from methods that are now
generally available
feat: Add new OAuth scope
`https://www.googleapis.com/auth/meetings.space.settings` to service
`SpacesService`

PiperOrigin-RevId: 720295894

Source-Link:
googleapis/googleapis@137b7e6

Source-Link:
googleapis/googleapis-gen@f8d8ba2
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWFwcHMtbWVldC8uT3dsQm90LnlhbWwiLCJoIjoiZjhkOGJhMjFmZDdmMDNmMmFhOGE1NDA2ZGY4ZTE4YTM3OTFiYzcyYyJ9
END_NESTED_COMMIT

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-apps-meet/docs/meet_v2beta/spaces_service.rst

@@ -4,3 +4,7 @@ SpacesService
 .. automodule:: google.apps.meet_v2beta.services.spaces_service
     :members:
     :inherited-members:
+
+.. automodule:: google.apps.meet_v2beta.services.spaces_service.pagers
+    :members:
+    :inherited-members:

packages/google-apps-meet/google/apps/meet/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.1.11"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-apps-meet/google/apps/meet_v2/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.1.11"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-apps-meet/google/apps/meet_v2/services/spaces_service/async_client.py

@@ -403,7 +403,10 @@ async def get_space(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
     ) -> resource.Space:
-        r"""Gets a space by ``space_id`` or ``meeting_code``.
+        r"""Gets details about a meeting space.
+
+        For an example, see `Get a meeting
+        space <https://developers.google.com/meet/api/guides/meeting-spaces#get-meeting-space>`__.
 
         .. code-block:: python
 
@@ -436,6 +439,29 @@ async def sample_get_space():
                 The request object. Request to get a space.
             name (:class:`str`):
                 Required. Resource name of the space.
+
+                Format: ``spaces/{space}`` or ``spaces/{meetingCode}``.
+
+                ``{space}`` is the resource identifier for the space.
+                It's a unique, server-generated ID and is case
+                sensitive. For example, ``jQCFfuBOdN5z``.
+
+                ``{meetingCode}`` is an alias for the space. It's a
+                typeable, unique character string and is non-case
+                sensitive. For example, ``abc-mnop-xyz``. The maximum
+                length is 128 characters.
+
+                A ``meetingCode`` shouldn't be stored long term as it
+                can become dissociated from a meeting space and can be
+                reused for different meeting spaces in the future.
+                Generally, a ``meetingCode`` expires 365 days after last
+                use. For more information, see `Learn about meeting
+                codes in Google
+                Meet <https://support.google.com/meet/answer/10710509>`__.
+
+                For more information, see `How Meet identifies a meeting
+                space <https://developers.google.com/meet/api/guides/meeting-spaces#identify-meeting-space>`__.
+
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -510,7 +536,10 @@ async def update_space(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
     ) -> resource.Space:
-        r"""Updates a space.
+        r"""Updates details about a meeting space.
+
+        For an example, see `Update a meeting
+        space <https://developers.google.com/meet/api/guides/meeting-spaces#update-meeting-space>`__.
 
         .. code-block:: python
 
@@ -547,9 +576,11 @@ async def sample_update_space():
                 should not be set.
             update_mask (:class:`google.protobuf.field_mask_pb2.FieldMask`):
                 Optional. Field mask used to specify the fields to be
-                updated in the space. If update_mask isn't provided, it
-                defaults to '*' and updates all fields provided in the
-                request, including deleting fields not set in the
+                updated in the space. If update_mask isn't provided(not
+                set, set with empty paths, or only has "" as paths), it
+                defaults to update all fields provided with values in
+                the request. Using "*" as update_mask will update all
+                fields, including deleting fields not set in the
                 request.
 
                 This corresponds to the ``update_mask`` field
@@ -631,6 +662,9 @@ async def end_active_conference(
     ) -> None:
         r"""Ends an active conference (if there's one).
 
+        For an example, see `End active
+        conference <https://developers.google.com/meet/api/guides/meeting-spaces#end-active-conference>`__.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a
@@ -660,6 +694,16 @@ async def sample_end_active_conference():
                 of a space.
             name (:class:`str`):
                 Required. Resource name of the space.
+
+                Format: ``spaces/{space}``.
+
+                ``{space}`` is the resource identifier for the space.
+                It's a unique, server-generated ID and is case
+                sensitive. For example, ``jQCFfuBOdN5z``.
+
+                For more information, see `How Meet identifies a meeting
+                space <https://developers.google.com/meet/api/guides/meeting-spaces#identify-meeting-space>`__.
+
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.

packages/google-apps-meet/google/apps/meet_v2/services/spaces_service/client.py

@@ -796,7 +796,10 @@ def get_space(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
     ) -> resource.Space:
-        r"""Gets a space by ``space_id`` or ``meeting_code``.
+        r"""Gets details about a meeting space.
+
+        For an example, see `Get a meeting
+        space <https://developers.google.com/meet/api/guides/meeting-spaces#get-meeting-space>`__.
 
         .. code-block:: python
 
@@ -829,6 +832,29 @@ def sample_get_space():
                 The request object. Request to get a space.
             name (str):
                 Required. Resource name of the space.
+
+                Format: ``spaces/{space}`` or ``spaces/{meetingCode}``.
+
+                ``{space}`` is the resource identifier for the space.
+                It's a unique, server-generated ID and is case
+                sensitive. For example, ``jQCFfuBOdN5z``.
+
+                ``{meetingCode}`` is an alias for the space. It's a
+                typeable, unique character string and is non-case
+                sensitive. For example, ``abc-mnop-xyz``. The maximum
+                length is 128 characters.
+
+                A ``meetingCode`` shouldn't be stored long term as it
+                can become dissociated from a meeting space and can be
+                reused for different meeting spaces in the future.
+                Generally, a ``meetingCode`` expires 365 days after last
+                use. For more information, see `Learn about meeting
+                codes in Google
+                Meet <https://support.google.com/meet/answer/10710509>`__.
+
+                For more information, see `How Meet identifies a meeting
+                space <https://developers.google.com/meet/api/guides/meeting-spaces#identify-meeting-space>`__.
+
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -900,7 +926,10 @@ def update_space(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
     ) -> resource.Space:
-        r"""Updates a space.
+        r"""Updates details about a meeting space.
+
+        For an example, see `Update a meeting
+        space <https://developers.google.com/meet/api/guides/meeting-spaces#update-meeting-space>`__.
 
         .. code-block:: python
 
@@ -937,9 +966,11 @@ def sample_update_space():
                 should not be set.
             update_mask (google.protobuf.field_mask_pb2.FieldMask):
                 Optional. Field mask used to specify the fields to be
-                updated in the space. If update_mask isn't provided, it
-                defaults to '*' and updates all fields provided in the
-                request, including deleting fields not set in the
+                updated in the space. If update_mask isn't provided(not
+                set, set with empty paths, or only has "" as paths), it
+                defaults to update all fields provided with values in
+                the request. Using "*" as update_mask will update all
+                fields, including deleting fields not set in the
                 request.
 
                 This corresponds to the ``update_mask`` field
@@ -1018,6 +1049,9 @@ def end_active_conference(
     ) -> None:
         r"""Ends an active conference (if there's one).
 
+        For an example, see `End active
+        conference <https://developers.google.com/meet/api/guides/meeting-spaces#end-active-conference>`__.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a
@@ -1047,6 +1081,16 @@ def sample_end_active_conference():
                 of a space.
             name (str):
                 Required. Resource name of the space.
+
+                Format: ``spaces/{space}``.
+
+                ``{space}`` is the resource identifier for the space.
+                It's a unique, server-generated ID and is case
+                sensitive. For example, ``jQCFfuBOdN5z``.
+
+                For more information, see `How Meet identifies a meeting
+                space <https://developers.google.com/meet/api/guides/meeting-spaces#identify-meeting-space>`__.
+
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.

packages/google-apps-meet/google/apps/meet_v2/services/spaces_service/transports/base.py

@@ -39,6 +39,7 @@ class SpacesServiceTransport(abc.ABC):
     AUTH_SCOPES = (
         "https://www.googleapis.com/auth/meetings.space.created",
         "https://www.googleapis.com/auth/meetings.space.readonly",
+        "https://www.googleapis.com/auth/meetings.space.settings",
     )
 
     DEFAULT_HOST: str = "meet.googleapis.com"

packages/google-apps-meet/google/apps/meet_v2/services/spaces_service/transports/grpc.py

@@ -349,7 +349,10 @@ def create_space(self) -> Callable[[service.CreateSpaceRequest], resource.Space]
     def get_space(self) -> Callable[[service.GetSpaceRequest], resource.Space]:
         r"""Return a callable for the get space method over gRPC.
 
-        Gets a space by ``space_id`` or ``meeting_code``.
+        Gets details about a meeting space.
+
+        For an example, see `Get a meeting
+        space <https://developers.google.com/meet/api/guides/meeting-spaces#get-meeting-space>`__.
 
         Returns:
             Callable[[~.GetSpaceRequest],
@@ -373,7 +376,10 @@ def get_space(self) -> Callable[[service.GetSpaceRequest], resource.Space]:
     def update_space(self) -> Callable[[service.UpdateSpaceRequest], resource.Space]:
         r"""Return a callable for the update space method over gRPC.
 
-        Updates a space.
+        Updates details about a meeting space.
+
+        For an example, see `Update a meeting
+        space <https://developers.google.com/meet/api/guides/meeting-spaces#update-meeting-space>`__.
 
         Returns:
             Callable[[~.UpdateSpaceRequest],
@@ -401,6 +407,9 @@ def end_active_conference(
 
         Ends an active conference (if there's one).
 
+        For an example, see `End active
+        conference <https://developers.google.com/meet/api/guides/meeting-spaces#end-active-conference>`__.
+
         Returns:
             Callable[[~.EndActiveConferenceRequest],
                     ~.Empty]:

packages/google-apps-meet/google/apps/meet_v2/services/spaces_service/transports/grpc_asyncio.py

@@ -360,7 +360,10 @@ def get_space(
     ) -> Callable[[service.GetSpaceRequest], Awaitable[resource.Space]]:
         r"""Return a callable for the get space method over gRPC.
 
-        Gets a space by ``space_id`` or ``meeting_code``.
+        Gets details about a meeting space.
+
+        For an example, see `Get a meeting
+        space <https://developers.google.com/meet/api/guides/meeting-spaces#get-meeting-space>`__.
 
         Returns:
             Callable[[~.GetSpaceRequest],
@@ -386,7 +389,10 @@ def update_space(
     ) -> Callable[[service.UpdateSpaceRequest], Awaitable[resource.Space]]:
         r"""Return a callable for the update space method over gRPC.
 
-        Updates a space.
+        Updates details about a meeting space.
+
+        For an example, see `Update a meeting
+        space <https://developers.google.com/meet/api/guides/meeting-spaces#update-meeting-space>`__.
 
         Returns:
             Callable[[~.UpdateSpaceRequest],
@@ -414,6 +420,9 @@ def end_active_conference(
 
         Ends an active conference (if there's one).
 
+        For an example, see `End active
+        conference <https://developers.google.com/meet/api/guides/meeting-spaces#end-active-conference>`__.
+
         Returns:
             Callable[[~.EndActiveConferenceRequest],
                     Awaitable[~.Empty]]:

packages/google-apps-meet/google/apps/meet_v2/types/resource.py

@@ -47,16 +47,32 @@ class Space(proto.Message):
 
     Attributes:
         name (str):
-            Immutable. Resource name of the space. Format:
-            ``spaces/{space}``
+            Immutable. Resource name of the space.
+
+            Format: ``spaces/{space}``.
+
+            ``{space}`` is the resource identifier for the space. It's a
+            unique, server-generated ID and is case sensitive. For
+            example, ``jQCFfuBOdN5z``.
+
+            For more information, see `How Meet identifies a meeting
+            space <https://developers.google.com/meet/api/guides/meeting-spaces#identify-meeting-space>`__.
         meeting_uri (str):
-            Output only. URI used to join meetings, such as
+            Output only. URI used to join meetings consisting of
+            ``https://meet.google.com/`` followed by the
+            ``meeting_code``. For example,
             ``https://meet.google.com/abc-mnop-xyz``.
         meeting_code (str):
-            Output only. Type friendly code to join the meeting. Format:
-            ``[a-z]+-[a-z]+-[a-z]+`` such as ``abc-mnop-xyz``. The
-            maximum length is 128 characters. Can only be used as an
-            alias of the space ID to get the space.
+            Output only. Type friendly unique string used to join the
+            meeting.
+
+            Format: ``[a-z]+-[a-z]+-[a-z]+``. For example,
+            ``abc-mnop-xyz``.
+
+            The maximum length is 128 characters.
+
+            Can only be used as an alias of the space name to get the
+            space.
         config (google.apps.meet_v2.types.SpaceConfig):
             Configuration pertaining to the meeting
             space.