Method: createConferenceWithBots.create

Erstellt eine Konferenz und fügt Bots hinzu.

Die von den Bots angeforderte Videoauflösung entspricht der Auflösung, die von einem Meet-Client über die Funktion „Automatisch“ gefordert wird. Layout. Weitere Informationen finden Sie unter https://support.google.com/meethardware/answer/9295022.

  • if numOfBots == 1: Bots fordern HD (1280 × 720) vom aktiven Sprecher an.
  • wenn „numOfBots“ < 6: Bots fordern von allen Teilnehmern VGA (640 x 360) an.
  • wenn „numOfBots“ < 16: Bots fordern von allen Teilnehmern HVGA (480 x 270) an.
  • Andernfalls fordern Bots von allen Teilnehmern HQVGA (240 x 135) an.

HTTP-Anfrage

POST https://botsondemand.googleapis.com/v1/createConferenceWithBots

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "numOfBots": integer,
  "ttlSecs": integer,
  "defaultBotOptions": {
    object (BotOptions)
  },
  "perBotOptions": [
    {
      object (BotOptions)
    }
  ]
}
Felder
numOfBots

integer

Erforderlich. Die Anzahl der hinzuzufügenden Bots muss zwischen 1 und 50 liegen.
ttlSecs

integer

Erforderlich. Gültigkeitsdauer (TTL) in Sekunden für die Teilnahme der Bots in der Besprechung
defaultBotOptions

object (BotOptions)

Optional. Standardoptionen für alle Bots, die im Rahmen dieser Anfrage erstellt wurden.
perBotOptions[]

object (BotOptions)

Optional. Optionen pro Bot für Bots, die im Rahmen dieser Anfrage erstellt wurden. Wenn weniger Optionen angegeben werden als die Anzahl der Bots, werden für die verbleibenden Bots die Standardoptionen verwendet.

Antworttext

Antwort für {@link CreateConferenceWithBotsRequest}

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "conferenceCode": string,
  "errorMessages": [
    string
  ]
}
Felder
conferenceCode

string

Die erstellte Konferenz.
errorMessages[]

string

Die von den fehlerhaften Bots zurückgegebenen Fehlermeldungen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/meetings

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

BotOptions

Spezifische Bot-Optionen

JSON-Darstellung 
{
  "requestedResolution": enum (SupportedVideoResolutions),
  "muteAudio": boolean,
  "muteVideo": boolean,
  "playbackVideo": enum (VideoFile),
  "outputResolution": enum (SupportedVideoResolutions)
}
Felder
requestedResolution

enum (SupportedVideoResolutions)

Optional. Die Bots wurden aufgefordert, eine Lösung zu finden.
muteAudio

boolean

Optional. Vom Bot gesendetes Audio stummschalten, Standardeinstellung: „False“
muteVideo

boolean

Optional. Vom Bot gesendetes Video stummschalten, Standardeinstellung: „False“
playbackVideo

enum (VideoFile)

Optional. Die Videodatei, die der Bot abspielen soll
outputResolution

enum (SupportedVideoResolutions)

Optional. Auflösung für ausgehende Videos, die von den Bots gesendet werden; wählt ein Wiedergabevideo mit dieser Auflösung aus. Diese Option wird nur verwendet, wenn „playVideo“ nicht festgelegt ist.

SupportedVideoResolutions

Unterstützte Voreinstellungen für Videoauflösungen

Enums
SUPPORTED_VIDEO_RESOLUTIONS_UNSPECIFIED Lösung nicht angegeben
THUMBNAIL_160_120 Auflösung der Miniaturansicht
QVGA_320_180 QVGA-Auflösung bei Seitenverhältnis 16:9
HVGA_480_270 HVGA-Auflösung bei Bildverhältnis 16:9
VGA_640_360 VGA-Auflösung bei Bildverhältnis 16:9
HD_1280_720 HD-Auflösung bei Bildverhältnis 16:9
FHD_1920_1080 FHD-Auflösung mit Bildverhältnis 16:9

VideoFile

Unterstützte Wiedergabevideos für externe Partner

Enums
VIDEO_FILE_UNSPECIFIED Datei nicht angegeben
SINGLE_ATTENDEE_IDLE_1 Einzelner Besprechungsteilnehmer, der inaktiv ist
SINGLE_ATTENDEE_CLAPPING_1 Applaus bei einer einzelnen Besprechung