Method: createConferenceWithBots.create

Crée une conférence et ajoute des bots.

La résolution vidéo demandée par les bots correspond à la résolution qui serait demandée par un client Meet avec l'option "Automatique". mise en page. Consultez la page https://support.google.com/meethardware/answer/9295022.

  • Si numOfBots == 1: les bots demanderont une HD (1 280 x 720) au participant actif.
  • si numOfBots < 6: les bots demanderont un VGA (640 x 360) à tous les participants.
  • si numOfBots < 16: les bots demanderont l'autorisation HVGA (480 x 270) à tous les participants.
  • Sinon, les bots demanderont HQVGA (240 x 135) à tous les participants.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "numOfBots": integer,
  "ttlSecs": integer,
  "defaultBotOptions": {
    object (BotOptions)
  },
  "perBotOptions": [
    {
      object (BotOptions)
    }
  ]
}
Champs
numOfBots

integer

Obligatoire. Le nombre de bots à ajouter doit être compris entre 1 et 50.
ttlSecs

integer

Obligatoire. Valeur TTL (Time To Live) en secondes pour que les bots restent dans la réunion.
defaultBotOptions

object (BotOptions)

Facultatif. Options par défaut pour tous les bots créés dans le cadre de cette demande.
perBotOptions[]

object (BotOptions)

Facultatif. Options par bot pour les bots créés dans le cadre de cette requête. Si le nombre d'options proposées est inférieur au nombre de bots, les options par défaut seront utilisées pour les bots restants.

Corps de la réponse

Réponse à {@link CreateConferenceWithBotsRequest}

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "conferenceCode": string,
  "errorMessages": [
    string
  ]
}
Champs
conferenceCode

string

Conférence créée.
errorMessages[]

string

Messages d'erreur renvoyés par les bots ayant échoué.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

BotOptions

Options spécifiques aux bots individuels

Représentation JSON 
{
  "requestedResolution": enum (SupportedVideoResolutions),
  "muteAudio": boolean,
  "muteVideo": boolean,
  "playbackVideo": enum (VideoFile),
  "outputResolution": enum (SupportedVideoResolutions)
}
Champs
requestedResolution

enum (SupportedVideoResolutions)

Facultatif. Résolution demandée par les bots.
muteAudio

boolean

Facultatif. Couper le son du micro envoyé par le bot (option par défaut "False")
muteVideo

boolean

Facultatif. Couper le son de la vidéo envoyée par le bot (option par défaut "False")
playbackVideo

enum (VideoFile)

Facultatif. Fichier vidéo que le bot doit lire
outputResolution

enum (SupportedVideoResolutions)

Facultatif. Résolution vidéo sortante envoyée par les robots. Sélectionnez une vidéo de lecture correspondant à cette résolution. N'est utilisé que si "playVideo" n'est pas défini.

SupportedVideoResolutions

Préréglages des résolutions vidéo compatibles

Enums
SUPPORTED_VIDEO_RESOLUTIONS_UNSPECIFIED Résolution non spécifiée
THUMBNAIL_160_120 Résolution de la miniature
QVGA_320_180 Résolution QVGA au format 16:9
HVGA_480_270 Résolution HVGA au format 16:9
VGA_640_360 Résolution VGA au format 16:9
HD_1280_720 Résolution HD au format 16:9
FHD_1920_1080 Résolution FHD au format 16:9

VideoFile

Vidéos de lecture compatibles avec les partenaires externes

Enums
VIDEO_FILE_UNSPECIFIED Fichier non spécifié
SINGLE_ATTENDEE_IDLE_1 Un seul participant à une réunion reste inactif
SINGLE_ATTENDEE_CLAPPING_1 Applaudissement d'un participant à la réunion