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