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 คีย์-ค่าที่ใช้ได้มีดังนี้
|
snippet.thumbnails.(key).url |
string URL ของรูปภาพ |
snippet.thumbnails.(key).width |
unsigned integer ความกว้างของรูปภาพ |
snippet.thumbnails.(key).height |
unsigned integer ความสูงของรูปภาพ |
snippet.channelTitle |
string ชื่อช่องสำหรับช่องที่รับผิดชอบกิจกรรมนี้ |
snippet.type |
string ประเภทของกิจกรรมที่แหล่งข้อมูลอธิบาย ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
|
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 เหตุผลที่แนะนำทรัพยากรให้แก่ผู้ใช้ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
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 ชื่อของโซเชียลเน็ตเวิร์ก ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
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 มีข้อมูลที่ระบุทรัพยากรที่เพิ่มลงในช่อง |