LiveBroadcasts: insert

API artık canlı yayınlarınızı "çocuklara özel" olarak işaretleme özelliğini destekliyor. Ayrıca liveBroadcast kaynağı artık bu 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 lütfen 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 kapsamlardan en az biriyle yetkilendirme 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 parametrelerin tümü sorgu parametreleridir.

Parametreler
Gerekli parametreler
part string
Bu işlemde part parametresi iki amaca hizmet eder. Yazma işleminin ayarlanacağı özelliklerin yanı sıra API yanıtının içereceği özellikleri de tanımlar.

Parametre değerine ekleyebileceğiniz part özellikleri id, snippet, contentDetails ve status'dir.
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortaklarına yöneliktir.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube CMS kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahiplerinin, her kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimlik doğrulaması yaparak tüm video ve kanal verilerine erişmelerine olanak tanır. Kullanıcının kimlik doğrulaması yaptığı CMS hesabı, belirtilen YouTube içerik sahibine bağlanmalıdır.
onBehalfOfContentOwnerChannel string
Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir. Bu parametre yalnızca uygun şekilde yetkilendirilen 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 istek onBehalfOfContentOwner parametresi için bir değer belirttiğinde zorunludur ve yalnızca bu parametreyle birlikte kullanılabilir. Ayrıca istek, onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı bir İYS hesabı kullanılarak yetkilendirilmelidir. Son olarak, onBehalfOfContentOwnerChannel parametre değerinin belirttiği kanal, onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlanmalıdır.

Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları yöneten YouTube içerik iş ortakları içindir. İçerik sahiplerinin, bir kez kimlik doğrulaması yaparak parametre değerinde belirtilen kanal adına her ayrı kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan işlem gerçekleştirmesine olanak tanır.

İstek içeriği

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

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

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

  • Şu özellikler için değer ayarlayabilirsiniz:

    • snippet.title
    • snippet.description
    • 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

    Not: Özellik tablosu, yukarıda listelenen tesisler için ayarlanan tüm varsayılan değerleri belgeler. 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 çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için lütfen hata mesajı dokümanlarına bakın.

Hata türü Hata ayrıntısı Açıklama
insufficientPermissions insufficientLivePermissions İsteğin canlı yayını oluşturma yetkisi yok.
insufficientPermissions livePermissionBlocked İsteği yetkilendiren kullanıcı şu anda YouTube'da canlı video akışı gerçekleştiremiyor. Kullanıcının neden canlı video akışı yapamadığına dair ayrıntılar https://www.youtube.com/features adresindeki kullanıcının kanal ayarlarında bulunabilir.
insufficientPermissions liveStreamingNotEnabled İsteği yetkilendiren kullanıcı, YouTube'da canlı video akışı gerçekleştiremez. Kullanıcılar, https://www.youtube.com/features adresinde daha fazla bilgiye ulaşabilir.
invalidValue (400) invalidAutoStart liveBroadcast kaynağı, contentDetails.enableAutoStart özelliği için geçersiz bir değer içeriyordu. Bu ayarı tüm yayınlar desteklemez.
invalidValue (400) invalidAutoStop liveBroadcast kaynağı, contentDetails.enableAutoStop özelliği için geçersiz bir değer içeriyordu. 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 tercihi tüm ayarları desteklemez.
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çeriyordu. 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çeriyordu. Planlanan bitiş zamanı, planlanan başlangıç saatine uygun olmalıdır.
invalidValue (400) invalidScheduledStartTime liveBroadcast kaynağı, snippet.scheduledStartTime özelliği için geçersiz bir değer içeriyordu. Planlanan başlangıç saati gelecekte olmalı ve bir yayının belirli bir zamanda güvenilir şekilde planlanabilmesi için geçerli tarihe yeterince yakın olmalıdır.
invalidValue (400) invalidTitle liveBroadcast kaynağı, snippet.title özelliği için geçerli bir değer belirtmedi. Özelliğin değeri 1-100 karakter arasında olmalıdır.
limitExceeded userBroadcastsExceedLimit Bu kullanıcı, çok fazla canlı veya planlanmış yayın oluşturduğundan bazılarını durdurması veya silmesi gerekiyor.
rateLimitExceeded userRequestsExceedRateLimit Kullanıcı, belirli bir zaman aralığında çok fazla istek gönderdi.
required (400) privacyStatusRequired liveBroadcast kaynağı bir gizlilik durumu belirtmelidir. Geçerli privacyStatus değerlerini 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 kullanın.