LiveBroadcasts

משאב liveBroadcast מייצג אירוע שישודר ב-YouTube בשידור חי.

שיטות

ה-API תומך בשיטות הבאות למשאבי liveBroadcasts:

list

מחזירה רשימה של שידורים ב-YouTube שתואמים לפרמטרים של בקשת ה-API. כדאי לנסות עכשיו.

insert

יצירת שידור. כדאי לנסות עכשיו.

עדכון

עדכון שידור. לדוגמה, אפשר לשנות את הגדרות השידור שמוגדרות באובייקט contentDetails של המשאב liveBroadcast. רוצים לנסות?

מחיקה

מחיקת שידור. כדאי לנסות עכשיו.

bind

מקשר שידור ב-YouTube לסטרימינג או מסיר קישור קיים בין שידור לסטרימינג. שידור יכול להיות קשור רק לשידור וידאו אחד, אבל שידור וידאו יכול להיות קשור למספר שידורים. כדאי לנסות עכשיו.

מעבר

שינוי הסטטוס של שידור חי ב-YouTube והפעלת תהליכים שקשורים לסטטוס החדש. לדוגמה, כשמשנים את הסטטוס של שידור ל-testing, YouTube מתחיל לשדר וידאו לסטרימינג של השידור הזה. לפני שמפעילים את השיטה הזו, צריך לוודא שהערך של המאפיין status.streamStatus של הסטרימינג שמקושר לשידור הוא active. רוצים לנסות עכשיו?

cuepoint

הוספת נקודת סימון לשידור חי. נקודת הצירוף עשויה להפעיל הפסקה למודעה.

ייצוג משאבים

המבנה הבא של JSON מציג את הפורמט של משאב liveBroadcasts:

{
  "kind": "youtube#liveBroadcast",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "isDefaultBroadcast": boolean,
    "liveChatId": string
  },
  "status": {
    "lifeCycleStatus": string,
    "privacyStatus": string,
    "recordingStatus": string,
    "madeForKids": string,
    "selfDeclaredMadeForKids": string,
  },
  "contentDetails": {
    "boundStreamId": string,
    "boundStreamLastUpdateTimeMs": datetime,
    "monitorStream": {
      "enableMonitorStream": boolean,
      "broadcastStreamDelayMs": unsigned integer,
      "embedHtml": string
    },
    "enableEmbed": boolean,
    "enableDvr": boolean,
    "recordFromStart": boolean,
    "enableClosedCaptions": boolean,
    "closedCaptionsType": string,
    "projection": string,
    "enableLowLatency": boolean,
    "latencyPreference": boolean,
    "enableAutoStart": boolean,
    "enableAutoStop": boolean
  },
  "statistics": {
    "totalChatCount": unsigned long
  },
  "monetizationDetails": {
      "cuepointSchedule": {
        "enabled": boolean,
        "pauseAdsUntil": datetime,
        "scheduleStrategy": string,
        "repeatIntervalSecs": unsigned integer,
      }
    }
  }
}

מאפיינים

בטבלה הבאה מפורטים המאפיינים שמופיעים במשאב הזה: