LiveBroadcasts

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

Methods

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

list

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

insert

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

עדכון

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

מחיקה

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

bind

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

transition

שינוי הסטטוס של שידור חי ב-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,
      }
    }
  }
}

מאפיינים

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