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.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 - รูปภาพขนาดย่อเริ่มต้นสำหรับแหล่งข้อมูลนี้ ภาพปกเริ่มต้นสำหรับวิดีโอหรือแหล่งข้อมูลที่อ้างอิงถึงวิดีโอ เช่น รายการในเพลย์ลิสต์หรือผลการค้นหา มีความกว้าง 120 พิกเซลและความสูง 90 พิกเซล ภาพปกเริ่มต้นของช่องมีความกว้าง 88 พิกเซลและความสูง 88 พิกเซล
  • medium - รูปภาพขนาดย่อเวอร์ชันที่มีความละเอียดสูงกว่า สำหรับวิดีโอ (หรือแหล่งข้อมูลที่อ้างอิงถึงวิดีโอ) รูปภาพนี้มีความกว้าง 320 พิกเซลและความสูง 180 พิกเซล สำหรับช่อง รูปภาพนี้จะมีความกว้าง 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 - รูปภาพขนาดย่อเริ่มต้นสำหรับแหล่งข้อมูลนี้ ภาพปกเริ่มต้นสำหรับวิดีโอหรือแหล่งข้อมูลที่อ้างอิงถึงวิดีโอ เช่น รายการในเพลย์ลิสต์หรือผลการค้นหา มีความกว้าง 120 พิกเซลและความสูง 90 พิกเซล ภาพปกเริ่มต้นของช่องมีความกว้าง 88 พิกเซลและความสูง 88 พิกเซล
  • medium - รูปภาพขนาดย่อเวอร์ชันที่มีความละเอียดสูงกว่า สำหรับวิดีโอ (หรือแหล่งข้อมูลที่อ้างอิงถึงวิดีโอ) รูปภาพนี้มีความกว้าง 320 พิกเซลและความสูง 180 พิกเซล สำหรับช่อง รูปภาพนี้จะมีความกว้าง 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
ความสูงของรูปภาพ