Method: createConferenceWithBots.create

회의를 만들고 봇을 추가합니다.

봇에서 요청한 동영상 해상도는 Meet 클라이언트에서 '자동'을 사용하여 요청하는 해상도를 모방합니다. 있습니다. https://support.google.com/meethardware/answer/9295022를 참고하세요.

  • numOfBots == 1인 경우: 봇이 현재 스피커에서 HD (1280x720)를 요청합니다.
  • numOfBots <ph type="x-smartling-void-element"><wbr /></ph>인 경우 6: 봇이 모든 참가자에게 VGA (640x360)를 요청합니다.
  • numOfBots <ph type="x-smartling-void-element"><wbr /></ph>인 경우 16: 봇이 모든 참가자에게 HVGA (480x270)를 요청합니다.
  • 봇이 모든 참가자에게 HQVGA (240x135)를 요청합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "numOfBots": integer,
  "ttlSecs": integer,
  "defaultBotOptions": {
    object (BotOptions)
  },
  "perBotOptions": [
    {
      object (BotOptions)
    }
  ]
}
필드
numOfBots

integer

필수 항목입니다. 추가할 봇의 수는 1~50개 사이여야 합니다.

ttlSecs

integer

필수 항목입니다. 봇이 회의에 남아 있는 데 필요한 TTL(초)

defaultBotOptions

object (BotOptions)

선택사항입니다. 이 요청의 일부로 생성된 모든 봇의 기본 옵션입니다.

perBotOptions[]

object (BotOptions)

선택사항입니다. 이 요청의 일부로 생성된 봇의 봇별 옵션입니다. 봇 수보다 적은 옵션이 제공될 경우 나머지 봇에는 기본 옵션이 사용됩니다.

응답 본문

{@link CreateConferenceWithBotsRequest}에 대한 응답

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "conferenceCode": string,
  "errorMessages": [
    string
  ]
}
필드
conferenceCode

string

생성된 회의입니다.

errorMessages[]

string

실패한 봇에서 반환한 오류 메시지입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

BotOptions

개별 봇 전용 옵션

JSON 표현
{
  "requestedResolution": enum (SupportedVideoResolutions),
  "muteAudio": boolean,
  "muteVideo": boolean,
  "playbackVideo": enum (VideoFile),
  "outputResolution": enum (SupportedVideoResolutions)
}
필드
requestedResolution

enum (SupportedVideoResolutions)

선택사항입니다. 봇에서 수신한 해결 방법을 요청했습니다.

muteAudio

boolean

선택사항입니다. 봇에서 보낸 오디오 음소거, 기본값은 False

muteVideo

boolean

선택사항입니다. 봇에서 보낸 동영상 음소거, 기본값은 False

playbackVideo

enum (VideoFile)

선택사항입니다. 봇이 재생해야 하는 동영상 파일입니다.

outputResolution

enum (SupportedVideoResolutions)

선택사항입니다. 봇이 보낸 발신 동영상 해상도인 경우 이 해상도와 일치하는 재생 동영상을 선택합니다. PlaybackVideo가 설정되지 않은 경우에만 사용됩니다.

SupportedVideoResolutions

지원되는 동영상 해상도 사전 설정

열거형
SUPPORTED_VIDEO_RESOLUTIONS_UNSPECIFIED 해상도 미지정
THUMBNAIL_160_120 썸네일 해상도
QVGA_320_180 16:9 비율의 QVGA 해상도
HVGA_480_270 16:9 비율의 HVGA 해상도
VGA_640_360 16:9 비율의 VGA 해상도
HD_1280_720 16:9 비율의 HD 해상도
FHD_1920_1080 16:9 비율의 FHD 해상도

VideoFile

외부 파트너에게 지원되는 재생 동영상

열거형
VIDEO_FILE_UNSPECIFIED 파일 미지정
SINGLE_ATTENDEE_IDLE_1 자리 비움 상태인 단일 회의 참석자
SINGLE_ATTENDEE_CLAPPING_1 박수 치는 회의 참석자 한 명