REST Resource: spaces

Risorsa: Space

Luogo virtuale in cui si tengono le conferenze. In uno spazio può essere tenuta una sola conferenza attiva alla volta.

Rappresentazione JSON
{
  "name": string,
  "meetingUri": string,
  "meetingCode": string,
  "config": {
    object (SpaceConfig)
  },
  "activeConference": {
    object (ActiveConference)
  },
  "phoneAccess": [
    {
      object (PhoneAccess)
    }
  ],
  "gatewaySipAccess": [
    {
      object (GatewaySipAccess)
    }
  ]
}
Campi
name

string

Immutabile. Nome della risorsa dello spazio.

Formato: spaces/{space}.

{space} è l'identificatore della risorsa per lo spazio. È un ID univoco generato dal server e sensibile alle maiuscole. Ad esempio, jQCFfuBOdN5z.

Per ulteriori informazioni, vedi Come Meet identifica uno spazio per le riunioni.

meetingUri

string

Solo output. URI utilizzato per partecipare alle riunioni composto da https://meet.google.com/ seguito da meetingCode. Ad esempio: https://meet.google.com/abc-mnop-xyz.

meetingCode

string

Solo output. Digita una stringa univoca descrittiva utilizzata per partecipare alla riunione.

Formato: [a-z]+-[a-z]+-[a-z]+. Ad esempio, abc-mnop-xyz.

La lunghezza massima è di 128 caratteri.

Può essere utilizzato solo come alias del nome dello spazio per ottenere lo spazio.

config

object (SpaceConfig)

Configurazione relativa allo spazio per le riunioni.

activeConference

object (ActiveConference)

Conferenza attiva, se esistente.

phoneAccess[]

object (PhoneAccess)

Solo output. Tutti i metodi di accesso telefonico regionali per questo spazio riunioni. Può essere vuoto.

gatewaySipAccess[]

object (GatewaySipAccess)

Solo output. I metodi di accesso basati su SIP che possono essere utilizzati per partecipare alla conferenza. Può essere vuoto.

SpaceConfig

La configurazione relativa a uno spazio per le riunioni.

Rappresentazione JSON
{
  "accessType": enum (AccessType),
  "entryPointAccess": enum (EntryPointAccess),
  "moderation": enum (Moderation),
  "moderationRestrictions": {
    object (ModerationRestrictions)
  },
  "attendanceReportGenerationType": enum (AttendanceReportGenerationType),
  "artifactConfig": {
    object (ArtifactConfig)
  }
}
Campi
accessType

enum (AccessType)

Tipo di accesso dello spazio riunioni che determina chi può partecipare senza chiedere di partecipare. Predefinito: le impostazioni di accesso predefinite dell'utente. Controllato dall'amministratore dell'utente per gli utenti aziendali o con RESTRIZIONI.

entryPointAccess

enum (EntryPointAccess)

Definisce i punti di accesso che possono essere utilizzati per partecipare alle riunioni ospitate in questo spazio per le riunioni. Valore predefinito: EntryPointAccess.ALL

moderation

enum (Moderation)

La modalità di moderazione preconfigurata per la riunione. Valore predefinito: controllato dai criteri dell'utente.

moderationRestrictions

object (ModerationRestrictions)

Quando la moderazione è impostata su ON, queste limitazioni entrano in vigore per la riunione. Quando moderation.OFF, verrà ripristinato ModerationRestrictions predefinito.

attendanceReportGenerationType

enum (AttendanceReportGenerationType)

Se il report sulla partecipazione è abilitato per lo spazio per le riunioni.

artifactConfig

object (ArtifactConfig)

Configurazione relativa agli artefatti generati automaticamente supportati dalla riunione.

AccessType

Tipi di accesso possibili per uno spazio per riunioni.

Enum
ACCESS_TYPE_UNSPECIFIED Valore predefinito specificato dall'organizzazione dell'utente. Nota: questo valore non viene mai restituito, in quanto viene restituito il tipo di accesso configurato.
OPEN Chiunque abbia le informazioni di partecipazione (ad esempio l'URL o le informazioni di accesso tramite telefono) può partecipare senza chiedere di partecipare.
TRUSTED I membri dell'organizzazione dell'organizzatore, gli utenti esterni invitati e gli utenti che accedono tramite chiamata possono partecipare senza inviare una richiesta. Tutti gli altri devono chiedere di partecipare.
RESTRICTED Solo gli invitati possono partecipare senza inviare una richiesta. Tutti gli altri devono chiedere di partecipare.

EntryPointAccess

Punti di accesso che possono essere utilizzati per partecipare a una riunione. Esempio: meet.google.com, il web SDK Embed di Meet o un'applicazione mobile.

Enum
ENTRY_POINT_ACCESS_UNSPECIFIED Non utilizzata.
ALL Sono consentiti tutti i punti di contatto.
CREATOR_APP_ONLY Per partecipare alle riunioni in questo spazio, è possibile utilizzare solo i punti di accesso di proprietà del progetto Google Cloud che ha creato lo spazio. Le app possono utilizzare l'SDK incorporato di Meet per il web o gli SDK Meet per il mobile per creare punti di accesso di proprietà.

Moderazione

La modalità di moderazione di una riunione. Quando la modalità di moderazione è attiva, il proprietario della riunione ha un maggiore controllo sulla riunione grazie a funzionalità come la gestione dei co-organizzatori (vedi il messaggio Membro) e le limitazioni delle funzionalità (vedi il messaggio ModerationRestrictions).

Enum
MODERATION_UNSPECIFIED Il tipo di moderazione non è specificato. Viene utilizzato per indicare che l'utente non ha specificato alcun valore perché non intende aggiornare lo stato. Gli utenti non possono impostare il valore come non specificato.
OFF La moderazione è disattivata.
ON La moderazione è attiva.

ModerationRestrictions

Definisce le limitazioni per le funzionalità quando la riunione è moderata.

Rappresentazione JSON
{
  "chatRestriction": enum (RestrictionType),
  "reactionRestriction": enum (RestrictionType),
  "presentRestriction": enum (RestrictionType),
  "defaultJoinAsViewerType": enum (DefaultJoinAsViewerType)
}
Campi
chatRestriction

enum (RestrictionType)

Definisce chi è autorizzato a inviare messaggi di chat nello spazio della riunione.

reactionRestriction

enum (RestrictionType)

Definisce chi è autorizzato a inviare reazioni nello spazio della riunione.

presentRestriction

enum (RestrictionType)

Definisce chi ha l'autorizzazione per condividere lo schermo nello spazio della riunione.

defaultJoinAsViewerType

enum (DefaultJoinAsViewerType)

Definisce se limitare il ruolo predefinito assegnato agli utenti come visualizzatore.

RestrictionType

Determina chi ha l'autorizzazione a utilizzare una determinata funzionalità.

Enum
RESTRICTION_TYPE_UNSPECIFIED Valore predefinito specificato dalle norme utente. Questo valore non deve mai essere restituito.
HOSTS_ONLY Il proprietario della riunione e il co-organizzatore hanno l'autorizzazione.
NO_RESTRICTION Tutti i partecipanti dispongono delle autorizzazioni.

DefaultJoinAsViewerType

Per impostazione predefinita, gli utenti partecipano come collaboratori. Gli organizzatori possono limitare la partecipazione degli utenti in qualità di spettatori. Nota: se per un utente è impostato un ruolo esplicito nella risorsa Membro, l'utente verrà aggiunto con quel ruolo.

Enum
DEFAULT_JOIN_AS_VIEWER_TYPE_UNSPECIFIED Valore predefinito specificato dalle norme utente. Questo valore non deve mai essere restituito.
ON Per impostazione predefinita, gli utenti partecipano come spettatori.
OFF Per impostazione predefinita, gli utenti partecipano come collaboratori.

AttendanceReportGenerationType

Possibili stati che indicano se il report sulla partecipazione è attivato per lo spazio per riunioni.

Enum
ATTENDANCE_REPORT_GENERATION_TYPE_UNSPECIFIED Valore predefinito specificato dalle norme utente. Questo valore non deve mai essere restituito.
GENERATE_REPORT Verrà generato un report sulla partecipazione e inviato a Drive/via email.
DO_NOT_GENERATE Il report sulla partecipazione non verrà generato.

ArtifactConfig

Configurazione relativa agli artefatti della riunione potenzialmente generati da questo spazio riunioni.

Rappresentazione JSON
{
  "recordingConfig": {
    object (RecordingConfig)
  },
  "transcriptionConfig": {
    object (TranscriptionConfig)
  },
  "smartNotesConfig": {
    object (SmartNotesConfig)
  }
}
Campi
recordingConfig

object (RecordingConfig)

Configurazione per la registrazione.

transcriptionConfig

object (TranscriptionConfig)

Configurazione della trascrizione automatica.

smartNotesConfig

object (SmartNotesConfig)

Configurazione per le note intelligenti automatiche.

RecordingConfig

Configurazione relativa alla registrazione in uno spazio riunioni.

Rappresentazione JSON
{
  "autoRecordingGeneration": enum (AutoGenerationType)
}
Campi
autoRecordingGeneration

enum (AutoGenerationType)

Definisce se uno spazio riunioni viene registrato automaticamente quando qualcuno con il privilegio di registrare partecipa alla riunione.

AutoGenerationType

Determina se un artefatto può essere generato automaticamente nello spazio della riunione.

Enum
AUTO_GENERATION_TYPE_UNSPECIFIED Valore predefinito specificato dalle norme utente. Questo valore non deve mai essere restituito.
ON L'artefatto viene generato automaticamente.
OFF L'artefatto non viene generato automaticamente.

TranscriptionConfig

Configurazione relativa alla trascrizione in uno spazio riunioni.

Rappresentazione JSON
{
  "autoTranscriptionGeneration": enum (AutoGenerationType)
}
Campi
autoTranscriptionGeneration

enum (AutoGenerationType)

Definisce se i contenuti di una riunione vengono trascritti automaticamente quando qualcuno con il privilegio di trascrivere partecipa alla riunione.

SmartNotesConfig

Configurazione relativa agli appunti intelligenti in uno spazio per le riunioni. Per saperne di più sugli appunti intelligenti, vedi "Prendi appunti per me" in Google Meet.

Rappresentazione JSON
{
  "autoSmartNotesGeneration": enum (AutoGenerationType)
}
Campi
autoSmartNotesGeneration

enum (AutoGenerationType)

Definisce se generare automaticamente un riepilogo della riunione per tutti gli invitati dell'organizzazione quando qualcuno con il privilegio di attivare gli appunti intelligenti partecipa alla riunione.

ActiveConference

Conferenza attiva.

Rappresentazione JSON
{
  "conferenceRecord": string
}
Campi
conferenceRecord

string

Solo output. Riferimento alla risorsa "ConferenceRecord". Formato: conferenceRecords/{conferenceRecord}, dove {conferenceRecord} è un ID univoco per ogni istanza di una chiamata all'interno di uno spazio.

PhoneAccess

L'accesso telefonico contiene le informazioni necessarie per accedere a una conferenza utilizzando un numero di telefono regionale e un PIN specifico per quel numero di telefono.

Rappresentazione JSON
{
  "phoneNumber": string,
  "pin": string,
  "regionCode": string,
  "languageCode": string
}
Campi
phoneNumber

string

Il numero di telefono da chiamare per questo spazio riunioni in formato E.164. Numero di telefono completo con il carattere "+" iniziale.

pin

string

Il PIN che gli utenti devono inserire dopo aver composto il numero fornito. Il PIN è composto solo da cifre decimali e la lunghezza può variare.

regionCode

string

Il codice regione CLDR/ISO 3166 per il paese associato a questo accesso telefonico. Da analizzare con l'utilità RegionCode i18n. Esempio: "SE" per la Svezia.

languageCode

string

Il codice lingua BCP 47/LDML per la lingua associata a questo accesso al telefono. Da analizzare con l'utilità LanguageCode i18n. Esempi: "es-419" per lo spagnolo latino americano, "fr-CA" per il francese canadese.

GatewaySipAccess

Dettagli su come partecipare alla conferenza tramite un gateway SIP.

Rappresentazione JSON
{
  "uri": string,
  "sipAccessCode": string
}
Campi
uri

string

L'URI (Uniform Resource Identifier) del Session Initiation Protocol (SIP) tramite cui è possibile raggiungere la conferenza.

La stringa è in uno di questi formati:

dove USER_ID è il PIN universale di 13 cifre (con la futura opzione di supportare anche l'utilizzo di un codice riunione Meet) e GATEWAY_ADDRESS è un indirizzo valido da risolvere utilizzando una ricerca DNS SRV o un indirizzo IPv4.

sipAccessCode

string

Il codice numerico permanente per l'inserimento manuale su dispositivi configurati appositamente.

Metodi

create

Crea uno spazio.

endActiveConference

Termina una conferenza attiva (se presente).

get

Recupera i dettagli di uno spazio per riunioni.

patch

Aggiorna i dettagli di uno spazio per riunioni.