العمل باستخدام مساحات للاجتماعات

يوضّح هذا الدليل كيفية إنشاء مساحة اجتماع والحصول عليها وتعديلها بالإضافة إلى إنهاء مكالمة فيديو قيد التقدّم في مورد spaces لواجهة برمجة تطبيقات Google Meet REST.

تمثّل مساحة الاجتماع مكانًا افتراضيًا أو عنصرًا دائمًا (مثل غرفة اجتماعات) يتم فيه عقد المؤتمرات. يمكن عقد اجتماع فيديو نشط واحد فقط في مساحة واحدة في أي وقت. تساعد "مساحة للاجتماعات" أيضًا المستخدمين في الاجتماع والعثور على المراجع المشترَكة.

للتعرّف على كيفية ضبط مساحة اجتماعات آليًا، اطّلِع على مقالة ضبط مساحات الاجتماعات والأعضاء.

يوضّح الجدول التالي تفاصيل أدوار الاجتماع المطلوبة لاستخدام methods فضاء الاجتماع:

الطريقة	المالكون	مشارك	غير ذلك
endActiveConference()	x
get()	x	x	x
مع الإعدادات	x
مع مكالمة فيديو نشطة	x	x
patch()	x

تسمح عملية المصادقة والتفويض باستخدام بيانات اعتماد المستخدِم لتطبيقات Google Meet بالوصول إلى بيانات المستخدِم وتنفيذ العمليات نيابةً عن المستخدِم الذي تمّت المصادقة عليه. تتيح لك المصادقة باستخدام ميزة التفويض على مستوى النطاق تفويض حساب خدمة التطبيق للوصول إلى بيانات المستخدمين بدون طلب موافقة كل مستخدم.

كيفية تحديد Meet لمساحة اجتماع

تُنشئ Google Meet REST API مورد 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

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();

Python

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

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();

Python

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

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();

Python

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

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();

Python

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)

استبدِل قيمة اسم المساحة بمعرّف فريد ينشئه الخادم لمساحة الاجتماع.