與參與者合作

本指南說明如何使用 Google Meet REST API，取得曾參加過或正在參加會議的參與者詳細資料，以及他們的工作階段資訊。

參與者是指加入通話或使用夥伴模式的使用者，他們以觀看者的身份觀看通話，或是連線至通話的會議室裝置。每個人都有一個 participants 資源。

參與者工作階段是指針對每個加入通話的參與者裝置組合建立的專屬工作階段 ID。每個工作階段都有一個 participantSessions 資源。如果參與者透過相同的參與者-裝置組合多次加入同一個通話，系統會為每個參與者指派專屬的工作階段 ID。

如果您是會議空間擁有者或參與者，可以同時在 participants 和 participantSessions 資源上呼叫 get() 和 list() 方法，擷取參與者記錄。

使用使用者憑證驗證及授權，可讓 Google Meet 應用程式存取使用者資料，並代表已驗證的使用者執行作業。您可以使用全網域委派功能進行驗證，授權應用程式的服務帳戶存取使用者資料，無須逐一取得使用者的同意。

參與者

以下各節將詳細說明如何取得會議記錄中的參與者資訊。

participants 資源聯合與 user 欄位。user 只能是下列其中一個物件：

• signedinUser 可以是：

  • 透過個人電腦、行動裝置或伴侶模式加入會議的參與者。

  • 會議室裝置使用的自動程式帳戶。

• anonymousUser 是未登入 Google 帳戶的不明使用者。

• phoneUser 是使用者透過電話撥入，但未使用 Google 帳戶登入，因此無法得知使用者身分的情況。

請注意，雖然所有三個物件都會傳回 displayName，但 signedinUser 也會傳回可與 Admin SDK API 和 People API 互通的專屬 user ID。格式：users/{user}。如要進一步瞭解如何在 People API 中使用 user ID，請參閱「使用 People API 擷取參與者詳細資料」一文。

取得參與者詳細資料

如要取得特定參與者的詳細資料，請在 participants 資源上使用 name 路徑參數的 get() 方法。如果您不知道參與者名稱，可以使用 list() 方法列出所有參與者名稱。

這個方法會將參與者資料傳回為 participants 資源的例項。

以下程式碼範例說明如何擷取特定參與者：

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getparticipant/AsyncGetParticipant.java

前往 GitHub 查看

import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetParticipantRequest;
import com.google.apps.meet.v2.Participant;
import com.google.apps.meet.v2.ParticipantName;

public class AsyncGetParticipant {

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

  public static void asyncGetParticipant() 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 (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      GetParticipantRequest request =
          GetParticipantRequest.newBuilder()
              .setName(ParticipantName.of("[CONFERENCE_RECORD]", "[PARTICIPANT]").toString())
              .build();
      ApiFuture<Participant> future =
          conferenceRecordsServiceClient.getParticipantCallable().futureCall(request);
      // Do something.
      Participant response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_participant.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 participant.
 */
// const name = 'abc123'

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

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

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

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

callGetParticipant();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_participant_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_participant():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

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

    # Handle the response
    print(response)

在會議記錄中，將參與者名稱替換為特定參與者 ID 的名稱。

列出所有參與者

如要列出會議記錄中所有參與者的詳細資料，請在 participants 資源上使用 parent 路徑參數的 list() 方法。格式：conferenceRecords/{conferenceRecord}。

這個方法會傳回會議參與者清單，並以 earliestStartTime 由高至低的順序排序，做為 participants 資源的例項。如要調整頁面大小並篩選查詢結果，請參閱「自訂分頁或篩選參與者名單」一文。

以下程式碼範例說明如何列出會議記錄中的所有參與者：

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listparticipants/AsyncListParticipants.java

前往 GitHub 查看

import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordName;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListParticipantsRequest;
import com.google.apps.meet.v2.Participant;

public class AsyncListParticipants {

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

  public static void asyncListParticipants() 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 (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      ListParticipantsRequest request =
          ListParticipantsRequest.newBuilder()
              .setParent(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .build();
      ApiFuture<Participant> future =
          conferenceRecordsServiceClient.listParticipantsPagedCallable().futureCall(request);
      // Do something.
      for (Participant element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_participants.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. Format: `conferenceRecords/{conference_record}`
 */
// const parent = 'abc123'
/**
 *  Maximum number of participants to return. The service might return fewer
 *  than this value.
 *  If unspecified, at most 100 participants are returned.
 *  The maximum value is 250; values above 250 are coerced to 250.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  Page token returned from previous List Call.
 */
// const pageToken = 'abc123'
/**
 *  Optional. User specified filtering condition in EBNF
 *  format (https://en.wikipedia.org/wiki/Extended_Backus%E2%80%93Naur_form).
 *  The following are the filterable fields:
 *  * `earliest_start_time`
 *  * `latest_end_time`
 *  For example, `latest_end_time IS NULL` returns active participants in
 *  the conference.
 */
// const filter = 'abc123'

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

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

async function callListParticipants() {
  // Construct request
  const request = {
    parent,
  };

  // Run request
  const iterable = meetClient.listParticipantsAsync(request);
  for await (const response of iterable) {
      console.log(response);
  }
}

callListParticipants();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_participants_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_list_participants():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.ListParticipantsRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_participants(request=request)

    # Handle the response
    async for response in page_result:
        print(response)

將父項值替換為會議記錄的名稱。

自訂分頁或篩選參與者清單

傳遞下列查詢參數，即可自訂參與者的分頁或篩選：

• pageSize：要傳回的參與者人數上限。服務傳回的產品數量可能會少於這個值。如未指定，最多會傳回 100 位參與者。最大值為 250；超過 250 的值會自動變更為 250。

• pageToken：從先前 list 呼叫收到的頁面權杖。提供這個符記即可擷取後續網頁。

• filter：選用。查詢篩選器，用於擷取 participants 資源結果中的特定項目。

  您可以使用 earliestStartTime 或 latestEndTime 欄位，篩選在特定時間之前加入或之後離開的使用者。這兩個欄位都使用 RFC 3339 世界標準時間「Zulu」格式的時間戳記格式，解析度為奈秒，最多可顯示九個小數位：{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z。例如：

  • earliestStartTime < 2023-10-01T15:01:23Z
  • latestEndTime < 2023-10-01T15:01:23Z

  如要列出現有會議中的所有使用中參與者，請使用 latestEndTime IS NULL。

使用 People API 擷取參與者詳細資料

如要擷取參與者詳細資料，請在 People API 的 people 資源上使用 get() 方法。

1. 使用路徑的結尾元件，從 participant 資源中擷取人物的 ID。舉例來說，如果 participant 資源值為 conferenceRecords/abc-123/participants/12345，People API 的 ID 就是 12345。

2. 加入 READ_SOURCE_TYPE_PROFILE、READ_SOURCE_TYPE_CONTACT 和 READ_SOURCE_TYPE_OTHER_CONTACT ReadSourceType。這樣一來，回應中就會包含 Google Workspace 機構的內部使用者和外部聯絡人。

注意： 基於隱私權考量，並非所有參與者都能取得個人資料。

以下程式碼範例說明如何搜尋某人的機構簡介和聯絡人：

cURL

curl \
   'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
   --header 'Authorization: Bearer ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed

更改下列內容：

• PERSON_ID：要尋找的使用者 ID。
• ACCESS_TOKEN：授予多個 API 存取權的存取權杖。

參與者工作階段

以下各節將詳細說明如何取得會議記錄中參與者參與會議時段的相關資訊。

取得參與者工作階段的詳細資料

如要取得特定參與者工作階段的詳細資料，請在 participantSessions 資源上使用 get() 方法，並搭配 name 路徑參數。如果您不知道參與者工作階段名稱，可以使用 list() 方法列出參與者的所有參與者工作階段。

這個方法會將參與者名稱傳回為 participantSessions 資源的例項。

以下程式碼範例顯示如何擷取特定參與者的工作階段：

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getparticipantsession/AsyncGetParticipantSession.java

前往 GitHub 查看

import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetParticipantSessionRequest;
import com.google.apps.meet.v2.ParticipantSession;
import com.google.apps.meet.v2.ParticipantSessionName;

public class AsyncGetParticipantSession {

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

  public static void asyncGetParticipantSession() 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 (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      GetParticipantSessionRequest request =
          GetParticipantSessionRequest.newBuilder()
              .setName(
                  ParticipantSessionName.of(
                          "[CONFERENCE_RECORD]", "[PARTICIPANT]", "[PARTICIPANT_SESSION]")
                      .toString())
              .build();
      ApiFuture<ParticipantSession> future =
          conferenceRecordsServiceClient.getParticipantSessionCallable().futureCall(request);
      // Do something.
      ParticipantSession response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_participant_session.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 participant.
 */
// const name = 'abc123'

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

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

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

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

callGetParticipantSession();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_participant_session_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_participant_session():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

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

    # Handle the response
    print(response)

將參與者名稱替換為參與者工作階段中的特定參與者工作階段 ID 名稱。

列出所有參與者工作階段

如要列出會議記錄中參與者所有參與者工作階段的詳細資料，請在 participantSessions 資源上使用 parent 路徑參數，並使用 list() 方法。格式：conferenceRecords/{conferenceRecord}/participants/{participant}。

這個方法會傳回參與者工作階段清單，並以 startTime 的降冪順序排序，做為 participantSession 資源的例項。如要調整頁面大小並篩選查詢結果，請參閱「自訂分頁或篩選參與者工作階段清單」一文。

以下程式碼範例說明如何在會議記錄中列出所有參與者的工作階段：

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listparticipantsessions/AsyncListParticipantSessions.java

前往 GitHub 查看

import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListParticipantSessionsRequest;
import com.google.apps.meet.v2.ParticipantName;
import com.google.apps.meet.v2.ParticipantSession;

public class AsyncListParticipantSessions {

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

  public static void asyncListParticipantSessions() 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 (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      ListParticipantSessionsRequest request =
          ListParticipantSessionsRequest.newBuilder()
              .setParent(ParticipantName.of("[CONFERENCE_RECORD]", "[PARTICIPANT]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .build();
      ApiFuture<ParticipantSession> future =
          conferenceRecordsServiceClient.listParticipantSessionsPagedCallable().futureCall(request);
      // Do something.
      for (ParticipantSession element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_participant_sessions.js

前往 GitHub 查看

// 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.
//
// ** This file is automatically generated by gapic-generator-typescript. **
// ** https://github.com/googleapis/gapic-generator-typescript **
// ** All changes to this file may be overwritten. **



'use strict';

function main(parent) {
  /**
   * 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. Format:
   *  `conferenceRecords/{conference_record}/participants/{participant}`
   */
  // const parent = 'abc123'
  /**
   *  Optional. Maximum number of participant sessions to return. The service
   *  might return fewer than this value. If unspecified, at most 100
   *  participants are returned. The maximum value is 250; values above 250 are
   *  coerced to 250. Maximum might change in the future.
   */
  // const pageSize = 1234
  /**
   *  Optional. Page token returned from previous List Call.
   */
  // const pageToken = 'abc123'
  /**
   *  Optional. User specified filtering condition in EBNF
   *  format (https://en.wikipedia.org/wiki/Extended_Backus%E2%80%93Naur_form).
   *  The following are the filterable fields:
   *  * `start_time`
   *  * `end_time`
   *  For example, `end_time IS NULL` returns active participant sessions in
   *  the conference record.
   */
  // const filter = 'abc123'

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

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

  async function callListParticipantSessions() {
    // Construct request
    const request = {
      parent,
    };

    // Run request
    const iterable = meetClient.listParticipantSessionsAsync(request);
    for await (const response of iterable) {
        console.log(response);
    }
  }

  callListParticipantSessions();
}

process.on('unhandledRejection', err => {
  console.error(err.message);
  process.exitCode = 1;
});
main(...process.argv.slice(2));

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_participant_sessions_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_list_participant_sessions():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.ListParticipantSessionsRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_participant_sessions(request=request)

    # Handle the response
    async for response in page_result:
        print(response)

將父項值替換為會議記錄中參與者參與者工作階段的名稱。

自訂分頁或篩選參與者工作階段清單

傳遞下列選用查詢參數，即可自訂參與者工作階段的分頁或篩選條件：

• pageSize：要傳回的參與者工作階段數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多會傳回 100 個參與者工作階段。最大值為 250；超過 250 的值會自動變更為 250。

• pageToken：從先前 list 呼叫收到的頁面權杖。提供這個符記即可擷取後續網頁。

• filter：選用。查詢篩選器，用於擷取 participants 資源結果中的特定項目。

  您可以使用 startTime 或 endTime 欄位，篩選出在特定時間之前加入，或在特定時間之後離開的使用者。這兩個欄位都使用 RFC 3339 世界標準時間「Zulu」格式的時間戳記格式，精確度為奈秒，最多可顯示九個小數位：{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z。例如：

  • startTime < 2023-10-01T15:01:23Z
  • endTime < 2023-10-01T15:01:23Z

  如要列出會議記錄中的所有有效參與者工作階段，請使用 endTime IS NULL。