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
ความสูงของรูปภาพ