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 – ภาพขนาดย่อเวอร์ชันความละเอียดสูงขึ้น สำหรับวิดีโอ (หรือแหล่งข้อมูลที่กล่าวถึงวิดีโอ) รูปภาพนี้กว้าง 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 – (ยังไม่ส่งคืน)
  • 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 มีข้อมูลที่ระบุทรัพยากรที่เพิ่มลงในแชแนล