LiveBroadcasts: insert

API artık canlı yayınlarınızı "çocuklara özel" olarak işaretleme özelliğini destekliyor. liveBroadcast kaynağı ise artık canlı yayının "çocuklara özel" durumunu tanımlayan bir özellik içeriyor. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları da 10 Ocak 2020'de güncellendi. Daha fazla bilgi için YouTube Live Streaming API Hizmeti ve YouTube API Hizmetleri Hizmet Şartları'nın düzeltme geçmişlerine bakın.

Yayın oluşturur.

Yaygın kullanım alanları

İstek

HTTP isteği

POST https://www.googleapis.com/youtube/v3/liveBroadcasts

Yetkilendirme

Bu istek için aşağıdaki kapsamların en az biriyle yetkilendirme yapılması gerekir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

Kapsam
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametreler

Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen tüm parametreler sorgu parametreleridir.

Parametreler
Gerekli parametreler
part string
part parametresi bu işlemde iki amaca hizmet eder. Yazma işleminin ayarlayacağı mülkleri ve API yanıtının içereceği mülkleri tanımlar.

Parametre değerine ekleyebileceğiniz part mülkleri şunlardır: id, snippet, contentDetails ve status.
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube İçerik Yönetim Sistemi kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalının sahibi olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahipleri, bu özellik sayesinde bir kez kimlik doğrulama yaparak tüm video ve kanal verilerine erişebilir. Her kanal için ayrı ayrı kimlik doğrulama bilgileri sağlamaları gerekmez. Kullanıcının kimlik doğrulaması için kullandığı CMS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.
onBehalfOfContentOwnerChannel string
Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir. Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır.

onBehalfOfContentOwnerChannel parametresi, videonun eklendiği kanalın YouTube kanal kimliğini belirtir. Bu parametre, bir istekte onBehalfOfContentOwner parametresi için değer belirtildiğinde gereklidir ve yalnızca bu parametreyle birlikte kullanılabilir. Ayrıca, istek, onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı bir İçerik Yönetim Sistemi hesabı kullanılarak yetkilendirilmelidir. Son olarak, onBehalfOfContentOwnerChannel parametre değerinin belirttiği kanal, onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı olmalıdır.

Bu parametre, birçok farklı YouTube kanalının sahibi olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. Bu sayede içerik sahipleri, her bir kanal için ayrı ayrı kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimlik doğrulayabilir ve parametre değerinde belirtilen kanal adına işlemler gerçekleştirebilir.

İstek metni

İstek gövdesinde bir liveBroadcast kaynağı sağlayın. Bu kaynak için:

  • Şu özellikler için bir değer belirtmeniz gerekir:

    • snippet.title
    • snippet.scheduledStartTime
    • status.privacyStatus

  • Bu özellikler için değerler ayarlayabilirsiniz:

    • snippet.title
    • snippet.description
    • snippet.categoryId
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • status.selfDeclaredMadeForKids
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.availabilityConfig
    Not: Özellik tablosunda, listelenen özellikler için ayarlanan tüm varsayılan değerler belgelenir. Varsayılan değerler aşağıdaki durumlardan birinde atanır:
    • Bu özellikler için değer belirtmezsiniz.
    • İsteğinizdeki part parametre değeri, bu özellikleri içeren bölümü belirtmiyor.

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir liveBroadcast kaynağı döndürür.

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için hata mesajı belgelerini inceleyin.

Hata türü Hata ayrıntısı Açıklama
insufficientPermissions insufficientLivePermissions İstek, canlı yayın oluşturma yetkisine sahip değil.
insufficientPermissions livePermissionBlocked İsteği yetkilendiren kullanıcı şu anda YouTube'da canlı video yayını yapamıyor. Kullanıcının neden canlı video yayını yapamadığını açıklayan ayrıntılar, kullanıcının https://www.youtube.com/features adresindeki kanal ayarlarında bulunabilir.
insufficientPermissions liveStreamingNotEnabled İsteği yetkilendiren kullanıcının YouTube'da canlı video yayını yapmasına izin verilmiyor. Kullanıcı, https://www.youtube.com/features adresinden daha fazla bilgi edinebilir.
invalidValue (400) invalidAutoStart liveBroadcast kaynağı, contentDetails.enableAutoStart özelliği için geçersiz bir değer içeriyordu. Bu ayar tüm yayınlarda desteklenmez.
invalidValue (400) invalidAutoStop liveBroadcast kaynağı, contentDetails.enableAutoStop özelliği için geçersiz bir değer içeriyor. Kalıcı bir yayın için enableAutoStop ayarını değiştiremezsiniz.
invalidValue (400) invalidDescription liveBroadcast kaynağı, snippet.description özelliği için geçerli bir değer belirtmedi. Özelliğin değeri en fazla 5.000 karakter içerebilir.
invalidValue (400) invalidEmbedSetting liveBroadcast kaynağı, contentDetails.enable_embed özelliği için geçersiz bir değer içeriyordu. Bu yayını yerleştiremezsiniz.
invalidValue (400) invalidLatencyPreferenceOptions liveBroadcast kaynağı, contentDetails.latencyPreference özelliği için geçersiz bir değer içeriyordu. Bu gecikme tercihiyle tüm ayarlar desteklenmez.
invalidValue (400) invalidPrivacyStatus liveBroadcast kaynağı, status.privacy_status özelliği için geçersiz bir değer içeriyordu.
invalidValue (400) invalidProjection liveBroadcast kaynağı, contentDetails.projection özelliği için geçersiz bir değer içeriyor. Varsayılan bir yayının projeksiyonu 360 olarak ayarlanamaz.
invalidValue (400) invalidScheduledEndTime liveBroadcast kaynağı, snippet.scheduledEndTime özelliği için geçersiz bir değer içeriyor. Planlanan bitiş zamanı, planlanan başlangıç zamanından sonra olmalıdır.
invalidValue (400) invalidScheduledStartTime liveBroadcast kaynağı, snippet.scheduledStartTime özelliği için geçersiz bir değer içeriyor. Planlanan başlangıç zamanı gelecekte olmalı ve geçerli tarihe yeterince yakın olmalıdır. Böylece yayın, o zaman için güvenilir bir şekilde planlanabilir.
invalidValue (400) invalidTitle liveBroadcast kaynağı, snippet.title özelliği için geçerli bir değer belirtmedi. Mülkün değeri 1 ila 100 karakter uzunluğunda olmalıdır.
limitExceeded userBroadcastsExceedLimit Kullanıcı çok fazla canlı veya planlanmış yayın oluşturdu ve bazılarını durdurması ya da silmesi gerekiyor.
rateLimitExceeded userRequestsExceedRateLimit Kullanıcı, belirli bir zaman aralığında çok fazla istek gönderdi.
required (400) privacyStatusRequired liveBroadcast kaynağı, gizlilik durumunu belirtmelidir. Geçerli privacyStatus değerleri inceleyin.
required (400) scheduledEndTimeRequired liveBroadcast kaynağı, snippet.scheduledEndTime özelliğini belirtmelidir.
required (400) scheduledStartTimeRequired liveBroadcast kaynağı, snippet.scheduledStartTime özelliğini belirtmelidir.
required (400) titleRequired liveBroadcast kaynağı, snippet.title özelliğini belirtmelidir.

Deneyin.

Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer simgesini kullanın.