docs: improve docs for GetSpaceRequest, EndActiveConferenceRequest, L…

…istConferenceRecordsRequest (#8051) 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` PiperOrigin-RevId: 720295894 Source-Link: googleapis/googleapis@137b7e6 Source-Link: googleapis/googleapis-gen@f8d8ba2 Copy-Tag: eyJwIjoiQXBwc01lZXQvLk93bEJvdC55YW1sIiwiaCI6ImY4ZDhiYTIxZmQ3ZjAzZjJhYThhNTQwNmRmOGUxOGEzNzkxYmM3MmMifQ== * docs: improve docs for GetSpaceRequest, EndActiveConferenceRequest, ListConferenceRecordsRequest 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: eyJwIjoiQXBwc01lZXQvLk93bEJvdC55YW1sIiwiaCI6ImNiNmQ4NmQyMzUyNjU4YmJmYzU0M2M0NGU0M2U0ZGMzODI3ZmRiMGIifQ==
googleapis · Jan 29, 2025 · 3bda909 · 3bda909
1 parent 40f1a1c
commit 3bda909
Show file tree

Hide file tree

Showing 76 changed files with 3,425 additions and 264 deletions.
diff --git a/AppsMeet/metadata/V2/Service.php b/AppsMeet/metadata/V2/Service.php
diff --git a/AppsMeet/metadata/V2Beta/Resource.php b/AppsMeet/metadata/V2Beta/Resource.php
diff --git a/AppsMeet/metadata/V2Beta/Service.php b/AppsMeet/metadata/V2Beta/Service.php
diff --git a/AppsMeet/samples/V2/SpacesServiceClient/end_active_conference.php b/AppsMeet/samples/V2/SpacesServiceClient/end_active_conference.php
@@ -30,7 +30,18 @@
 /**
  * Ends an active conference (if there's one).
  *
- * @param string $formattedName Resource name of the space. Please see
+ * For an example, see [End active
+ * conference](https://developers.google.com/meet/api/guides/meeting-spaces#end-active-conference).
+ *
+ * @param string $formattedName 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). Please see
  *                              {@see SpacesServiceClient::spaceName()} for help formatting this field.
  */
 function end_active_conference_sample(string $formattedName): void

diff --git a/AppsMeet/samples/V2/SpacesServiceClient/get_space.php b/AppsMeet/samples/V2/SpacesServiceClient/get_space.php
@@ -29,9 +29,30 @@
 use Google\Apps\Meet\V2\Space;
 
 /**
- * Gets a space by `space_id` or `meeting_code`.
+ * Gets details about a meeting space.
  *
- * @param string $formattedName Resource name of the space. Please see
+ * For an example, see [Get a meeting
+ * space](https://developers.google.com/meet/api/guides/meeting-spaces#get-meeting-space).
+ *
+ * @param string $formattedName 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). Please see
  *                              {@see SpacesServiceClient::spaceName()} for help formatting this field.
  */
 function get_space_sample(string $formattedName): void

diff --git a/AppsMeet/samples/V2/SpacesServiceClient/update_space.php b/AppsMeet/samples/V2/SpacesServiceClient/update_space.php
@@ -29,7 +29,10 @@
 use Google\Apps\Meet\V2\UpdateSpaceRequest;
 
 /**
- * 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).
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

diff --git a/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/get_conference_record.php b/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/get_conference_record.php
@@ -29,7 +29,6 @@
 use Google\Apps\Meet\V2beta\GetConferenceRecordRequest;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
  * Gets a conference record by conference ID.
  *
  * @param string $formattedName Resource name of the conference. Please see

diff --git a/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/get_participant.php b/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/get_participant.php
@@ -29,7 +29,6 @@
 use Google\Apps\Meet\V2beta\Participant;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
  * Gets a participant by participant ID.
  *
  * @param string $formattedName Resource name of the participant. Please see

diff --git a/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/get_participant_session.php b/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/get_participant_session.php
@@ -29,7 +29,6 @@
 use Google\Apps\Meet\V2beta\ParticipantSession;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
  * Gets a participant session by participant session ID.
  *
  * @param string $formattedName Resource name of the participant. Please see

diff --git a/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/get_recording.php b/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/get_recording.php
@@ -29,7 +29,6 @@
 use Google\Apps\Meet\V2beta\Recording;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
  * Gets a recording by recording ID.
  *
  * @param string $formattedName Resource name of the recording. Please see

diff --git a/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/get_transcript.php b/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/get_transcript.php
@@ -29,7 +29,6 @@
 use Google\Apps\Meet\V2beta\Transcript;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
  * Gets a transcript by transcript ID.
  *
  * @param string $formattedName Resource name of the transcript. Please see

diff --git a/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/get_transcript_entry.php b/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/get_transcript_entry.php
@@ -29,7 +29,6 @@
 use Google\Apps\Meet\V2beta\TranscriptEntry;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
  * Gets a `TranscriptEntry` resource by entry ID.
  *
  * Note: The transcript entries returned by the Google Meet API might not

diff --git a/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/list_conference_records.php b/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/list_conference_records.php
@@ -30,8 +30,8 @@
 use Google\Apps\Meet\V2beta\ListConferenceRecordsRequest;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
- * Lists the conference records by start time and in descending order.
+ * Lists the conference records. By default, ordered by start time and in
+ * descending order.
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

diff --git a/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/list_participant_sessions.php b/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/list_participant_sessions.php
@@ -30,9 +30,8 @@
 use Google\Apps\Meet\V2beta\ParticipantSession;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
- * Lists the participant sessions of a participant in a conference record, by
- * default ordered by join time and in descending order. This API supports
+ * Lists the participant sessions of a participant in a conference record. By
+ * default, ordered by join time and in descending order. This API supports
  * `fields` as standard parameters like every other API. However, when the
  * `fields` request parameter is omitted this API defaults to
  * `'participantsessions/*, next_page_token'`.

diff --git a/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/list_participants.php b/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/list_participants.php
@@ -30,8 +30,7 @@
 use Google\Apps\Meet\V2beta\Participant;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
- * Lists the participants in a conference record, by default ordered by join
+ * Lists the participants in a conference record. By default, ordered by join
  * time and in descending order. This API supports `fields` as standard
  * parameters like every other API. However, when the `fields` request
  * parameter is omitted, this API defaults to `'participants/*,

diff --git a/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/list_recordings.php b/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/list_recordings.php
@@ -30,8 +30,8 @@
 use Google\Apps\Meet\V2beta\Recording;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
- * Lists the recording resources from the conference record.
+ * Lists the recording resources from the conference record. By default,
+ * ordered by start time and in ascending order.
  *
  * @param string $formattedParent Format: `conferenceRecords/{conference_record}`
  *                                Please see {@see ConferenceRecordsServiceClient::conferenceRecordName()} for help formatting this field.

diff --git a/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/list_transcript_entries.php b/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/list_transcript_entries.php
@@ -30,7 +30,6 @@
 use Google\Apps\Meet\V2beta\TranscriptEntry;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
  * Lists the structured transcript entries per transcript. By default, ordered
  * by start time and in ascending order.
  *

diff --git a/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/list_transcripts.php b/AppsMeet/samples/V2beta/ConferenceRecordsServiceClient/list_transcripts.php
@@ -30,8 +30,8 @@
 use Google\Apps\Meet\V2beta\Transcript;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
- * Lists the set of transcripts from the conference record.
+ * Lists the set of transcripts from the conference record. By default,
+ * ordered by start time and in ascending order.
  *
  * @param string $formattedParent Format: `conferenceRecords/{conference_record}`
  *                                Please see {@see ConferenceRecordsServiceClient::conferenceRecordName()} for help formatting this field.

diff --git a/AppsMeet/samples/V2beta/SpacesServiceClient/create_member.php b/AppsMeet/samples/V2beta/SpacesServiceClient/create_member.php
@@ -0,0 +1,79 @@
+<?php
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START meet_v2beta_generated_SpacesService_CreateMember_sync]
+use Google\ApiCore\ApiException;
+use Google\Apps\Meet\V2beta\Client\SpacesServiceClient;
+use Google\Apps\Meet\V2beta\CreateMemberRequest;
+use Google\Apps\Meet\V2beta\Member;
+
+/**
+ * [Developer Preview](https://developers.google.com/workspace/preview):
+ * Create a member.
+ *
+ * This API supports the `fields` parameter in
+ * [SystemParameterContext](https://cloud.google.com/apis/docs/system-parameters).
+ * When the `fields` parameter is omitted, this API response will default to
+ * "name,email,role,user".
+ *
+ * @param string $formattedParent Format: spaces/{space}
+ *                                Please see {@see SpacesServiceClient::spaceName()} for help formatting this field.
+ */
+function create_member_sample(string $formattedParent): void
+{
+    // Create a client.
+    $spacesServiceClient = new SpacesServiceClient();
+
+    // Prepare the request message.
+    $member = new Member();
+    $request = (new CreateMemberRequest())
+        ->setParent($formattedParent)
+        ->setMember($member);
+
+    // Call the API and handle any network failures.
+    try {
+        /** @var Member $response */
+        $response = $spacesServiceClient->createMember($request);
+        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+
+/**
+ * Helper to execute the sample.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function callSample(): void
+{
+    $formattedParent = SpacesServiceClient::spaceName('[SPACE]');
+
+    create_member_sample($formattedParent);
+}
+// [END meet_v2beta_generated_SpacesService_CreateMember_sync]
diff --git a/AppsMeet/samples/V2beta/SpacesServiceClient/create_space.php b/AppsMeet/samples/V2beta/SpacesServiceClient/create_space.php
@@ -29,7 +29,6 @@
 use Google\Apps\Meet\V2beta\Space;
 
 /**
- * [Developer Preview](https://developers.google.com/workspace/preview).
  * Creates a space.
  *
  * This sample has been automatically generated and should be regarded as a code