REST Resource: spaces

Ressource: Space

Virtueller Ort, an dem Konferenzen stattfinden. In einem Bereich kann jeweils nur eine aktive Videokonferenz stattfinden.

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

string

Nicht veränderbar. Ressourcenname des Bereichs.

Format: spaces/{space}.

{space} ist die Ressourcen-ID für den Bereich. Es handelt sich um eine eindeutige, vom Server generierte ID, bei der zwischen Groß- und Kleinschreibung unterschieden wird. Beispiel: jQCFfuBOdN5z.

Weitere Informationen finden Sie unter Wie Meet einen Konferenzraum identifiziert.

meetingUri

string

Nur Ausgabe. Der URI, der für die Teilnahme an Besprechungen verwendet wird und aus https://meet.google.com/ gefolgt von meetingCode besteht. Beispiel: https://meet.google.com/abc-mnop-xyz

meetingCode

string

Nur Ausgabe. Eindeutiger String, der für die Teilnahme an der Besprechung verwendet wird.

Format: [a-z]+-[a-z]+-[a-z]+. Beispiel: abc-mnop-xyz.

Die maximale Länge beträgt 128 Zeichen.

Kann nur als Alias des Bereichsnamens verwendet werden, um den Bereich abzurufen.

config

object (SpaceConfig)

Konfiguration des Konferenzraums.

activeConference

object (ActiveConference)

Aktive Videokonferenz, falls vorhanden.

phoneAccess[]

object (PhoneAccess)

Nur Ausgabe. Alle regionalen Methoden für den Telefonzugriff für diesen Konferenzraum. Darf leer sein.

gatewaySipAccess[]

object (GatewaySipAccess)

Nur Ausgabe. Die SIP-basierten Zugriffsmethoden, die für die Teilnahme an der Konferenz verwendet werden können. Darf leer sein.

SpaceConfig

Die Konfiguration für einen Konferenzraum.

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

enum (AccessType)

Der Zugriffstyp des Konferenzraums bestimmt, wer ohne Anklopfen teilnehmen kann. Standard: Die Standardzugriffseinstellungen des Nutzers. Wird vom Administrator des Nutzers für Unternehmensnutzer oder RESTRICTED gesteuert.

entryPointAccess

enum (EntryPointAccess)

Definiert die Einstiegspunkte, über die Nutzer an Videokonferenzen teilnehmen können, die in diesem Konferenzraum gehostet werden. Standard: EntryPointAccess.ALL

moderation

enum (Moderation)

Der vorkonfigurierte Moderationsmodus für die Besprechung. Standard: Wird durch die Richtlinien des Nutzers gesteuert.

moderationRestrictions

object (ModerationRestrictions)

Wenn „moderation.ON“ festgelegt ist, gelten diese Einschränkungen für die Besprechung. Wenn „moderation.OFF“ festgelegt ist, wird der Wert auf die Standardeinstellungen von „ModerationRestrictions“ zurückgesetzt.

attendanceReportGenerationType

enum (AttendanceReportGenerationType)

Gibt an, ob der Teilnahmebericht für den Konferenzraum aktiviert ist.

artifactConfig

object (ArtifactConfig)

Konfiguration für die automatisch generierten Artefakte, die von der Besprechung unterstützt werden.

AccessType

Mögliche Zugriffstypen für einen Konferenzraum.

Enums
ACCESS_TYPE_UNSPECIFIED Standardwert, der von der Organisation des Nutzers angegeben wird. Hinweis: Dieser Wert wird nie zurückgegeben, da stattdessen der konfigurierte Zugriffstyp zurückgegeben wird.
OPEN Jeder, der über die Beitrittsinformationen (z. B. die URL oder die Telefonzugriffsinformationen) verfügt, kann ohne Anklopfen beitreten.
TRUSTED Mitglieder der Organisation des Organisators, eingeladene externe Nutzer und Nutzer, die sich per Telefon einwählen, können ohne Anklopfen teilnehmen. Alle anderen müssen anklopfen.
RESTRICTED Nur eingeladene Personen können ohne Anklopfen teilnehmen. Alle anderen müssen anklopfen.

EntryPointAccess

Einstiegspunkte, über die Sie an einer Besprechung teilnehmen können. Beispiel: meet.google.com, das Meet Embed SDK Web oder eine mobile Anwendung.

Enums
ENTRY_POINT_ACCESS_UNSPECIFIED Nicht verwendet
ALL Alle Einstiegspunkte sind zulässig.
CREATOR_APP_ONLY Nur Einstiegspunkte, die dem Google Cloud-Projekt gehören, mit dem der Bereich erstellt wurde, können verwendet werden, um Besprechungen in diesem Bereich beizutreten. Apps können das Meet Embed SDK Web oder die mobilen Meet-SDKs verwenden, um eigene Einstiegspunkte zu erstellen.

Moderation

Der Moderationsmodus für eine Besprechung. Wenn der Moderationsmodus aktiviert ist, hat der Organisator der Besprechung mehr Kontrolle über die Besprechung. Dazu stehen ihm Funktionen wie die Verwaltung von Co-Organisatoren (siehe Nachricht „Member“) und Funktionseinschränkungen (siehe Nachricht „ModerationRestrictions“) zur Verfügung.

Enums
MODERATION_UNSPECIFIED Der Moderationstyp ist nicht angegeben. Damit wird angegeben, dass der Nutzer keinen Wert angegeben hat, da er den Status nicht aktualisieren möchte. Nutzer dürfen den Wert nicht als „nicht angegeben“ festlegen.
OFF Die Moderation ist deaktiviert.
ON Die Moderation ist aktiviert.

ModerationRestrictions

Definiert Einschränkungen für Funktionen, wenn die Besprechung moderiert wird.

JSON-Darstellung
{
  "chatRestriction": enum (RestrictionType),
  "reactionRestriction": enum (RestrictionType),
  "presentRestriction": enum (RestrictionType),
  "defaultJoinAsViewerType": enum (DefaultJoinAsViewerType)
}
Felder
chatRestriction

enum (RestrictionType)

Definiert, wer die Berechtigung hat, Chatnachrichten im Konferenzraum zu senden.

reactionRestriction

enum (RestrictionType)

Definiert, wer die Berechtigung hat, im Konferenzraum Reaktionen zu senden.

presentRestriction

enum (RestrictionType)

Legt fest, wer die Berechtigung hat, seinen Bildschirm im Konferenzraum freizugeben.

defaultJoinAsViewerType

enum (DefaultJoinAsViewerType)

Legt fest, ob die Standardrolle, die Nutzern als Betrachter zugewiesen wird, eingeschränkt werden soll.

RestrictionType

Legt fest, wer die Berechtigung hat, eine bestimmte Funktion zu verwenden.

Enums
RESTRICTION_TYPE_UNSPECIFIED Standardwert, der durch die Nutzerrichtlinie angegeben wird. Dieser Wert sollte nie zurückgegeben werden.
HOSTS_ONLY Der Organisator und der Co-Organisator der Videokonferenz haben die Berechtigung.
NO_RESTRICTION Alle Teilnehmer haben Berechtigungen.

DefaultJoinAsViewerType

Standardmäßig nehmen Nutzer als Mitwirkende teil. Organisatoren können festlegen, dass Nutzer nur als Zuschauer teilnehmen können. Hinweis: Wenn für einen Nutzer in der Mitgliedsressource eine explizite Rolle festgelegt ist, wird der Nutzer mit dieser Rolle hinzugefügt.

Enums
DEFAULT_JOIN_AS_VIEWER_TYPE_UNSPECIFIED Standardwert, der durch die Nutzerrichtlinie angegeben wird. Dieser Wert sollte nie zurückgegeben werden.
ON Nutzer nehmen standardmäßig als Zuschauer teil.
OFF Nutzer treten standardmäßig als Mitwirkende bei.

AttendanceReportGenerationType

Mögliche Statusangaben dazu, ob der Teilnahmebericht für den Konferenzraum aktiviert ist.

Enums
ATTENDANCE_REPORT_GENERATION_TYPE_UNSPECIFIED Standardwert, der durch die Nutzerrichtlinie angegeben wird. Dieser Wert sollte nie zurückgegeben werden.
GENERATE_REPORT Ein Teilnahmebericht wird erstellt und an Drive/E-Mail gesendet.
DO_NOT_GENERATE Es wird kein Teilnahmebericht erstellt.

ArtifactConfig

Konfiguration in Bezug auf Besprechungsartefakte, die möglicherweise von diesem Konferenzraum generiert werden.

JSON-Darstellung
{
  "recordingConfig": {
    object (RecordingConfig)
  },
  "transcriptionConfig": {
    object (TranscriptionConfig)
  },
  "smartNotesConfig": {
    object (SmartNotesConfig)
  }
}
Felder
recordingConfig

object (RecordingConfig)

Konfiguration für die Aufzeichnung.

transcriptionConfig

object (TranscriptionConfig)

Konfiguration für die automatische Transkription.

smartNotesConfig

object (SmartNotesConfig)

Konfiguration für automatische intelligente Notizen.

RecordingConfig

Konfiguration für die Aufzeichnung in einem Konferenzraum.

JSON-Darstellung
{
  "autoRecordingGeneration": enum (AutoGenerationType)
}
Felder
autoRecordingGeneration

enum (AutoGenerationType)

Gibt an, ob ein Konferenzraum automatisch aufgezeichnet wird, wenn jemand mit der Berechtigung zum Aufzeichnen an der Besprechung teilnimmt.

AutoGenerationType

Gibt an, ob im Konferenzraum automatisch ein Artefakt generiert werden kann.

Enums
AUTO_GENERATION_TYPE_UNSPECIFIED Standardwert, der durch die Nutzerrichtlinie angegeben wird. Dieser Wert sollte nie zurückgegeben werden.
ON Das Artefakt wird automatisch generiert.
OFF Das Artefakt wird nicht automatisch generiert.

TranscriptionConfig

Konfiguration für die Transkription in einem Konferenzraum.

JSON-Darstellung
{
  "autoTranscriptionGeneration": enum (AutoGenerationType)
}
Felder
autoTranscriptionGeneration

enum (AutoGenerationType)

Gibt an, ob der Inhalt einer Besprechung automatisch transkribiert wird, wenn jemand mit der Berechtigung zur Transkription an der Besprechung teilnimmt.

SmartNotesConfig

Konfiguration für intelligente Notizen in einem Konferenzraum. Weitere Informationen zu intelligenten Notizen finden Sie unter „Mach Notizen für mich“ in Google Meet.

JSON-Darstellung
{
  "autoSmartNotesGeneration": enum (AutoGenerationType)
}
Felder
autoSmartNotesGeneration

enum (AutoGenerationType)

Gibt an, ob automatisch eine Zusammenfassung und ein Recap der Besprechung für alle eingeladenen Personen in der Organisation erstellt werden sollen, wenn jemand mit der Berechtigung zum Aktivieren von intelligenten Notizen an der Besprechung teilnimmt.

ActiveConference

Aktive Konferenz.

JSON-Darstellung
{
  "conferenceRecord": string
}
Felder
conferenceRecord

string

Nur Ausgabe. Verweis auf die Ressource „ConferenceRecord“. Format: conferenceRecords/{conferenceRecord}, wobei {conferenceRecord} eine eindeutige ID für jede Instanz eines Anrufs in einem Bereich ist.

PhoneAccess

Der Telefonzugriff enthält Informationen, die zum Einwählen in eine Konferenz über eine regionale Telefonnummer und eine PIN erforderlich sind, die für diese Telefonnummer spezifisch ist.

JSON-Darstellung
{
  "phoneNumber": string,
  "pin": string,
  "regionCode": string,
  "languageCode": string
}
Felder
phoneNumber

string

Die Telefonnummer, die für diesen Konferenzraum im E.164-Format gewählt werden muss. Vollständige Telefonnummer mit einem führenden „+“-Zeichen.

pin

string

Die PIN, die Nutzer nach dem Wählen der angegebenen Nummer eingeben müssen. Die PIN besteht nur aus Dezimalziffern und die Länge kann variieren.

regionCode

string

Der CLDR-/ISO 3166-Regionscode für das Land, das mit diesem Telefonzugriff verknüpft ist. Zum Parsen durch das i18n-RegionCode-Dienstprogramm. Beispiel: „SE“ für Schweden.

languageCode

string

Der BCP 47-/LDML-Sprachcode für die Sprache, die mit diesem Telefonzugriff verknüpft ist. Wird vom i18n-Dienstprogramm „LanguageCode“ geparst. Beispiele: „es-419“ für Spanisch (Lateinamerika), „fr-CA“ für Französisch (Kanada).

GatewaySipAccess

Details zur Teilnahme an der Konferenz über ein SIP-Gateway.

JSON-Darstellung
{
  "uri": string,
  "sipAccessCode": string
}
Felder
uri

string

Der SIP-URI (Session Initiation Protocol), über den die Videokonferenz erreicht werden kann.

Der String hat eines der folgenden Formate:

Dabei ist USER_ID die 13-stellige universelle PIN (mit der zukünftigen Option, auch einen Meet-Besprechungscode zu verwenden) und GATEWAY_ADDRESS eine gültige Adresse, die über eine DNS-SRV-Suche aufgelöst werden soll, oder ein gepunktetes Quad.

sipAccessCode

string

Der permanente numerische Code für die manuelle Eingabe auf speziell konfigurierten Geräten.

Methoden

create

Erstellt einen Gruppenbereich.

endActiveConference

Beendet eine aktive Videokonferenz (falls vorhanden).

get

Ruft Details zu einem Konferenzraum ab.

patch

Aktualisiert Details zu einem Konferenzraum.