Method: createConferenceWithBots.create

יצירה של שיחת ועידה והוספה של בוטים.

רזולוציית הווידאו שהבוטים מבקשים מחקה את הרזולוציה שנשלחה על ידי הלקוח ב-Meet באמצעות הפריסה שלו. פרטים נוספים זמינים בכתובת https://support.google.com/meethardware/answer/9295022.

  • if numOfBots == 1: הבוטים יבקשו מהדובר הפעיל לבקש איכות HD (1280x720).
  • אם numOfBots < 6: הבוטים יבקשו מכל המשתתפים את שיטת VGA (640x360).
  • אם numOfBots < 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)

זה שינוי אופציונלי. ברזולוציית וידאו יוצאת שנשלח על ידי הבוטים. המערכת תבחר סרטון הפעלה שתואם לרזולוציה הזו. אפשר להשתמש באפשרות הזו רק אם לא מגדירים את playVideo.

SupportedVideoResolutions

הגדרות קבועות מראש שנתמכות ברזולוציות וידאו

טיפוסים בני מנייה (enum)
SUPPORTED_VIDEO_RESOLUTIONS_UNSPECIFIED לא צוינה רזולוציה
THUMBNAIL_160_120 רזולוציית התמונה הממוזערת
QVGA_320_180 רזולוציית QVGA ביחס של 16:9
HVGA_480_270 רזולוציית HVGA ביחס של 16:9
VGA_640_360 רזולוציית VGA ביחס של 16:9
HD_1280_720 רזולוציית HD ביחס גובה-רוחב של 16:9
FHD_1920_1080 רזולוציית FHD ביחס גובה-רוחב של 16:9

VideoFile

תמיכה בסרטוני הפעלה לשותפים חיצוניים

טיפוסים בני מנייה (enum)
VIDEO_FILE_UNSPECIFIED הקובץ לא צוין
SINGLE_ATTENDEE_IDLE_1 משתתף אחד בפגישה יושב לא פעיל
SINGLE_ATTENDEE_CLAPPING_1 משתתף בפגישה מוחא כפיים