Activities

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

เมธอด

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

list

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

การแสดงทรัพยากร

โครงสร้าง 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
    },
    "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 - รูปภาพขนาดย่อเริ่มต้น ภาพปกเริ่มต้นสำหรับวิดีโอหรือแหล่งข้อมูลที่อ้างอิงถึงวิดีโอ เช่น รายการในเพลย์ลิสต์หรือผลการค้นหา จะมีความกว้าง 120 พิกเซลและความสูง 90 พิกเซล ภาพปกเริ่มต้นของช่องมีความกว้าง 88 พิกเซลและความสูง 88 พิกเซล medium - รูปภาพขนาดย่อเวอร์ชันที่มีความละเอียดสูงกว่า สำหรับวิดีโอ (หรือแหล่งข้อมูลที่อ้างอิงถึงวิดีโอ) รูปภาพนี้มีความกว้าง 320 พิกเซลและความสูง 180 พิกเซล สำหรับช่อง รูปภาพนี้จะมีความกว้าง 240 พิกเซลและสูง 240 พิกเซล high – รูปภาพปกเวอร์ชันความละเอียดสูง สำหรับวิดีโอ (หรือแหล่งข้อมูลที่อ้างอิงถึงวิดีโอ) รูปภาพนี้มีความกว้าง 480 พิกเซลและความสูง 360 พิกเซล สำหรับช่อง รูปภาพนี้จะมีความกว้าง 800 พิกเซลและความสูง 800 พิกเซล standard - รูปภาพขนาดย่อเวอร์ชันที่มีความละเอียดสูงกว่ารูปภาพความละเอียด high รูปภาพนี้พร้อมใช้งานสำหรับวิดีโอบางรายการและแหล่งข้อมูลอื่นๆ ที่อ้างอิงถึงวิดีโอ เช่น รายการในเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้กว้าง 640 พิกเซลและสูง 480 พิกเซล maxres – รูปภาพปกเวอร์ชันความละเอียดสูง ขนาดรูปภาพนี้ใช้ได้กับวิดีโอบางรายการและแหล่งข้อมูลอื่นๆ ที่อ้างอิงถึงวิดีโอ เช่น รายการในเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้มีความกว้าง 1280 พิกเซลและความสูง 720 พิกเซล fhd – รูปภาพขนาดย่อเวอร์ชันความละเอียดสูงเต็มประสิทธิภาพ (1080p) ขนาดภาพนี้พร้อมใช้งานสำหรับวิดีโอบางรายการ รูปภาพนี้มีความกว้าง 1920 พิกเซลและสูง 1080 พิกเซล qhd – ภาพขนาดย่อเวอร์ชัน Quad High Definition (1440p / 2K) ขนาดภาพนี้พร้อมใช้งานสำหรับวิดีโอบางรายการ รูปภาพนี้มีความกว้าง 2560 พิกเซล และสูง 1440 พิกเซล uhd – รูปภาพขนาดย่อเวอร์ชันความละเอียดสูงพิเศษ (4K) ขนาดภาพนี้พร้อมใช้งานสำหรับวิดีโอบางรายการ รูปภาพนี้มีความกว้าง 3840 พิกเซลและสูง 2160 พิกเซล
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 – (ยังไม่ได้ส่งคืน) playlistItem promotedItem recommendation social subscription upload
snippet.groupId	string รหัสกลุ่มที่เชื่อมโยงกับกิจกรรม รหัสกลุ่มจะระบุเหตุการณ์ของผู้ใช้ที่เชื่อมโยงกับผู้ใช้และทรัพยากรเดียวกัน ตัวอย่างเช่น หากผู้ใช้อัปโหลดวิดีโอและดูวิดีโอเดียวกัน รายการสำหรับเหตุการณ์เหล่านั้นจะมีรหัสกลุ่มเดียวกันในฟีดกิจกรรมของผู้ใช้ ในอินเทอร์เฟซผู้ใช้ คุณสามารถหลีกเลี่ยงการทำซ้ำได้โดยการจัดกลุ่มเหตุการณ์ที่มีgroupIdค่าเดียวกัน
contentDetails	object ออบเจ็กต์ contentDetails มีข้อมูลเกี่ยวกับเนื้อหาที่เชื่อมโยงกับกิจกรรม เช่น หากค่า snippet.type เป็น videoRated เนื้อหาของออบเจ็กต์ contentDetails จะระบุวิดีโอที่ได้รับการจัดประเภท
contentDetails.upload	object ออบเจ็กต์ upload มีข้อมูลเกี่ยวกับวิดีโอที่อัปโหลด พร็อพเพอร์ตี้นี้จะแสดงก็ต่อเมื่อ snippet.type เป็น upload
contentDetails.upload.videoId	string รหัสที่ YouTube ใช้เพื่อระบุวิดีโอที่อัปโหลดอย่างไม่ซ้ำกัน
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 เหตุผลที่แนะนำทรัพยากรแก่ผู้ใช้ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ 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 มีข้อมูลที่ระบุทรัพยากรที่เพิ่มลงในช่อง