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