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 มีข้อมูลที่ระบุทรัพยากรที่เพิ่มลงในช่อง