Travaillez avec des conférences

Ce guide explique comment obtenir des informations sur une seule conférence ou sur toutes les conférences de la ressource conferenceRecords de l'API REST Google Meet.

Une conférence est une instance d'appel générée par le serveur dans un espace de réunion. Il s'agit également d'une instance unique d'une réunion.

Si vous êtes propriétaire ou participant d'un espace de réunion, vous pouvez appeler les méthodes get et list pour récupérer les enregistrements de conférence.

L'authentification et l'autorisation avec identifiants utilisateur permettent aux applications Google Meet d'accéder aux données utilisateur et d'effectuer des opérations pour le compte de l'utilisateur authentifié. L'authentification avec délégation à l'échelle du domaine vous permet d'autoriser le compte de service d'une application à accéder aux données de vos utilisateurs sans que chacun d'entre eux ait à donner son consentement.

Obtenir des informations sur une conférence

Pour obtenir des informations sur une conférence spécifique, utilisez la get méthode sur la conferenceRecords ressource. Définissez le paramètre de chemin name de la conférence au format conferenceRecords/{conferenceRecord}.

Si vous ne connaissez pas le nom de la conférence, vous pouvez répertorier tous les noms de conférence à l'aide de la méthode list.

La méthode renvoie une conférence passée en tant qu'instance de la ressource conferenceRecords.

L'exemple de code suivant montre comment récupérer une conférence spécifique :

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getconferencerecord/AsyncGetConferenceRecord.java

Afficher sur GitHub

import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecord;
import com.google.apps.meet.v2.ConferenceRecordName;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetConferenceRecordRequest;

public class AsyncGetConferenceRecord {

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

  public static void asyncGetConferenceRecord() 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()) {
      GetConferenceRecordRequest request =
          GetConferenceRecordRequest.newBuilder()
              .setName(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .build();
      ApiFuture<ConferenceRecord> future =
          conferenceRecordsServiceClient.getConferenceRecordCallable().futureCall(request);
      // Do something.
      ConferenceRecord response = future.get();
    }
  }
}

Node.js

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

Afficher sur 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 conference.
 */
// const name = 'abc123'

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

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

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

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

callGetConferenceRecord();

Python

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

Afficher sur 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_conference_record():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

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

    # Handle the response
    print(response)

cURL

curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"

Remplacez ACCESS_TOKEN par le jeton d'accès qui autorise l'accès à l'API.

Remplacez le nom de l'enregistrement de conférence par le nom de l'ID de conférence spécifique dans un enregistrement de conférence.

Répertorier toutes les conférences

Pour répertorier les informations sur toutes les conférences, utilisez la list méthode sur la conferenceRecords ressource sans aucun paramètre de chemin.

La méthode renvoie une liste de conférences passées en tant qu'instance de la ressource conferenceRecords. Elles sont filtrées par l'organisateur de la conférence et triées par startTime dans l'ordre décroissant. Pour ajuster la taille de la page et filtrer les résultats de la requête, consultez Personnaliser la pagination ou filtrer la liste.

Remarque : La méthode list ne renvoie que les conférences dont vous êtes l’ organisateur. Si l'application que vous utilisez pour afficher les conférences ne dispose que du champ d'application OAuth meetings.space.created, vous ne pouvez afficher que les conférences des espaces créés par l'application. Pour en savoir plus, consultez les champs d'application de l'API REST Meet.

L'exemple de code suivant montre comment répertorier toutes les conférences :

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listconferencerecords/AsyncListConferenceRecords.java

Afficher sur GitHub

import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecord;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListConferenceRecordsRequest;

public class AsyncListConferenceRecords {

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

  public static void asyncListConferenceRecords() 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()) {
      ListConferenceRecordsRequest request =
          ListConferenceRecordsRequest.newBuilder()
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .build();
      ApiFuture<ConferenceRecord> future =
          conferenceRecordsServiceClient.listConferenceRecordsPagedCallable().futureCall(request);
      // Do something.
      for (ConferenceRecord element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

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

Afficher sur 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.
 */
/**
 *  Optional. Maximum number of conference records to return. The service might
 *  return fewer than this value. If unspecified, at most 25 conference records
 *  are returned. The maximum value is 100; values above 100 are coerced to
 *  100. 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:
 *  * `space.meeting_code`
 *  * `space.name`
 *  * `start_time`
 *  * `end_time`
 *  For example, consider the following filters:
 *  * `space.name = "spaces/NAME"`
 *  * `space.meeting_code = "abc-mnop-xyz"`
 *  * `start_time>="2024-01-01T00:00:00.000Z" AND
 *  start_time<="2024-01-02T00:00:00.000Z"`
 *  * `end_time IS NULL`
 */
// const filter = 'abc123'

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

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

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

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

callListConferenceRecords();

Python

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

Afficher sur 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_conference_records():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

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

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

cURL

curl -X GET "https://meet.googleapis.com/v2/conferenceRecords" \
-H "Authorization: Bearer ACCESS_TOKEN"

Remplacez ACCESS_TOKEN par le jeton d'accès qui autorise l'accès à l'API.

Personnaliser la pagination ou filtrer la liste

Transmettez les paramètres de requête facultatifs suivants pour personnaliser la pagination ou filtrer les enregistrements de conférence :

• pageSize : nombre maximal d'enregistrements de conférence à renvoyer. Le service peut renvoyer une valeur inférieure. Si aucune valeur n'est spécifiée, 25 enregistrements de conférence au maximum sont renvoyés. La valeur maximale est 100. Les valeurs supérieures à 100 sont automatiquement remplacées par 100.

• pageToken : jeton de page reçu d'un appel de liste précédent. Fournissez ce jeton pour récupérer la page suivante.

• filter: filtre de requête permettant de récupérer des éléments spécifiques dans les résultats de la ressource conferenceRecords. Pour obtenir des informations sur les requêtes compatibles, consultez la list méthode. Pour en savoir plus sur la façon de déterminer un espace de réunion, consultez Comment Meet identifie un espace de réunion.