با فضاهای ملاقات کار کنید

Google Meet REST API تصویرسازی

فضای جلسه نشان دهنده یک مکان مجازی یا یک شی ثابت (مانند اتاق جلسه) است که در آن کنفرانس ها برگزار می شود. تنها یک کنفرانس فعال در هر زمان می تواند در یک مکان برگزار شود. فضای جلسه همچنین به کاربران کمک می کند تا منابع مشترک را پیدا کنند.

بخش‌های زیر نحوه ایجاد، دریافت و به‌روزرسانی فضای جلسه را شرح می‌دهد.

چگونه 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 .

برای مدیریت فضای جلسه، از مقادیر زیر برای فیلد {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
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
/**
 * 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
# 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 چگونه یک فضای جلسه را شناسایی می‌کند .

این روش یک فضای جلسه را به عنوان نمونه ای از منبع space برمی گرداند.

نمونه کد زیر نحوه بازیابی فضای جلسه را نشان می دهد:

جاوا

java-meet/samples/snippets/generated/com/google/apps/meet/v2/spacesservice/getspace/AsyncGetSpace.java
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
/**
 * 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.
 */
// 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
# 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
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
/**
 * 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, it defaults to '*' and updates all
 *  fields provided in the request, 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
# 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)

نام فضا را با شناسه منحصر به فرد ایجاد شده توسط سرور برای فضای جلسه جایگزین کنید.

پایان کنفرانس فعال

برای پایان دادن به یک کنفرانس فعال در فضای جلسه، از روش spaces.endActiveConference در منبع spaces استفاده کنید. هر دو بدنه درخواست و پاسخ خالی هستند. برای اطلاعات بیشتر، ببینید Meet چگونه یک فضای جلسه را شناسایی می‌کند .

نمونه کد زیر نحوه پایان دادن به یک کنفرانس فعال را نشان می دهد:

جاوا

java-meet/samples/snippets/generated/com/google/apps/meet/v2/spacesservice/endactiveconference/AsyncEndActiveConference.java
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
/**
 * 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.
 */
// 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
# 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)

نام فضا را با شناسه منحصر به فرد ایجاد شده توسط سرور برای فضای جلسه جایگزین کنید.