Panduan ini menjelaskan cara mendapatkan detail tentang peserta yang menghadiri konferensi sebelumnya atau yang berada dalam konferensi aktif, beserta info sesi mereka, menggunakan Google Meet REST API.
Peserta adalah orang yang bergabung ke panggilan atau yang menggunakan mode Pendamping, menonton sebagai penonton, atau perangkat ruang yang terhubung ke panggilan. Ada satu
participants
resource untuk setiap orang.
Sesi peserta adalah
ID sesi unik yang dibuat untuk setiap pasangan peserta-perangkat yang bergabung dalam panggilan.
Ada satu resource
participantSessions
untuk setiap sesi. Jika peserta bergabung ke panggilan yang sama beberapa kali
dari pasangan perangkat-peserta yang sama, setiap kali mereka bergabung, mereka akan diberi ID sesi unik.
Jika Anda adalah pemilik atau peserta ruang rapat, Anda dapat memanggil metode get()
dan
list()
pada resource participants
dan participantSessions
untuk mengambil data peserta.
Mengautentikasi dan memberikan otorisasi dengan kredensial pengguna memungkinkan aplikasi Google Meet mengakses data pengguna dan melakukan operasi atas nama pengguna yang diautentikasi. Mengautentikasi dengan delegasi tingkat domain memungkinkan Anda mengizinkan akun layanan aplikasi untuk mengakses data pengguna Anda tanpa mewajibkan tiap pengguna memberikan izin.
Peserta
Bagian berikut menjelaskan cara mendapatkan informasi tentang peserta dalam rekaman konferensi.
Gabungan resource participants
dengan kolom user
. user
hanya dapat berupa salah satu objek berikut:
signedinUser
adalah:Individu yang bergabung dari komputer pribadi, perangkat seluler, atau melalui mode Pendamping.
Akun robot yang digunakan oleh perangkat ruang konferensi.
anonymousUser
adalah pengguna yang tidak dikenal yang tidak login ke Akun Google.phoneUser
adalah pengguna yang bergabung melalui telepon yang identitasnya tidak diketahui karena mereka belum login dengan Akun Google.
Perhatikan bahwa meskipun ketiga objek menampilkan displayName
, signedinUser
juga
menampilkan ID user
unik yang dapat beroperasi dengan Admin SDK API dan
People API. Format: users/{user}
. Untuk mengetahui informasi selengkapnya tentang penggunaan ID user
dengan People API, lihat Mengambil detail peserta dengan
People API.
Mendapatkan detail tentang peserta
Untuk mendapatkan detail tentang peserta tertentu, gunakan
metode get()
pada resource
participants
dengan parameter jalur name
. Jika Anda tidak mengetahui nama peserta,
Anda dapat mencantumkan semua nama peserta menggunakan metode list()
.
Metode ini menampilkan data peserta sebagai instance resource participants
.
Contoh kode berikut menunjukkan cara mengambil peserta tertentu:
Java
Node.js
Python
Ganti nama peserta dengan nama ID peserta tertentu dalam rekaman konferensi.
Mencantumkan semua peserta
Untuk mencantumkan detail tentang semua peserta dalam rekaman konferensi, gunakan metode
list()
pada resource
participants
dengan parameter jalur parent
. Format:
conferenceRecords/{conferenceRecord}
.
Metode ini menampilkan daftar peserta konferensi, yang diurutkan berdasarkan
earliestStartTime
dalam urutan menurun, sebagai instance resource participants
. Untuk menyesuaikan ukuran halaman dan memfilter hasil kueri, lihat Menyesuaikan penomoran halaman atau memfilter daftar peserta.
Contoh kode berikut menunjukkan cara mencantumkan semua peserta dalam rekaman konferensi:
Java
Node.js
Python
Ganti nilai induk dengan nama rekaman konferensi.
Menyesuaikan penomoran halaman atau memfilter daftar peserta
Teruskan parameter kueri berikut untuk menyesuaikan penomoran halaman atau memfilter peserta:
pageSize
: Jumlah maksimum peserta yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 100 peserta akan ditampilkan. Nilai maksimum adalah 250; nilai lebih dari 250 akan otomatis diubah menjadi 250.pageToken
: Token halaman, diterima dari panggilan daftar sebelumnya. Berikan token ini untuk mengambil halaman berikutnya.filter
: Opsional. Filter kueri untuk mengambil item tertentu dalam hasil resourceparticipants
.Anda dapat menggunakan kolom
earliestStartTime
ataulatestEndTime
untuk memfilter pengguna yang bergabung sebelum atau keluar setelah waktu tertentu. Kedua kolom menggunakan format Timestamp dalam format RFC 3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Contoh:earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
Untuk mencantumkan semua peserta aktif dalam konferensi yang ada, gunakan
latestEndTime IS NULL
.
Mengambil detail peserta dengan People API
Untuk mengambil detail tentang peserta, gunakan metode
get()
pada resource
people
di People API.
Ekstrak ID orang dari resource
participant
menggunakan komponen jalur berikutnya. Misalnya, jika nilai resourceparticipant
adalahconferenceRecords/abc-123/participants/12345
, ID untuk People API adalah12345
.Sertakan
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
, danREAD_SOURCE_TYPE_OTHER_CONTACT
ReadSourceType
. Hal ini memastikan bahwa pengguna internal organisasi Google Workspace dan kontak eksternal disertakan dalam respons.
Contoh kode berikut menunjukkan cara menelusuri profil organisasi dan kontak seseorang:
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
Ganti kode berikut:
- PERSON_ID: ID orang yang akan ditemukan.
- ACCESS_TOKEN: token akses yang memberikan akses ke beberapa API.
Sesi peserta
Bagian berikut menjelaskan secara mendetail cara mendapatkan informasi tentang sesi peserta dari peserta dalam rekaman konferensi.
Mendapatkan detail tentang sesi peserta
Untuk mendapatkan detail tentang sesi peserta tertentu, gunakan metode
get()
pada resource
participantSessions
dengan parameter jalur name
. Jika Anda tidak mengetahui nama sesi peserta, Anda dapat mencantumkan semua sesi peserta dari
peserta menggunakan metode list()
.
Metode ini menampilkan nama peserta sebagai instance resource participantSessions
.
Contoh kode berikut menunjukkan cara mengambil sesi peserta tertentu:
Java
Node.js
Python
Ganti nama peserta dengan nama ID sesi peserta tertentu dalam sesi peserta.
Mencantumkan semua sesi peserta
Untuk mencantumkan detail tentang semua sesi peserta dari peserta dalam rekaman konferensi, gunakan metode list()
di resource participantSessions
dengan parameter jalur parent
. Format:
conferenceRecords/{conferenceRecord}/participants/{participant}
.
Metode ini menampilkan daftar sesi peserta, yang diurutkan berdasarkan startTime
dalam urutan menurun, sebagai instance resource participantSession
. Untuk menyesuaikan
ukuran halaman dan memfilter hasil kueri, lihat Menyesuaikan penomoran halaman atau memfilter
daftar sesi peserta.
Contoh kode berikut menunjukkan cara mencantumkan semua sesi peserta dalam rekaman konferensi:
Java
Node.js
Python
Ganti nilai induk dengan nama sesi peserta dari peserta dalam rekaman konferensi.
Menyesuaikan penomoran halaman atau memfilter daftar sesi peserta
Teruskan parameter kueri opsional berikut untuk menyesuaikan penomoran halaman atau memfilter sesi peserta:
pageSize
: Jumlah maksimum sesi peserta yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 100 sesi peserta akan ditampilkan. Nilai maksimum adalah 250; nilai lebih dari 250 akan otomatis diubah menjadi 250.pageToken
: Token halaman, diterima dari panggilan daftar sebelumnya. Berikan token ini untuk mengambil halaman berikutnya.filter
: Opsional. Filter kueri untuk mengambil item tertentu dalam hasil resourceparticipants
.Anda dapat menggunakan kolom
startTime
atauendTime
untuk memfilter pengguna yang bergabung sebelum atau keluar setelah waktu tertentu. Kedua kolom menggunakan format Timestamp dalam format RFC 3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Contoh:startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
Untuk mencantumkan semua sesi peserta aktif dalam rekaman konferensi, gunakan
endTime IS NULL
.