Method: createConferenceWithBots.create

Crea una conferenza e aggiunge i bot.

La risoluzione video richiesta dai bot imita quella che sarebbe richiesta da un client Meet utilizzando il menu layout. Visita la pagina https://support.google.com/meethardware/answer/9295022.

  • if numOfBots == 1: i bot richiedono la risoluzione HD (1280x720) dall'altoparlante attivo.
  • se numOfBots < 6: i bot richiederanno VGA (640x360) a tutti i partecipanti.
  • se numOfBots < 16: i bot richiederanno HVGA (480x270) a tutti i partecipanti.
  • altrimenti: i bot richiederanno HQVGA (240x135) a tutti i partecipanti.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "numOfBots": integer,
  "ttlSecs": integer,
  "defaultBotOptions": {
    object (BotOptions)
  },
  "perBotOptions": [
    {
      object (BotOptions)
    }
  ]
}
Campi
numOfBots

integer

Obbligatorio. Il numero di bot da aggiungere deve essere compreso tra 1 e 50.
ttlSecs

integer

Obbligatorio. TTL in secondi che i bot devono rimanere nella riunione.
defaultBotOptions

object (BotOptions)

(Facoltativo) Opzioni predefinite per tutti i bot creati nell'ambito di questa richiesta.
perBotOptions[]

object (BotOptions)

(Facoltativo) Opzioni per bot per i bot creati nell'ambito di questa richiesta. Se vengono fornite meno opzioni rispetto al numero di bot, per i bot rimanenti verranno utilizzate le opzioni predefinite.

Corpo della risposta

Risposta per {@link CreateConferenceWithBotsRequest}

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "conferenceCode": string,
  "errorMessages": [
    string
  ]
}
Campi
conferenceCode

string

La conferenza creata.
errorMessages[]

string

I messaggi di errore restituiti dai bot non riusciti.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

BotOptions

Opzioni specifiche per i singoli bot

Rappresentazione JSON 
{
  "requestedResolution": enum (SupportedVideoResolutions),
  "muteAudio": boolean,
  "muteVideo": boolean,
  "playbackVideo": enum (VideoFile),
  "outputResolution": enum (SupportedVideoResolutions)
}
Campi
requestedResolution

enum (SupportedVideoResolutions)

(Facoltativo) Risoluzione in arrivo richiesta dai bot.
muteAudio

boolean

(Facoltativo) Disattiva l'audio inviato dal bot (falso predefinito)
muteVideo

boolean

(Facoltativo) Disattiva l'audio del video inviato dal bot (falso predefinito)
playbackVideo

enum (VideoFile)

(Facoltativo) Il file video che il bot deve riprodurre
outputResolution

enum (SupportedVideoResolutions)

(Facoltativo) La risoluzione video in uscita inviata dai bot, selezionerà un video in riproduzione corrispondente a questa risoluzione. Viene utilizzato solo se la riproduzione Video non è impostata.

SupportedVideoResolutions

Preimpostazioni per le risoluzioni video supportate

Enum
SUPPORTED_VIDEO_RESOLUTIONS_UNSPECIFIED Risoluzione non specificata
THUMBNAIL_160_120 Risoluzione miniatura
QVGA_320_180 Risoluzione QVGA in proporzioni 16:9
HVGA_480_270 Risoluzione HVGA in proporzioni 16:9
VGA_640_360 Risoluzione VGA in formato 16:9
HD_1280_720 Risoluzione HD in formato 16:9
FHD_1920_1080 Risoluzione FHD in formato 16:9

VideoFile

Riproduzione di video supportati per partner esterni

Enum
VIDEO_FILE_UNSPECIFIED File non specificato
SINGLE_ATTENDEE_IDLE_1 Partecipante a una singola riunione seduto inattivo
SINGLE_ATTENDEE_CLAPPING_1 Partecipanti alla riunione singola che applaudono