Работа с конференц-залами

В этом руководстве объясняется, как создать, получить и обновить пространство для собраний, а также завершить активную конференцию на ресурсе spaces Google Meet REST API.

Пространство для собраний представляет собой виртуальное место или постоянный объект (например, комнату для собраний), где проводятся конференции. В одном пространстве одновременно можно проводить только одну активную конференцию. Пространство для встреч также помогает пользователям встречаться и находить общие ресурсы.

Чтобы узнать, как программно настроить пространство для собраний, см. раздел Настройка пространств для собраний и участников .

В следующей таблице подробно описаны роли на собрании, необходимые для использования методов пространства для собраний:

Метод	Владельцы	Участники	Другие
endActiveConference()	х
get()	х	х	х
с настройками	х
с активной конференцией	х	х
patch()	х

Аутентификация и авторизация с использованием учетных данных пользователя позволяет приложениям Google Meet получать доступ к пользовательским данным и выполнять операции от имени аутентифицированного пользователя. Аутентификация с делегированием на уровне домена позволяет вам авторизовать учетную запись службы приложения для доступа к данным ваших пользователей, не требуя согласия каждого пользователя.

Как Meet определяет место для встреч

API REST Google Meet создает ресурс spaces для каждого пространства встреч. Поле name — это имя ресурса.

Ниже приведены два важных способа определения места встречи с помощью поля name :

• space — это идентификатор ресурса для пространства, отформатированный как spaces/{space} . Это уникальный идентификатор, сгенерированный сервером, чувствительный к регистру. Например, spaces/jQCFfuBOdN5z .

• meetingCode — это псевдоним пространства в формате spaces/{meetingCode} . Это типизированная уникальная строка символов, не чувствительная к регистру. Например, abc-mnop-xyz . Максимальная длина — 128 символов. Он является частью meetingUri : https://meet.google.com/abc-mnop-xyz .

  Примечание. Код meetingCode не следует хранить в течение длительного времени, так как он может быть отделен от места встречи и может быть повторно использован для других мест встречи в будущем. Как правило, срок действия meetingCode истекает через 365 дней после последнего использования. Дополнительную информацию см. в статье «Информация о кодах встреч в Google Meet» .

Чтобы управлять пространством для встреч, используйте следующие значения для поля {name} :

• Чтобы получить подробную информацию о пространстве для собраний, вы можете использовать spaces/{space} или псевдоним spaces/{meetingCode} . Дополнительную информацию см. в разделе «Получение места для собраний» .

• Чтобы обновить сведения о месте встречи, вы можете использовать только spaces/{space} . Дополнительные сведения см. в разделе Обновление места встречи .

• Чтобы завершить активную конференцию в конференц-зале, вы можете использовать только spaces/{space} . Дополнительную информацию см. в разделе Завершить активную конференцию .

Создайте место для встреч

Чтобы создать пространство для встреч , используйте метод create() ресурса spaces .

Метод возвращает экземпляр ресурса spaces , который включает объект SpaceConfig , который является конфигурацией пространства для собраний. Он также содержит объект ActiveConference , который является ссылкой на текущий ресурс conferenceRecords в пространстве собрания.

В следующем примере кода показано, как создать пространство для собраний:

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/spacesservice/createspace/AsyncCreateSpace.java

Посмотреть на GitHub

import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.CreateSpaceRequest;
import com.google.apps.meet.v2.Space;
import com.google.apps.meet.v2.SpacesServiceClient;

public class AsyncCreateSpace {

  public static void main(String[] args) throws Exception {
    asyncCreateSpace();
  }

  public static void asyncCreateSpace() throws Exception {
    // This snippet 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 as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (SpacesServiceClient spacesServiceClient = SpacesServiceClient.create()) {
      CreateSpaceRequest request =
          CreateSpaceRequest.newBuilder().setSpace(Space.newBuilder().build()).build();
      ApiFuture<Space> future = spacesServiceClient.createSpaceCallable().futureCall(request);
      // Do something.
      Space response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/spaces_service.create_space.js

Посмотреть на GitHub

/**
 * This snippet 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.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Space to be created. As of May 2023, the input space can be empty. Later on
 *  the input space can be non-empty when space configuration is introduced.
 */
// const space = {}

// Imports the Meet library
const {SpacesServiceClient} = require('@google-apps/meet').v2;

// Instantiates a client
const meetClient = new SpacesServiceClient();

async function callCreateSpace() {
  // Construct request
  const request = {
  };

  // Run request
  const response = await meetClient.createSpace(request);
  console.log(response);
}

callCreateSpace();

Питон

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_spaces_service_create_space_async.py

Посмотреть на GitHub

# This snippet 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 as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_create_space():
    # Create a client
    client = meet_v2.SpacesServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.CreateSpaceRequest(
    )

    # Make the request
    response = await client.create_space(request=request)

    # Handle the response
    print(response)

Получите подробную информацию о помещении для встреч

Чтобы получить подробную информацию об активном пространстве для встреч и его настройках, используйте метод get() ресурса spaces с указанным name . Дополнительную информацию см. в разделе «Как Meet определяет место для встреч» .

Метод возвращает место для встреч как экземпляр ресурса spaces .

В следующем примере кода показано, как получить место для собраний:

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/spacesservice/getspace/AsyncGetSpace.java

Посмотреть на GitHub

import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.GetSpaceRequest;
import com.google.apps.meet.v2.Space;
import com.google.apps.meet.v2.SpaceName;
import com.google.apps.meet.v2.SpacesServiceClient;

public class AsyncGetSpace {

  public static void main(String[] args) throws Exception {
    asyncGetSpace();
  }

  public static void asyncGetSpace() throws Exception {
    // This snippet 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 as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (SpacesServiceClient spacesServiceClient = SpacesServiceClient.create()) {
      GetSpaceRequest request =
          GetSpaceRequest.newBuilder().setName(SpaceName.of("[SPACE]").toString()).build();
      ApiFuture<Space> future = spacesServiceClient.getSpaceCallable().futureCall(request);
      // Do something.
      Space response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/spaces_service.get_space.js

Посмотреть на GitHub

/**
 * This snippet 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.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  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).
 */
// const name = 'abc123'

// Imports the Meet library
const {SpacesServiceClient} = require('@google-apps/meet').v2;

// Instantiates a client
const meetClient = new SpacesServiceClient();

async function callGetSpace() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const response = await meetClient.getSpace(request);
  console.log(response);
}

callGetSpace();

Питон

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_spaces_service_get_space_async.py

Посмотреть на GitHub

# This snippet 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 as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_get_space():
    # Create a client
    client = meet_v2.SpacesServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.GetSpaceRequest(
        name="name_value",
    )

    # Make the request
    response = await client.get_space(request=request)

    # Handle the response
    print(response)

Замените значение имени пространства уникальным идентификатором пространства для собраний, созданным сервером.

Обновите место встречи

Чтобы обновить сведения о пространстве для собраний, используйте метод patch() для ресурса spaces с указанным name . Дополнительную информацию см. в разделе «Как Meet определяет место для встреч» .

Метод patch() также принимает необязательный параметр запроса updateMask . Поле имеет тип FieldMask . Это список полей, разделенных запятыми, которые вы хотите обновить в пространстве.

Метод возвращает место для встреч как экземпляр ресурса spaces .

В следующем примере кода показано, как обновить пространство для собраний:

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/spacesservice/updatespace/AsyncUpdateSpace.java

Посмотреть на GitHub

import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.Space;
import com.google.apps.meet.v2.SpacesServiceClient;
import com.google.apps.meet.v2.UpdateSpaceRequest;
import com.google.protobuf.FieldMask;

public class AsyncUpdateSpace {

  public static void main(String[] args) throws Exception {
    asyncUpdateSpace();
  }

  public static void asyncUpdateSpace() throws Exception {
    // This snippet 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 as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (SpacesServiceClient spacesServiceClient = SpacesServiceClient.create()) {
      UpdateSpaceRequest request =
          UpdateSpaceRequest.newBuilder()
              .setSpace(Space.newBuilder().build())
              .setUpdateMask(FieldMask.newBuilder().build())
              .build();
      ApiFuture<Space> future = spacesServiceClient.updateSpaceCallable().futureCall(request);
      // Do something.
      Space response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/spaces_service.update_space.js

Посмотреть на GitHub

/**
 * This snippet 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.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Space to be updated.
 */
// const space = {}
/**
 *  Optional. Field mask used to specify the fields to be 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.
 */
// const updateMask = {}

// Imports the Meet library
const {SpacesServiceClient} = require('@google-apps/meet').v2;

// Instantiates a client
const meetClient = new SpacesServiceClient();

async function callUpdateSpace() {
  // Construct request
  const request = {
    space,
  };

  // Run request
  const response = await meetClient.updateSpace(request);
  console.log(response);
}

callUpdateSpace();

Питон

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_spaces_service_update_space_async.py

Посмотреть на GitHub

# This snippet 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 as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_update_space():
    # Create a client
    client = meet_v2.SpacesServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.UpdateSpaceRequest(
    )

    # Make the request
    response = await client.update_space(request=request)

    # Handle the response
    print(response)

Замените значение имени пространства уникальным идентификатором пространства для собраний, созданным сервером.

Завершить активную конференцию

Чтобы завершить активную конференцию в помещении для собраний (если оно есть), используйте метод endActiveConference() для ресурса spaces . Тело запроса и ответа пусто. Дополнительную информацию см. в разделе «Как Meet определяет место для встреч» .

В следующем примере кода показано, как завершить активную конференцию:

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/spacesservice/endactiveconference/AsyncEndActiveConference.java

Посмотреть на GitHub

import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.EndActiveConferenceRequest;
import com.google.apps.meet.v2.SpaceName;
import com.google.apps.meet.v2.SpacesServiceClient;
import com.google.protobuf.Empty;

public class AsyncEndActiveConference {

  public static void main(String[] args) throws Exception {
    asyncEndActiveConference();
  }

  public static void asyncEndActiveConference() throws Exception {
    // This snippet 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 as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (SpacesServiceClient spacesServiceClient = SpacesServiceClient.create()) {
      EndActiveConferenceRequest request =
          EndActiveConferenceRequest.newBuilder()
              .setName(SpaceName.of("[SPACE]").toString())
              .build();
      ApiFuture<Empty> future =
          spacesServiceClient.endActiveConferenceCallable().futureCall(request);
      // Do something.
      future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/spaces_service.end_active_conference.js

Посмотреть на GitHub

/**
 * This snippet 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.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  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).
 */
// const name = 'abc123'

// Imports the Meet library
const {SpacesServiceClient} = require('@google-apps/meet').v2;

// Instantiates a client
const meetClient = new SpacesServiceClient();

async function callEndActiveConference() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const response = await meetClient.endActiveConference(request);
  console.log(response);
}

callEndActiveConference();

Питон

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_spaces_service_end_active_conference_async.py

Посмотреть на GitHub

# This snippet 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 as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_end_active_conference():
    # Create a client
    client = meet_v2.SpacesServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.EndActiveConferenceRequest(
        name="name_value",
    )

    # Make the request
    await client.end_active_conference(request=request)

Замените значение имени пространства уникальным идентификатором пространства для собраний, созданным сервером.