LiveBroadcasts

یک منبع liveBroadcast رویدادی را نشان می‌دهد که از طریق ویدیوی زنده در YouTube پخش می‌شود.

روش ها

API از روش های زیر برای منابع liveBroadcasts پشتیبانی می کند:

list

فهرستی از پخش‌های YouTube را برمی‌گرداند که با پارامترهای درخواست API مطابقت دارند. اکنون آن را امتحان کنید .

insert

پخش ایجاد می کند. اکنون آن را امتحان کنید .

update

پخش را به روز می کند. به عنوان مثال، می توانید تنظیمات پخش تعریف شده در شیء contentDetails منبع liveBroadcast را تغییر دهید. اکنون آن را امتحان کنید .

delete

پخش را حذف می کند. اکنون آن را امتحان کنید .

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,
      }
    }
  }
}

خواص

جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند: