REST Resource: spaces

Zasób: Space

Wirtualne miejsce, w którym odbywają się konferencje. W danym momencie w jednej przestrzeni może się odbywać tylko jedna aktywna rozmowa wideo.

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

string

Niezmienna. Nazwa zasobu pokoju.

Format: spaces/{space}.

{space} to identyfikator zasobu miejsca. Jest to unikalny identyfikator generowany przez serwer, w którym wielkość liter ma znaczenie. Na przykład: jQCFfuBOdN5z.

Więcej informacji znajdziesz w artykule Jak Meet identyfikuje pomieszczenie do spotkań.

meetingUri

string

Tylko dane wyjściowe. Identyfikator URI używany do dołączania do spotkań składający się z https://meet.google.com/, a następnie z meetingCode. Na przykład: https://meet.google.com/abc-mnop-xyz.

meetingCode

string

Tylko dane wyjściowe. Przyjazny, niepowtarzalny ciąg znaków używany do dołączania do spotkania.

Format: [a-z]+-[a-z]+-[a-z]+. Na przykład: abc-mnop-xyz.

Maksymalna długość to 128 znaków.

Może być używana tylko jako alias nazwy pokoju do uzyskiwania dostępu do pokoju.

config

object (SpaceConfig)

Konfiguracja dotycząca pokoju spotkań.

activeConference

object (ActiveConference)

aktywną konferencję (jeśli istnieje);

phoneAccess[]

object (PhoneAccess)

Tylko dane wyjściowe. Wszystkie regionalne metody dostępu telefonicznego do tego miejsca spotkań. Może być puste.

gatewaySipAccess[]

object (GatewaySipAccess)

Tylko dane wyjściowe. Metody dostępu oparte na protokole SIP, których można użyć do dołączenia do konferencji. Może być puste.

SpaceConfig

Konfiguracja dotycząca miejsca spotkania.

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

enum (AccessType)

Typ dostępu do miejsca spotkania, który określa, kto może dołączyć bez wysyłania prośby o dołączenie. Domyślne: domyślne ustawienia dostępu użytkownika. Jest kontrolowana przez administratora użytkownika w przypadku użytkowników wersji Enterprise lub ma wartość OGRANICZONA.

entryPointAccess

enum (EntryPointAccess)

Określa punkty wejścia, których można używać do dołączania do spotkań hostowanych w tej przestrzeni do spotkań. Wartość domyślna: EntryPointAccess.ALL

moderation

enum (Moderation)

Wstępnie skonfigurowany tryb moderowania spotkania. Domyślnie: kontrolowane przez zasady użytkownika.

moderationRestrictions

object (ModerationRestrictions)

Gdy moderowanie jest WŁĄCZONE, te ograniczenia zaczynają obowiązywać w przypadku spotkania. Gdy moderation.OFF, zostanie przywrócony do domyślnych wartości ModerationRestrictions.

attendanceReportGenerationType

enum (AttendanceReportGenerationType)

Określa, czy w przypadku przestrzeni spotkań włączony jest raport o obecności.

artifactConfig

object (ArtifactConfig)

Konfiguracja dotycząca artefaktów generowanych automatycznie, które są obsługiwane przez spotkanie.

AccessType

Możliwe typy dostępu do miejsca spotkań.

Wartości w polu enum
ACCESS_TYPE_UNSPECIFIED Wartość domyślna określona przez organizację użytkownika. Uwaga: ta wartość nigdy nie jest zwracana, ponieważ zamiast niej zwracany jest skonfigurowany typ dostępu.
OPEN Każda osoba, która ma informacje umożliwiające dołączenie (np. adres URL lub informacje o dostępie telefonicznym), może dołączyć bez wysyłania prośby o dołączenie.
TRUSTED Członkowie organizacji organizatora, zaproszeni użytkownicy zewnętrzni i użytkownicy korzystający z połączenia telefonicznego mogą dołączyć bez pukania. Wszystkie pozostałe osoby muszą zapukać.
RESTRICTED Tylko zaproszone osoby mogą dołączyć bez pukania. Wszystkie pozostałe osoby muszą zapukać.

EntryPointAccess

Punkty wejścia, których można użyć do dołączenia do spotkania. Przykład: meet.google.com, pakiet SDK do umieszczania Meet w internecie lub aplikacja mobilna.

Wartości w polu enum
ENTRY_POINT_ACCESS_UNSPECIFIED Nieużywane.
ALL Wszystkie punkty wejścia są dozwolone.
CREATOR_APP_ONLY Do dołączania do spotkań w tej przestrzeni można używać tylko punktów wejścia należących do projektu w chmurze Google, który utworzył tę przestrzeń. Aplikacje mogą używać pakietów SDK Meet do umieszczania w wersji na przeglądarki lub urządzenia mobilne, aby tworzyć własne punkty wejścia.

Moderowanie

Tryb moderowania spotkania. Gdy tryb moderacji jest włączony, właściciel spotkania ma większą kontrolę nad spotkaniem dzięki funkcjom takim jak zarządzanie współgospodarzami (patrz wiadomość Member) i ograniczenia funkcji (patrz wiadomość ModerationRestrictions).

Wartości w polu enum
MODERATION_UNSPECIFIED Nie określono typu moderacji. Służy do wskazywania, że użytkownik nie podał żadnej wartości, ponieważ nie zamierza aktualizować stanu. Użytkownicy nie mogą ustawić wartości jako nieokreślonej.
OFF Moderowanie jest wyłączone.
ON Moderowanie jest włączone.

ModerationRestrictions

Określa ograniczenia dotyczące funkcji, gdy spotkanie jest moderowane.

Zapis JSON
{
  "chatRestriction": enum (RestrictionType),
  "reactionRestriction": enum (RestrictionType),
  "presentRestriction": enum (RestrictionType),
  "defaultJoinAsViewerType": enum (DefaultJoinAsViewerType)
}
Pola
chatRestriction

enum (RestrictionType)

Określa, kto ma uprawnienia do wysyłania wiadomości na czacie w pokoju spotkań.

reactionRestriction

enum (RestrictionType)

Określa, kto ma uprawnienia do wysyłania reakcji w przestrzeni spotkania.

presentRestriction

enum (RestrictionType)

Określa, kto ma uprawnienia do udostępniania ekranu w pokoju spotkań.

defaultJoinAsViewerType

enum (DefaultJoinAsViewerType)

Określa, czy ograniczyć domyślną rolę przypisaną użytkownikom jako przeglądającym.

RestrictionType

Określa, kto ma uprawnienia do korzystania z danej funkcji.

Wartości w polu enum
RESTRICTION_TYPE_UNSPECIFIED Wartość domyślna określona przez zasady użytkownika. Nie powinno to nigdy zostać zwrócone.
HOSTS_ONLY Właściciel spotkania i współgospodarz mają uprawnienia.
NO_RESTRICTION Wszyscy uczestnicy mają uprawnienia.

DefaultJoinAsViewerType

Domyślnie użytkownicy dołączają jako współtwórcy. Gospodarze mogą ograniczyć możliwość dołączania użytkowników jako widzów. Uwaga: jeśli w zasobie Członek jest ustawiona jawna rola użytkownika, użytkownik dołączy do projektu z tą rolą.

Wartości w polu enum
DEFAULT_JOIN_AS_VIEWER_TYPE_UNSPECIFIED Wartość domyślna określona przez zasady użytkownika. Nie powinno to nigdy zostać zwrócone.
ON Użytkownicy będą domyślnie dołączać jako przeglądający.
OFF Użytkownicy będą domyślnie dołączać jako współtwórcy.

AttendanceReportGenerationType

Możliwe stany włączenia raportu o obecności w przypadku miejsca spotkania.

Wartości w polu enum
ATTENDANCE_REPORT_GENERATION_TYPE_UNSPECIFIED Wartość domyślna określona przez zasady użytkownika. Nie powinno to nigdy zostać zwrócone.
GENERATE_REPORT Raport o obecności zostanie wygenerowany i wysłany na Dysk lub e-mailem.
DO_NOT_GENERATE Raport o obecności nie zostanie wygenerowany.

ArtifactConfig

Konfiguracja związana z artefaktami spotkań, które mogą być generowane w tym pokoju spotkań.

Zapis JSON
{
  "recordingConfig": {
    object (RecordingConfig)
  },
  "transcriptionConfig": {
    object (TranscriptionConfig)
  },
  "smartNotesConfig": {
    object (SmartNotesConfig)
  }
}
Pola
recordingConfig

object (RecordingConfig)

Konfiguracja nagrywania.

transcriptionConfig

object (TranscriptionConfig)

Konfiguracja automatycznej transkrypcji.

smartNotesConfig

object (SmartNotesConfig)

Konfiguracja automatycznych inteligentnych notatek.

RecordingConfig

Konfiguracja związana z nagrywaniem w pokoju spotkań.

Zapis JSON
{
  "autoRecordingGeneration": enum (AutoGenerationType)
}
Pola
autoRecordingGeneration

enum (AutoGenerationType)

Określa, czy pokój spotkań jest automatycznie nagrywany, gdy do spotkania dołączy osoba z uprawnieniami do nagrywania.

AutoGenerationType

Określa, czy w przestrzeni spotkania można automatycznie generować artefakty.

Wartości w polu enum
AUTO_GENERATION_TYPE_UNSPECIFIED Wartość domyślna określona przez zasady użytkownika. Nie powinno to nigdy zostać zwrócone.
ON Artefakt jest generowany automatycznie.
OFF Artefakt nie jest generowany automatycznie.

TranscriptionConfig

Konfiguracja związana z transkrypcją w pokoju spotkań.

Zapis JSON
{
  "autoTranscriptionGeneration": enum (AutoGenerationType)
}
Pola
autoTranscriptionGeneration

enum (AutoGenerationType)

Określa, czy treść spotkania ma być automatycznie transkrybowana, gdy dołączy do niego osoba z uprawnieniami do tworzenia transkrypcji.

SmartNotesConfig

Konfiguracja związana z inteligentnymi notatkami w pokoju spotkań. Więcej informacji o inteligentnych notatkach znajdziesz w artykule Funkcja „Zrób notatki” w Google Meet.

Zapis JSON
{
  "autoSmartNotesGeneration": enum (AutoGenerationType)
}
Pola
autoSmartNotesGeneration

enum (AutoGenerationType)

Określa, czy automatycznie generować podsumowanie i streszczenie spotkania dla wszystkich zaproszonych osób w organizacji, gdy do spotkania dołączy osoba z uprawnieniami do włączania inteligentnych notatek.

ActiveConference

Aktywna konferencja.

Zapis JSON
{
  "conferenceRecord": string
}
Pola
conferenceRecord

string

Tylko dane wyjściowe. Odniesienie do zasobu „ConferenceRecord”. Format: conferenceRecords/{conferenceRecord}, gdzie {conferenceRecord} to unikalny identyfikator każdego połączenia w przestrzeni.

PhoneAccess

Dostęp przez telefon zawiera informacje wymagane do dołączenia do konferencji przy użyciu regionalnego numeru telefonu i kodu PIN przypisanego do tego numeru.

Zapis JSON
{
  "phoneNumber": string,
  "pin": string,
  "regionCode": string,
  "languageCode": string
}
Pola
phoneNumber

string

Numer telefonu, pod który można zadzwonić, aby połączyć się z tym miejscem spotkań. Numer musi być w formacie E.164. Pełny numer telefonu z początkowym znakiem „+”.

pin

string

Kod PIN, który użytkownicy muszą wpisać po wybraniu danego numeru. Kod PIN składa się tylko z cyfr dziesiętnych, a jego długość może być różna.

regionCode

string

Kod regionu CLDR/ISO 3166 kraju powiązanego z tym dostępem do telefonu. Do analizowania przez narzędzie i18n RegionCode. Przykład: „SE” w przypadku Szwecji.

languageCode

string

Kod języka BCP 47/LDML dla języka powiązanego z tym dostępem do telefonu. Do analizy przez narzędzie LanguageCode i18n. Przykłady: „es-419” w przypadku hiszpańskiego w Ameryce Łacińskiej, „fr-CA” w przypadku francuskiego w Kanadzie.

GatewaySipAccess

Szczegółowe informacje o tym, jak dołączyć do konferencji za pomocą bramy SIP.

Zapis JSON
{
  "uri": string,
  "sipAccessCode": string
}
Pola
uri

string

Identyfikator URI protokołu SIP, za pomocą którego można dołączyć do konferencji.

Ciąg znaków jest w jednym z tych formatów:

gdzie USER_ID to 13-cyfrowy uniwersalny numer PIN (w przyszłości będzie można też używać kodu spotkania w Meet), a GATEWAY_ADDRESS to prawidłowy adres, który ma zostać rozpoznany za pomocą wyszukiwania DNS SRV lub w formacie dotted quad.

sipAccessCode

string

Stały kod numeryczny do ręcznego wpisywania na specjalnie skonfigurowanych urządzeniach.

Metody

create

Tworzy pokój.

endActiveConference

Kończy aktywną konferencję (jeśli taka istnieje).

get

Pobiera szczegóły dotyczące miejsca spotkania.

patch

Aktualizuje szczegóły miejsca spotkania.