Method: createConferenceWithBots.create

Creates a conference and adds bots.

The video resolution requested by the bots mimics the resolution that would be requested by a Meet client using the "Auto" layout. See https://support.google.com/meethardware/answer/9295022.

  • if numOfBots == 1: bots will request HD (1280x720) from the active speaker.
  • if numOfBots < 6: bots will request VGA (640x360) from all participants.
  • if numOfBots < 16: bots will request HVGA (480x270) from all participants.
  • otherwise: bots will request HQVGA (240x135) from all participants.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
{
  "numOfBots": integer,
  "ttlSecs": integer,
  "defaultBotOptions": {
    object (BotOptions)
  }
}
Fields
numOfBots

integer

Required. The number of bots to add, must be between 1 - 50.

ttlSecs

integer

Required. TTL in seconds for the bots to stay in the meeting.

defaultBotOptions

object (BotOptions)

Optional. Default options for all bots created as part of this request.

Response body

Response for {@link CreateConferenceWithBotsRequest}

If successful, the response body contains data with the following structure:

JSON representation
{
  "conferenceCode": string,
  "errorMessages": [
    string
  ]
}
Fields
conferenceCode

string

The created conference.

errorMessages[]

string

The error messages returned by the failed bots.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

BotOptions

Options specific to individual bots

JSON representation
{
  "requestedResolution": enum (SupportedVideoResolutions),
  "muteAudio": boolean,
  "muteVideo": boolean
}
Fields
requestedResolution

enum (SupportedVideoResolutions)

Optional. Incoming resolution requested by the bots.

muteAudio

boolean

Optional. Mute audio sent from bot, default False

muteVideo

boolean

Optional. Mute video sent from bot, default False

SupportedVideoResolutions

Supported video resolutions presets

Enums
SUPPORTED_VIDEO_RESOLUTIONS_UNSPECIFIED Resolution unspecified
THUMBNAIL_160_120 Thumbnail resolution
QVGA_320_180 QVGA resolution at 16:9 ratio
HVGA_480_270 HVGA resolution at 16:9 ratio
VGA_640_360 VGA resolution at 16:9 ratio
HD_1280_720 HD resolution at 16:9 ratio
FHD_1920_1080 FHD resolution at 16:9 ratio