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