Activities: insert

YouTube, kanal duyurusu özelliğini kullanımdan kaldırdı ve bu yöntem artık desteklenmiyor.

Daha ayrıntılı bilgi için lütfen YouTube Yardım Merkezi'ne göz atın.

Belirli bir kanal için bülten yayınlar. (İsteği gönderen kullanıcının, kanal adına hareket etmeye yetkili olması gerekir.)

Not: Bir activity kaynağı, kullanıcının bir videoyu derecelendirmesi veya favori olarak işaretlemesi gibi işlemlerle ilgili bilgiler içerebilse de bu activity kaynaklarını oluşturmak için diğer API yöntemlerini kullanmanız gerekir. Örneğin, bir videoyu derecelendirmek için API'nin videos.rate() yöntemini, bir videoyu favori olarak işaretlemek için ise playlistItems.insert() yöntemini kullanırsınız.

Kota etkisi: Bu yönteme yapılan bir çağrının kota maliyeti 50 birimdir.

İstek

HTTP isteği

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

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ğı özelliklerin yanı sıra API yanıtının içereceği özellikleri tanımlar.

    Aşağıdaki listede, parametre değerine ekleyebileceğiniz part adları
    yer almaktadır:
  • contentDetails
  • id
  • snippet

İstek içeriği

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

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

    • snippet.description

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

    • snippet.description
    • contentDetails.bulletin.resourceId

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir etkinlik 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 lütfen hata mesajı belgelerine bakın.

Hata türü Hata ayrıntıları Açıklama
badRequest (400) bulletinTextRequired İstek, bülten gönderisinin metnini sağlamak için snippet nesnesinin description özelliğini kullanmalıdır.
badRequest (400) invalidMetadata kind mülkü, sağlanan kimlik türüyle eşleşmiyor.
forbidden (403) forbidden İstek düzgün şekilde yetkilendirilmedi.
notFound (404) playlistNotFound YouTube, bülten gönderisiyle ilişkilendirmeye çalıştığınız videoyu bulamıyor. contentDetails.bulletinPosted.playlistId özelliğinin değerini kontrol edin.
notFound (404) videoNotFound YouTube, bülten gönderisiyle ilişkilendirmeye çalıştığınız videoyu bulamıyor. contentDetails.bulletinPosted.videoId özelliğinin değerini kontrol edin.
userRateLimitExceeded (403) rateLimitExceeded Kotanızı aştığınız için istek tamamlanamıyor.