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