activity ทรัพยากรมีข้อมูลเกี่ยวกับการกระทำที่ช่องหรือผู้ใช้หนึ่งๆ ดำเนินการบน YouTube การดำเนินการที่รายงานในฟีดกิจกรรม ได้แก่ การให้คะแนนวิดีโอ การแชร์วิดีโอ การทำเครื่องหมายวิดีโอเป็นรายการโปรด การอัปโหลดวิดีโอ และอื่นๆ activity ทรัพยากรแต่ละรายการจะระบุประเภทการดำเนินการ ช่องที่เชื่อมโยงกับการดำเนินการ และทรัพยากรที่เชื่อมโยงกับการดำเนินการ เช่น วิดีโอที่ได้รับการจัดประเภทหรืออัปโหลด
เมธอด
API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร activities
การแสดงทรัพยากร
โครงสร้าง 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 |
etagEtag ของทรัพยากรนี้ |
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 |
stringURL ของรูปภาพ |
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 |
stringURL ของโพสต์ในโซเชียลเน็ตเวิร์ก |
contentDetails.social.imageUrl |
stringรูปภาพของผู้เขียนโพสต์ |
contentDetails.channelItem |
objectออบเจ็กต์ channelItem มีรายละเอียดเกี่ยวกับทรัพยากรที่เพิ่มลงในช่อง พร็อพเพอร์ตี้นี้จะแสดงก็ต่อเมื่อ snippet.type เป็น channelItem |
contentDetails.channelItem.resourceId |
objectออบเจ็กต์ resourceId มีข้อมูลที่ระบุทรัพยากรที่เพิ่มลงในช่อง |