Activities

YouTube ได้เลิกใช้งานฟีเจอร์กระดานข่าวสารของช่องแล้ว เมธอด activities.list จะไม่แสดงกระดานข่าวสารของแชแนล และไม่รองรับเมธอด activities.insert อีกต่อไป โปรดไปที่ศูนย์ช่วยเหลือของ YouTube เพื่อดูรายละเอียดเพิ่มเติม

แหล่งข้อมูล activity มีข้อมูลเกี่ยวกับการดำเนินการที่ช่องหรือผู้ใช้หนึ่งๆ ทำบน YouTube การดำเนินการที่รายงานในฟีดกิจกรรมรวมถึงการให้คะแนนวิดีโอ การแชร์วิดีโอ การระบุวิดีโอเป็นรายการโปรด การอัปโหลดวิดีโอ ฯลฯ ทรัพยากร activity แต่ละรายการจะระบุประเภทการทำงาน ช่องที่เชื่อมโยงกับการดำเนินการ และทรัพยากรที่เกี่ยวข้องกับการดำเนินการ เช่น วิดีโอที่มีการให้คะแนนหรืออัปโหลด

วิธีการ

API รองรับเมธอดต่อไปนี้สำหรับทรัพยากร activities

list
แสดงผลรายการเหตุการณ์กิจกรรมในช่องที่ตรงกับเกณฑ์คำขอ ตัวอย่างเช่น คุณสามารถดึงข้อมูลเหตุการณ์ที่เชื่อมโยงกับช่องใดช่องหนึ่งหรือกับช่องของผู้ใช้เอง ลองใช้เลย

ไม่รองรับเมธอด activities.insert อีกต่อไป

การนำเสนอทรัพยากร

โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของทรัพยากร activities

{
  "kind": "youtube#activity",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "type": string,
    "groupId": string
  },
  "contentDetails": {
    "upload": {
      "videoId": string
    },
    "like": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      }
    },
    "favorite": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      }
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      }
    },
    "subscription": {
      "resourceId": {
        "kind": string,
        "channelId": string,
      }
    },
    "playlistItem": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      },
      "playlistId": string,
      "playlistItemId": string
    },
    "recommendation": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      },
      "reason": string,
      "seedResourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      }
    },
    "social": {
      "type": string,
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      },
      "author": string,
      "referenceUrl": string,
      "imageUrl": string
    },
    "channelItem": {
      "resourceId": {
      }
    },
  }
}

พร็อพเพอร์ตี้

ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้

พร็อพเพอร์ตี้
kind string
ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#activity
etag etag
Etag ของทรัพยากรนี้
id string
รหัสที่ YouTube ใช้เพื่อระบุกิจกรรมแบบไม่ซ้ำ
snippet object
ออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับกิจกรรม รวมถึงประเภทและรหัสกลุ่มของกิจกรรม
snippet.publishedAt datetime
วันที่และเวลาที่กิจกรรมเกิดขึ้น ค่าจะระบุไว้ในรูปแบบ ISO 8601
snippet.channelId string
รหัสที่ YouTube ใช้เพื่อระบุช่องที่เชื่อมโยงกับกิจกรรมโดยไม่ซ้ำกัน
snippet.title string
ชื่อของทรัพยากรที่เกี่ยวข้องกับกิจกรรมเป็นหลัก
snippet.description string
คำอธิบายของทรัพยากรที่เกี่ยวข้องกับกิจกรรมเป็นหลัก
snippet.thumbnails object
แผนที่ภาพขนาดย่อที่เชื่อมโยงกับทรัพยากรซึ่งเกี่ยวข้องกับกิจกรรมเป็นหลัก สำหรับวัตถุแต่ละรายการในแผนที่ คีย์คือชื่อของภาพขนาดย่อ และค่าคือวัตถุที่มีข้อมูลอื่นๆ เกี่ยวกับภาพขนาดย่อ
snippet.thumbnails.(key) object
ค่าคีย์ที่ถูกต้องคือ
  • default – ภาพขนาดย่อเริ่มต้น ภาพขนาดย่อเริ่มต้นสำหรับวิดีโอหรือทรัพยากรที่อ้างอิงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา จะกว้าง 120px และสูง 90px ภาพขนาดย่อเริ่มต้นของช่องคือกว้าง 88 พิกเซลและสูง 88 พิกเซล
  • medium – ภาพขนาดย่อเวอร์ชันความละเอียดสูงกว่า สำหรับวิดีโอ (หรือทรัพยากรที่อ้างถึงวิดีโอ) รูปภาพนี้จะกว้าง 320px และสูง 180px สำหรับช่อง รูปภาพนี้กว้าง 240 พิกเซลและสูง 240 พิกเซล
  • high – ภาพขนาดย่อเวอร์ชันความละเอียดสูง สำหรับวิดีโอ (หรือทรัพยากรที่อ้างถึงวิดีโอ) รูปภาพนี้จะกว้าง 480 พิกเซล และสูง 360 พิกเซล สำหรับช่อง รูปภาพนี้กว้าง 800 พิกเซล และสูง 800 พิกเซล
  • standard – ภาพปกที่มีความละเอียดสูงกว่ารูปภาพความละเอียด high ภาพนี้พร้อมใช้งานสำหรับบางวิดีโอและทรัพยากรอื่นๆ ที่อ้างอิงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้กว้าง 640 พิกเซลและสูง 480 พิกเซล
  • maxres – ภาพขนาดย่อในเวอร์ชันความละเอียดสูงสุด ขนาดภาพนี้ใช้ได้สำหรับวิดีโอบางรายการและทรัพยากรอื่นๆ ที่อ้างอิงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้กว้าง 1280 พิกเซลและสูง 720 พิกเซล
snippet.thumbnails.(key).url string
URL ของรูปภาพ
snippet.thumbnails.(key).width unsigned integer
ความกว้างของรูปภาพ
snippet.thumbnails.(key).height unsigned integer
ความสูงของรูปภาพ
snippet.channelTitle string
ชื่อช่องของช่องที่มีหน้าที่รับผิดชอบกิจกรรมนี้
snippet.type string
ประเภทของกิจกรรมที่ทรัพยากรอธิบาย

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • channelItem
  • comment – (ยังไม่ส่งคืน)
  • favorite
  • like
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • subscription
  • upload
  • bulletin (เลิกใช้งานแล้ว)
snippet.groupId string
รหัสกลุ่มที่เชื่อมโยงกับกิจกรรม รหัสกลุ่มจะระบุเหตุการณ์ของผู้ใช้ที่เชื่อมโยงกับผู้ใช้และทรัพยากรเดียวกัน ตัวอย่างเช่น หากผู้ใช้ให้คะแนนวิดีโอและทำเครื่องหมายวิดีโอเดียวกันว่าเป็นรายการโปรด รายการเหตุการณ์เหล่านั้นจะมีรหัสกลุ่มเดียวกันในฟีดกิจกรรมของผู้ใช้ ในอินเทอร์เฟซผู้ใช้ คุณสามารถหลีกเลี่ยงการใช้งานซ้ำได้ด้วยการจัดกลุ่มเหตุการณ์ด้วยค่า groupId เดียวกัน
contentDetails object
ออบเจ็กต์ contentDetails มีข้อมูลเกี่ยวกับเนื้อหาที่เชื่อมโยงกับกิจกรรม เช่น หากค่า snippet.type คือ videoRated เนื้อหาของออบเจ็กต์ contentDetails จะระบุวิดีโอที่มีการจัดประเภท
contentDetails.upload object
ออบเจ็กต์ upload มีข้อมูลเกี่ยวกับวิดีโอที่อัปโหลด พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ snippet.type เป็น upload
contentDetails.upload.videoId string
รหัสที่ YouTube ใช้เพื่อระบุวิดีโอที่อัปโหลดโดยไม่ซ้ำกัน
contentDetails.like object
ออบเจ็กต์ like มีข้อมูลเกี่ยวกับทรัพยากรที่ได้รับคะแนนเชิงบวก (เช่น) พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ snippet.type เป็น like
contentDetails.like.resourceId object
ออบเจ็กต์ resourceId มีข้อมูลที่ระบุทรัพยากรที่จัดอยู่ในประเภท
contentDetails.like.resourceId.kind string
ประเภทของทรัพยากร API
contentDetails.like.resourceId.videoId string
รหัสที่ YouTube ใช้ในการระบุวิดีโอแบบไม่ซ้ำ หากแหล่งข้อมูลที่ได้รับการจัดประเภทเป็นวิดีโอ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ resourceId.kind เป็น youtube#video
contentDetails.favorite object
ออบเจ็กต์ favorite มีข้อมูลเกี่ยวกับวิดีโอที่มีการทำเครื่องหมายเป็นวิดีโอโปรด พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ snippet.type เป็น favorite
contentDetails.favorite.resourceId object
ออบเจ็กต์ resourceId มีข้อมูลที่ระบุทรัพยากรที่มีการทำเครื่องหมายเป็นรายการโปรด
contentDetails.favorite.resourceId.kind string
ประเภทของทรัพยากร API
contentDetails.favorite.resourceId.videoId string
รหัสที่ YouTube ใช้เพื่อระบุวิดีโอโปรดแบบไม่ซ้ำ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ resourceId.kind คือ youtube#video

หมายเหตุ: ขณะนี้เมธอด activities.list ไม่ได้แสดงผลทรัพยากรสำหรับความคิดเห็นใหม่
contentDetails.comment object
ออบเจ็กต์ comment มีข้อมูลเกี่ยวกับทรัพยากรที่ได้รับความคิดเห็น พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ snippet.type เป็น comment
contentDetails.comment.resourceId object
ออบเจ็กต์ resourceId มีข้อมูลที่ระบุทรัพยากรที่เชื่อมโยงกับความคิดเห็น
contentDetails.comment.resourceId.kind string
ประเภทของทรัพยากร API
contentDetails.comment.resourceId.videoId string
รหัสที่ YouTube ใช้เพื่อระบุวิดีโอที่เชื่อมโยงกับความคิดเห็นแบบไม่ซ้ำ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ resourceId.kind เป็น youtube#video
contentDetails.comment.resourceId.channelId string
รหัสที่ YouTube ใช้เพื่อระบุช่องที่เชื่อมโยงกับความคิดเห็นแบบไม่ซ้ำ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ resourceId.kind เป็น youtube#channel
contentDetails.subscription object
ออบเจ็กต์ subscription มีข้อมูลเกี่ยวกับช่องที่ผู้ใช้ติดตาม พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ snippet.type เป็น subscription
contentDetails.subscription.resourceId object
ออบเจ็กต์ resourceId มีข้อมูลที่ระบุทรัพยากรที่ผู้ใช้สมัครใช้บริการ
contentDetails.subscription.resourceId.kind string
ประเภทของทรัพยากร API
contentDetails.subscription.resourceId.channelId string
รหัสที่ YouTube ใช้เพื่อระบุช่องที่ผู้ใช้ติดตามโดยไม่ซ้ำกัน พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ resourceId.kind เป็น youtube#channel
contentDetails.playlistItem object
ออบเจ็กต์ playlistItem มีข้อมูลเกี่ยวกับรายการเพลย์ลิสต์ใหม่ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ snippet.type เป็น playlistItem
contentDetails.playlistItem.resourceId object
ออบเจ็กต์ resourceId มีข้อมูลที่ระบุทรัพยากรที่เพิ่มลงในเพลย์ลิสต์
contentDetails.playlistItem.resourceId.kind string
ประเภทของทรัพยากร API
contentDetails.playlistItem.resourceId.videoId string
รหัสที่ YouTube ใช้เพื่อระบุวิดีโอที่เพิ่มลงในเพลย์ลิสต์แบบไม่ซ้ำ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ resourceId.kind เป็น youtube#video
contentDetails.playlistItem.playlistId string
ค่าที่ YouTube ใช้เพื่อระบุเพลย์ลิสต์แบบไม่ซ้ำ
contentDetails.playlistItem.playlistItemId string
ค่าที่ YouTube ใช้เพื่อระบุรายการในเพลย์ลิสต์แบบไม่ซ้ำ
contentDetails.recommendation object
ออบเจ็กต์ recommendation มีข้อมูลเกี่ยวกับทรัพยากรที่แนะนำ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ snippet.type เป็น recommendation
contentDetails.recommendation.resourceId object
ออบเจ็กต์ resourceId มีข้อมูลที่ระบุทรัพยากรที่แนะนำ
contentDetails.recommendation.resourceId.kind string
ประเภทของทรัพยากร API
contentDetails.recommendation.resourceId.videoId string
รหัสที่ YouTube ใช้ในการระบุวิดีโอแบบไม่ซ้ำ หากแหล่งข้อมูลที่แนะนำเป็นวิดีโอ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ resourceId.kind เป็น youtube#video
contentDetails.recommendation.resourceId.channelId string
รหัสที่ YouTube ใช้เพื่อระบุช่องโดยไม่ซ้ำกัน หากแหล่งข้อมูลที่แนะนำเป็นช่อง พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ resourceId.kind เป็น youtube#channel
contentDetails.recommendation.reason string
เหตุผลที่เราแนะนำทรัพยากรให้กับผู้ใช้

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • videoFavorited
  • videoLiked
  • videoWatched
contentDetails.recommendation.seedResourceId object
ออบเจ็กต์ seedResourceId มีข้อมูลเกี่ยวกับทรัพยากรที่ทำให้เกิดคำแนะนำ
contentDetails.recommendation.seedResourceId.kind string
ประเภทของทรัพยากร API
contentDetails.recommendation.seedResourceId.videoId string
รหัสที่ YouTube ใช้เพื่อระบุวิดีโอแบบไม่ซ้ำ หากวิดีโอแนะนำมาจากวิดีโอใดวิดีโอหนึ่ง พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ seedResourceId.kind เป็น youtube#video
contentDetails.recommendation.seedResourceId.channelId string
รหัสที่ YouTube ใช้ระบุช่องโดยไม่ซ้ำกัน หากการแนะนำมาจากช่องใดช่องหนึ่ง พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ seedResourceId.kind เป็น youtube#channel
contentDetails.recommendation.seedResourceId.playlistId string
รหัสที่ YouTube ใช้เพื่อระบุเพลย์ลิสต์แบบไม่ซ้ำ หากการแนะนำเกิดจากเพลย์ลิสต์ที่เฉพาะเจาะจง พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ seedResourceId.kind เป็น youtube#playlist
contentDetails.social object
ออบเจ็กต์ social มีรายละเอียดเกี่ยวกับโพสต์โซเชียลเน็ตเวิร์ก พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ snippet.type เป็น social
contentDetails.social.type string
ชื่อของโซเชียลเน็ตเวิร์ก

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • facebook
  • googlePlus
  • twitter
  • unspecified
contentDetails.social.resourceId object
ออบเจ็กต์ resourceId สรุปข้อมูลที่ระบุทรัพยากรที่เชื่อมโยงกับโพสต์โซเชียลเน็ตเวิร์ก
contentDetails.social.resourceId.kind string
ประเภทของทรัพยากร API
contentDetails.social.resourceId.videoId string
รหัสที่ YouTube ใช้เพื่อระบุวิดีโอที่แสดงในโพสต์โซเชียลเน็ตเวิร์กแบบไม่ซ้ำ หากโพสต์กล่าวถึงวิดีโอ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อค่าของพร็อพเพอร์ตี้ social.resourceId.kind คือ youtube#video
contentDetails.social.resourceId.channelId string
รหัสที่ YouTube ใช้เพื่อระบุช่องที่ปรากฏในโพสต์โซเชียลเน็ตเวิร์กแบบไม่ซ้ำหากโพสต์กล่าวถึงช่อง พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อค่าของพร็อพเพอร์ตี้ social.resourceId.kind คือ youtube#channel
contentDetails.social.resourceId.playlistId string
รหัสที่ YouTube ใช้เพื่อระบุเพลย์ลิสต์ที่แสดงในโพสต์โซเชียลเน็ตเวิร์กแบบไม่ซ้ำ หากโพสต์กล่าวถึงเพลย์ลิสต์ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อค่าของพร็อพเพอร์ตี้ social.resourceId.kind คือ youtube#playlist
contentDetails.social.author string
ผู้เขียนโพสต์โซเชียลเน็ตเวิร์ก
contentDetails.social.referenceUrl string
URL ของโพสต์โซเชียลเน็ตเวิร์ก
contentDetails.social.imageUrl string
รูปภาพของผู้เขียนโพสต์
contentDetails.channelItem object
ออบเจ็กต์ channelItem มีรายละเอียดเกี่ยวกับทรัพยากรที่เพิ่มลงในช่อง พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อ snippet.type เป็น channelItem
contentDetails.channelItem.resourceId object
ออบเจ็กต์ resourceId มีข้อมูลที่ระบุทรัพยากรที่เพิ่มลงในช่อง