עבודה עם פריטי מידע שנוצרו בתהליך פיתוח (Artifact)

במאמר הזה מוסבר איך מקבלים פרטים על הארטיפקטים השונים של הפגישה שנוצרו על ידי ועידה באמצעות Google Meet REST API.

ארטיפקט הוא קובץ או נתונים שנוצרו על ידי Google Meet בתגובה לפגישה. הנתונים האלה כוללים הקלטות של סרטונים ופריטי מידע אחרים, כמו תמלילים.

כדי ליצור פריטים שנוצרו מפגישה, המשתתפים צריכים להגדיר אותם ב-Meet לפני שהפגישה מסתיימת. מידע נוסף זמין במאמר בנושא ניהול ארטיפקטים אוטומטיים.

התמלילים פועלים בנפרד מההקלטות, ולא צריך להקליט את הפגישה כדי ליצור תמליל. כשכל המשתתפים עוזבים את הפגישה, התמלול נפסק אוטומטית. מידע נוסף זמין במאמרים איך מקליטים פגישות וידאו ואיך משתמשים בתמלילים ב-Google Meet.

אחזור פריטים שנוצרו מפגישות

אם אתם הבעלים של מרחב לפגישות או משתתפים בו, אתם יכולים להתקשר לשיטות get ו-list במשאבים recordings, transcripts, transcripts.entries ו-smart notes כדי לאחזר ארטיפקטים. מידע נוסף זמין בסעיפים הבאים.

אימות ומתן הרשאה באמצעות פרטי כניסה של משתמשים מאפשרים לאפליקציות של Meet לגשת לנתוני משתמשים ולבצע פעולות בשם המשתמש המאומת. אימות באמצעות הענקת הרשאות גישה ברמת הדומיין מאפשר לתת הרשאה לחשבון השירות של האפליקציה לגשת לנתוני המשתמשים בלי שכל משתמש יצטרך לתת את הסכמתו.

שמירת תוצרי הפגישה

אחרי שהשיחה מסתיימת, ההקלטות והתמלילים נשמרים ב-Google Drive בחשבון של מארגן/ת הפגישה. כברירת מחדל, פריטי מידע מ-Meet נשמרים בהתאם לכללים של Drive.

רשומות התמליל שמתקבלות מ-Meet REST API נמחקות 30 יום אחרי סיום הוועידה.

אפשר גם לנהל את השמירה של פריטי מידע שנוצרו מהפגישות ב-Meet בנפרד באמצעות כללי שמירה ספציפיים ל-Meet ב-Google Vault. מידע נוסף מופיע במאמר שמירת נתונים מ-Google Meet באמצעות Vault.

הקלטות

בקטעים הבאים מוסבר איך מקבלים מידע על הקלטות ברשומה של שיחת ועידה.

ל-Meet יש גישה למזהה ההקלטה אחרי שנוצר קובץ ההקלטה. יכול להיות שמשתמש ימחק את קובץ ההקלטה מ-Google Drive, אבל השם הייחודי עדיין יוחזר ב-Meet.

המשאב recordings כולל את האובייקטים DriveDestination ו-State.

האובייקט DriveDestination מכיל את מיקום הייצוא ב-Drive, שבו ההקלטה נשמרת כקובץ MP4. כדי להוריד את ההקלטה או להפעיל אותה בדפדפן, משתמשים בערך השדה exportUri של האובייקט. אם אתם מכירים את Google Drive API, הערך של השדה file תואם לערך של השדה id במשאב files. למידע נוסף, ראו הורדה וייצוא של קבצים.

האובייקט State מכיל את הסטטוס של סשן ההקלטה. כך תוכלו לבדוק אם ההקלטה התחילה, אם ההקלטה הסתיימה אבל קובץ ההקלטה לא מוכן, או אם קובץ ההקלטה נוצר ומוכן להורדה.

איך מקבלים פרטים על הקלטה

כדי לקבל פרטים על הקלטה ספציפית, משתמשים בשיטה get במשאב recordings. מגדירים את פרמטר הנתיב name באמצעות הפורמט conferenceRecords/{conferenceRecord}/recordings/{recordingName}.

אם אתם לא יודעים את שם ההקלטה, אתם יכולים לרשום את כל שמות ההקלטות באמצעות השיטה list.

השיטה מחזירה מופע של משאב recordings.

בדוגמת הקוד הבאה אפשר לראות איך מאחזרים הקלטה ספציפית:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getrecording/AsyncGetRecording.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetRecordingRequest;
import com.google.apps.meet.v2.Recording;
import com.google.apps.meet.v2.RecordingName;

public class AsyncGetRecording {

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

  public static void asyncGetRecording() 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()) {
      GetRecordingRequest request =
          GetRecordingRequest.newBuilder()
              .setName(RecordingName.of("[CONFERENCE_RECORD]", "[RECORDING]").toString())
              .build();
      ApiFuture<Recording> future =
          conferenceRecordsServiceClient.getRecordingCallable().futureCall(request);
      // Do something.
      Recording response = future.get();
    }
  }
}

Node.js

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

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

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

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

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

callGetRecording();

Python

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

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

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

    # Handle the response
    print(response)

cURL

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

מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.

מחליפים את מה שכתוב בשדות הבאים:

  • השם של רשומת השיחה עם השם של מזהה השיחה הספציפי ברשומת השיחה.
  • שם ההקלטה עם השם של מזהה ההקלטה הספציפי ברשומת הוועידה.

הצגת רשימה של כל ההקלטות

כדי לראות את הפרטים של כל ההקלטות ברשומה של ועידה, משתמשים בשיטה list במשאב recordings. מגדירים את פרמטר הנתיב parent באמצעות הפורמט conferenceRecords/{conferenceRecord}.

השיטה מחזירה רשימה של הקלטות של שיחות ועידה, מסודרות לפי startTime בסדר עולה, כמופע של משאב recordings. כדי לשנות את גודל הדף, אפשר לעיין במאמר בנושא התאמה אישית של מספור הדפים .

בדוגמת הקוד הבאה אפשר לראות איך מציגים רשימה של כל ההקלטות ברשומה של שיחת ועידה:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listrecordings/AsyncListRecordings.java
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.ListRecordingsRequest;
import com.google.apps.meet.v2.Recording;

public class AsyncListRecordings {

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

  public static void asyncListRecordings() 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()) {
      ListRecordingsRequest request =
          ListRecordingsRequest.newBuilder()
              .setParent(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .build();
      ApiFuture<Recording> future =
          conferenceRecordsServiceClient.listRecordingsPagedCallable().futureCall(request);
      // Do something.
      for (Recording element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_recordings.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. Format: `conferenceRecords/{conference_record}`
 */
// const parent = 'abc123'
/**
 *  Maximum number of recordings to return. The service might return fewer
 *  than this value.
 *  If unspecified, at most 10 recordings are returned.
 *  The maximum value is 100; values above 100 are coerced to 100.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  Page token returned from previous List Call.
 */
// const pageToken = 'abc123'

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

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

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

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

callListRecordings();

Python

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

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

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

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

cURL

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

מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.

מחליפים את שם ההורה בשם של מזהה הוועידה הספציפי ברשומה של הוועידה.

תמלילים

בקטעים הבאים מוסבר איך לקבל מידע על תמלילים של שיחות ועידה ברשומה של שיחת הוועידה.

ל-Meet יש גישה למזהה התמליל אחרי שנוצרים נתוני התמליל. יכול להיות שמשתמש ימחק את קובץ התמלול מ-Drive, אבל השם הייחודי עדיין יוחזר ב-Meet.

המשאב transcripts כולל את האובייקטים DocsDestination ו-State.

אובייקט DocsDestination מכיל את מיקום הייצוא ב-Drive שבו נשמר קובץ התמליל של Google Docs. כדי לאחזר את התוכן או לעיין בתמליל בדפדפן, משתמשים בערך השדה exportUri של האובייקט. אם אתם מכירים את Google Docs API, הערך של השדה document תואם לערך של documentId במשאב documents.

האובייקט State מכיל את הסטטוס של סשן התמליל. האפשרות הזו מאפשרת לכם לשלוח שאילתה כדי לדעת אם סשן התמליל התחיל, אם סשן התמליל הסתיים אבל קובץ התמליל לא מוכן, או אם קובץ התמליל נוצר ומוכן להורדה.

איך מקבלים פרטים על תמליל

כדי לקבל פרטים על תמליל ספציפי, משתמשים בשיטה get במשאב transcripts. מגדירים את פרמטר הנתיב name בפורמט conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}.

אם אתם לא יודעים את שם התמליל, אתם יכולים לרשום את כל שמות התמלילים באמצעות השיטה list.

השיטה מחזירה מופע של משאב transcripts.

בדוגמת הקוד הבאה אפשר לראות איך מאחזרים תמליל ספציפי:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/gettranscript/AsyncGetTranscript.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetTranscriptRequest;
import com.google.apps.meet.v2.Transcript;
import com.google.apps.meet.v2.TranscriptName;

public class AsyncGetTranscript {

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

  public static void asyncGetTranscript() 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()) {
      GetTranscriptRequest request =
          GetTranscriptRequest.newBuilder()
              .setName(TranscriptName.of("[CONFERENCE_RECORD]", "[TRANSCRIPT]").toString())
              .build();
      ApiFuture<Transcript> future =
          conferenceRecordsServiceClient.getTranscriptCallable().futureCall(request);
      // Do something.
      Transcript response = future.get();
    }
  }
}

Node.js

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

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

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

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

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

callGetTranscript();

Python

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

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

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

    # Handle the response
    print(response)

cURL

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

מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.

מחליפים את מה שכתוב בשדות הבאים:

  • השם של רשומת השיחה עם השם של מזהה השיחה הספציפי ברשומת השיחה.
  • שם התמליל עם השם של מזהה התמליל הספציפי ברשומה של שיחת ועידה.

הצגת רשימה של כל התמלילים

כדי לראות את כל הפרטים של התמלילים בהקלטה של שיחת ועידה, משתמשים בשיטה list במשאב transcripts. מגדירים את פרמטר הנתיב parent בפורמט conferenceRecords/{conferenceRecord}.

השיטה מחזירה רשימה של תמלילי שיחות ועידה, מסודרים לפי startTime בסדר עולה, כמופע של משאב transcripts. כדי לשנות את גודל הדף, אפשר לעיין במאמר בנושא התאמה אישית של מספור הדפים .

בדוגמת הקוד הבאה אפשר לראות איך מציגים רשימה של כל התמלילים בהקלטה של שיחת ועידה:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listtranscripts/AsyncListTranscripts.java
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.ListTranscriptsRequest;
import com.google.apps.meet.v2.Transcript;

public class AsyncListTranscripts {

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

  public static void asyncListTranscripts() 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()) {
      ListTranscriptsRequest request =
          ListTranscriptsRequest.newBuilder()
              .setParent(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .build();
      ApiFuture<Transcript> future =
          conferenceRecordsServiceClient.listTranscriptsPagedCallable().futureCall(request);
      // Do something.
      for (Transcript element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_transcripts.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. Format: `conferenceRecords/{conference_record}`
 */
// const parent = 'abc123'
/**
 *  Maximum number of transcripts to return. The service might return fewer
 *  than this value.
 *  If unspecified, at most 10 transcripts are returned.
 *  The maximum value is 100; values above 100 are coerced to 100.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  Page token returned from previous List Call.
 */
// const pageToken = 'abc123'

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

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

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

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

callListTranscripts();

Python

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

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

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

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

cURL

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

מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.

מחליפים את שם ההורה בשם של מזהה הוועידה הספציפי ברשומה של הוועידה.

רשומות בתמליל

בקטעים הבאים מוסבר איך לקבל את הדיבור של כל משתתף כרשומות בתמליל במהלך הפגישה.

רשומה בתמליל מכילה תמליל של קול המשתתף, עד למקסימום של 10,000 מילים. הטקסט המדובר languageCode (לדוגמה, en-US) נכלל גם כתחביר IETF BCP 47.

כל רשומה בתמליל מקושרת לשם participant בוועידה. כדי לאחזר את פרטי המשתתפים, אפשר לעיין במאמר בנושא קבלת פרטים על משתתף.

הנתונים של רשומות התמליל זמינים למשך 30 יום אחרי סיום הוועידה.

שימו לב: יכול להיות שהתמליל שמוחזר על ידי Meet REST API לא יהיה זהה לתמליל שמופיע בקובץ התמליל ב-Docs. המצב הזה קורה כשמשנים את קובץ התמליל אחרי שהוא נוצר.

איך מקבלים פרטים על רשומה בתמליל

כדי לקבל פרטים על רשומה ספציפית בתמליל, משתמשים ב-method‏ get במשאב transcripts.entries. מגדירים את פרמטר הנתיב name בפורמט conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}/entries/{transcriptEntryName}.

אם אתם לא יודעים את השם של רשומת התמלול, אתם יכולים לרשום את כל השמות של רשומות התמלול באמצעות השיטה list.

השיטה מחזירה מופע של משאב transcripts.entries.

בדוגמת הקוד הבאה אפשר לראות איך מאחזרים רשומה ספציפית בתמליל:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/gettranscriptentry/AsyncGetTranscriptEntry.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetTranscriptEntryRequest;
import com.google.apps.meet.v2.TranscriptEntry;
import com.google.apps.meet.v2.TranscriptEntryName;

public class AsyncGetTranscriptEntry {

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

  public static void asyncGetTranscriptEntry() 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()) {
      GetTranscriptEntryRequest request =
          GetTranscriptEntryRequest.newBuilder()
              .setName(
                  TranscriptEntryName.of("[CONFERENCE_RECORD]", "[TRANSCRIPT]", "[ENTRY]")
                      .toString())
              .build();
      ApiFuture<TranscriptEntry> future =
          conferenceRecordsServiceClient.getTranscriptEntryCallable().futureCall(request);
      // Do something.
      TranscriptEntry response = future.get();
    }
  }
}

Node.js

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

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

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

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

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

callGetTranscriptEntry();

Python

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

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

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

    # Handle the response
    print(response)

cURL

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

מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.

מחליפים את מה שכתוב בשדות הבאים:

  • השם של רשומת השיחה עם השם של מזהה השיחה הספציפי ברשומת השיחה.
  • שם התמליל עם השם של מזהה התמליל הספציפי ברשומה של שיחת ועידה.
  • השם של רשומה בתמליל עם השם של מזהה רשומה ספציפי בתמליל.

הצגת רשימה של כל רשומות התמליל

כדי לראות את כל הפרטים של כל רשומה בתמליל, משתמשים בשיטה list במשאב transcripts.entries. מגדירים את פרמטר הנתיב parent באמצעות הפורמט conferenceRecords/{conferenceRecord}/transcripts/{transcript}.

השיטה מחזירה רשימה של רשומות תמליל מובנות לכל תמליל של שיחה, מסודרות לפי startTime בסדר עולה, כמופע של משאב transcripts.entries. כדי לשנות את גודל הדף, אפשר לעיין במאמר בנושא התאמה אישית של מספור הדפים .

בדוגמת הקוד הבאה אפשר לראות איך מציגים רשימה של כל הרשומות בתמליל:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listtranscriptentries/AsyncListTranscriptEntries.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListTranscriptEntriesRequest;
import com.google.apps.meet.v2.TranscriptEntry;
import com.google.apps.meet.v2.TranscriptName;

public class AsyncListTranscriptEntries {

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

  public static void asyncListTranscriptEntries() 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()) {
      ListTranscriptEntriesRequest request =
          ListTranscriptEntriesRequest.newBuilder()
              .setParent(TranscriptName.of("[CONFERENCE_RECORD]", "[TRANSCRIPT]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .build();
      ApiFuture<TranscriptEntry> future =
          conferenceRecordsServiceClient.listTranscriptEntriesPagedCallable().futureCall(request);
      // Do something.
      for (TranscriptEntry element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_transcript_entries.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. Format:
 *  `conferenceRecords/{conference_record}/transcripts/{transcript}`
 */
// const parent = 'abc123'
/**
 *  Maximum number of entries to return. The service might return fewer than
 *  this value.
 *  If unspecified, at most 10 entries are returned.
 *  The maximum value is 100; values above 100 are coerced to 100.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  Page token returned from previous List Call.
 */
// const pageToken = 'abc123'

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

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

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

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

callListTranscriptEntries();

Python

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

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

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

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

cURL

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

מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.

מחליפים את מה שכתוב בשדות הבאים:

  • שם ההורה עם השם של מזהה שיחת הוועידה הספציפי ברשומה של שיחת הוועידה.
  • שם התמליל עם השם של מזהה התמליל הספציפי ברשומה של שיחת ועידה.

סיכום חכם

בקטעים הבאים מוסבר איך לקבל מידע על סיכום חכם של שיחות ועידה בהקלטה של שיחת ועידה.

ל-Meet יש גישה למזהה של הסיכום החכם אחרי שנוצרים הנתונים של הסיכום החכם. יכול להיות שמשתמש ימחק את קובץ הסיכום החכם מ-Drive, אבל השם הייחודי עדיין יופיע ב-Meet.

המשאב smartNotes כולל את האובייקט State. האובייקט הזה מכיל את הסטטוס של סשן הסיכום החכם. כך תוכלו לדעת אם הפעלתם את הסיכום החכם, אם הפעלתם אותו אבל הקובץ עדיין לא מוכן, או אם הקובץ מוכן להורדה.

משאב smartNotes כולל גם את סוג האובייקט DocsDestination. האובייקט הזה מכיל את מיקום הייצוא ב-Drive שבו נשמר קובץ ההערות החכמות ב-Google Docs. כדי לאחזר את התוכן או לעיין בהערות החכמות בדפדפן, משתמשים בערך השדה exportUri של האובייקט. אם אתם מכירים את Google Docs API, הערך של השדה document תואם לערך של documentId במשאב documents.

אפשר לנהל הערות חכמות באמצעות השיטות get ו-list.

איך מקבלים פרטים על סיכום חכם

כדי לקבל פרטים על קובץ ספציפי של הערות חכמות, משתמשים בשיטה get ב-smartNotes. מגדירים את פרמטר הנתיב name בפורמט conferenceRecords/{conferenceRecord}/smartNotes/{smartNote}.

אם אתם לא יודעים את השם של הסיכום החכם, אתם יכולים לרשום את כל הקבצים של הסיכומים החכמים באמצעות השיטה list.

השיטה מחזירה מופע של משאב smartNotes.

cURL

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

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CONFERENCE_RECORD_NAME: מזהה שיחת הוועידה הספציפי ברשומה של שיחת הוועידה.
  • ‫SMART_NOTES_NAME: המזהה הספציפי של הסיכום החכם ברשומה של שיחת ועידה.
  • ‫ACCESS_TOKEN: טוקן הגישה שמעניק גישה ל-API.

הצגת רשימה של כל הסיכומים החכמים

כדי להציג רשימה של פרטים על כל קובצי הסיכום החכם ברשומה של שיחה, משתמשים בשיטה list במשאב smartNotes. מגדירים את פרמטר הנתיב parent בפורמט conferenceRecords/{conferenceRecord}.

השיטה מחזירה רשימה של קבצים של סיכום חכם של פגישות, שממוינת לפי startTime בסדר עולה, כמופע של משאב smartNotes. כדי לשנות את גודל הדף, אפשר לקרוא את המאמר התאמה אישית של מספור הדפים .

cURL

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

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PARENT_NAME: המזהה הספציפי של שיחת הוועידה ברשומה של שיחת הוועידה.
  • ‫ACCESS_TOKEN: טוקן הגישה שמעניק גישה ל-API.

התאמה אישית של מספור הדפים

מעבירים את הפרמטרים הבאים של השאילתה כדי להתאים אישית את המספור של ההקלטות, התמלילים והערכים בתמלילים:

  • ‫pageSize: מספר הפריטים המקסימלי שיוחזר. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, המערכת מחזירה עד 10 פריטים. הערך המקסימלי הוא 100. ערכים שגדולים מ-100 משתנים אוטומטית ל-100.

  • ‫pageToken: טוקן של דף שהתקבל מקריאה קודמת של רשימה. צריך להזין את הטוקן הזה כדי לאחזר את הדף הבא.