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