Subscriptions

แหล่งข้อมูล subscription มีข้อมูลเกี่ยวกับการสมัครใช้บริการของผู้ใช้ YouTube การสมัครรับข้อมูลจะแจ้งเตือนผู้ใช้เมื่อมีการเพิ่มวิดีโอใหม่ลงในช่องหรือเมื่อผู้ใช้อื่นดำเนินการอย่างใดอย่างหนึ่งบน YouTube เช่น อัปโหลดวิดีโอ ให้คะแนนวิดีโอ หรือแสดงความคิดเห็นในวิดีโอ

วิธีการ

API รองรับเมธอดต่อไปนี้สำหรับทรัพยากร subscriptions รายการ

list

ส่งคืนทรัพยากรการสมัครใช้บริการที่ตรงกับเกณฑ์คำขอ API ลองใช้เลย

แทรก

เพิ่มการสมัครรับข้อมูลสำหรับช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ ลองใช้เลย

ลบ

ลบการสมัครใช้บริการ ลองใช้เลย

การนำเสนอทรัพยากร

โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของทรัพยากร subscriptions

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

พร็อพเพอร์ตี้

ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้

พร็อพเพอร์ตี้
kind	string ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#subscription
etag	etag Etag ของแหล่งข้อมูลนี้
id	string รหัสที่ YouTube ใช้เพื่อระบุการติดตามโดยไม่ซ้ำกัน
snippet	object ออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับการติดตาม รวมถึงชื่อและช่องที่ผู้ใช้ติดตาม
snippet.publishedAt	datetime วันที่และเวลาที่สร้างการสมัครใช้บริการ ค่าจะระบุไว้ในรูปแบบ ISO 8601
snippet.channelTitle	string ชื่อช่องที่เป็นเจ้าของการติดตาม
snippet.title	string ชื่อของการสมัครใช้บริการ
snippet.description	string รายละเอียดของการสมัครใช้บริการ
snippet.resourceId	object ออบเจ็กต์ id มีข้อมูลเกี่ยวกับช่องที่ผู้ใช้ติดตาม
snippet.resourceId.kind	string ประเภทของทรัพยากร API
snippet.resourceId.channelId	string ค่าที่ YouTube ใช้เพื่อระบุช่องที่ผู้ใช้ติดตามโดยไม่ซ้ำกัน
snippet.channelId	string รหัสที่ YouTube ใช้เพื่อระบุช่องของสมาชิกโดยไม่ซ้ำกัน ออบเจ็กต์ resource_id ระบุช่องที่ผู้ใช้ติดตาม
snippet.thumbnails	object แผนที่ภาพขนาดย่อที่เชื่อมโยงกับการสมัครใช้บริการ สำหรับวัตถุแต่ละรายการในแผนที่ คีย์คือชื่อของภาพขนาดย่อ และค่าคือวัตถุที่มีข้อมูลอื่นๆ เกี่ยวกับภาพขนาดย่อ
snippet.thumbnails.(key)	object คีย์-ค่าที่ใช้ได้มีดังนี้ default – ภาพขนาดย่อเริ่มต้นสำหรับแหล่งข้อมูลนี้ ภาพขนาดย่อเริ่มต้นของวิดีโอหรือทรัพยากรที่อ้างอิงไปยังวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา มีความกว้าง 120px และสูง 90px ภาพขนาดย่อเริ่มต้นของช่องคือกว้าง 88 พิกเซลและสูง 88 พิกเซล medium – ภาพปกเวอร์ชันที่มีความละเอียดสูงกว่า สำหรับวิดีโอ (หรือทรัพยากรที่อ้างถึงวิดีโอ) รูปภาพนี้จะกว้าง 320px และสูง 180px สำหรับช่อง รูปภาพนี้จะกว้าง 240 พิกเซลและสูง 240 พิกเซล high – รูปภาพขนาดย่อเวอร์ชันความละเอียดสูง สำหรับวิดีโอ (หรือทรัพยากรที่อ้างถึงวิดีโอ) รูปภาพนี้จะกว้าง 480 พิกเซล และสูง 360 พิกเซล สำหรับช่อง รูปภาพนี้จะกว้าง 800 พิกเซลและสูง 800 พิกเซล
snippet.thumbnails.(key).url	string URL ของรูปภาพ
snippet.thumbnails.(key).width	unsigned integer ความกว้างของรูปภาพ
snippet.thumbnails.(key).height	unsigned integer ความสูงของรูปภาพ
contentDetails	object ออบเจ็กต์ contentDetails มีสถิติพื้นฐานเกี่ยวกับการสมัครใช้บริการ
contentDetails.totalItemCount	unsigned integer จำนวนรายการโดยประมาณที่การสมัครใช้บริการชี้ไป
contentDetails.newItemCount	unsigned integer จำนวนรายการใหม่ในการสมัครใช้บริการนับตั้งแต่ที่มีการอ่านเนื้อหาครั้งล่าสุด
contentDetails.activityType	string ประเภทกิจกรรมที่การสมัครรับข้อมูลนี้ (เฉพาะการอัปโหลดและทุกอย่าง) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่ all uploads
subscriberSnippet	object ออบเจ็กต์ subscriberSnippet มีรายละเอียดพื้นฐานเกี่ยวกับผู้สมัครใช้บริการ
subscriberSnippet.title	string ชื่อช่องของผู้ติดตาม
subscriberSnippet.description	string คำอธิบายช่องของผู้ติดตาม
subscriberSnippet.channelId	string รหัสที่ YouTube กำหนดเพื่อระบุช่องของสมาชิกโดยไม่ซ้ำกัน
subscriberSnippet.thumbnails	object ภาพขนาดย่อสำหรับช่องของผู้ติดตาม
subscriberSnippet.thumbnails.(key)	object คีย์-ค่าที่ใช้ได้มีดังนี้ default – ภาพขนาดย่อเริ่มต้นสำหรับแหล่งข้อมูลนี้ ภาพขนาดย่อเริ่มต้นของวิดีโอหรือทรัพยากรที่อ้างอิงไปยังวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา มีความกว้าง 120px และสูง 90px ภาพขนาดย่อเริ่มต้นของช่องคือกว้าง 88 พิกเซลและสูง 88 พิกเซล medium – ภาพปกเวอร์ชันที่มีความละเอียดสูงกว่า สำหรับวิดีโอ (หรือทรัพยากรที่อ้างถึงวิดีโอ) รูปภาพนี้จะกว้าง 320px และสูง 180px สำหรับช่อง รูปภาพนี้จะกว้าง 240 พิกเซลและสูง 240 พิกเซล high – รูปภาพขนาดย่อเวอร์ชันความละเอียดสูง สำหรับวิดีโอ (หรือทรัพยากรที่อ้างถึงวิดีโอ) รูปภาพนี้จะกว้าง 480 พิกเซล และสูง 360 พิกเซล สำหรับช่อง รูปภาพนี้จะกว้าง 800 พิกเซลและสูง 800 พิกเซล
subscriberSnippet.thumbnails.(key).url	string URL ของรูปภาพ
subscriberSnippet.thumbnails.(key).width	unsigned integer ความกว้างของรูปภาพ
subscriberSnippet.thumbnails.(key).height	unsigned integer ความสูงของรูปภาพ