Groups

ทรัพยากร group แสดงถึงกลุ่ม YouTube Analytics ซึ่งเป็นคอลเล็กชันที่กำหนดเองซึ่งรวบรวมช่อง วิดีโอ เพลย์ลิสต์ หรือเนื้อหาได้สูงสุด 500 รายการ

รายการทั้งหมดในกลุ่มต้องแสดงทรัพยากรประเภทเดียวกัน เช่น คุณไม่สามารถสร้างกลุ่มที่มีวิดีโอ 100 รายการและเพลย์ลิสต์ 100 รายการ

กลุ่ม Analytics ต้องมีเฉพาะทรัพยากรที่คุณอัปโหลดหรืออ้างสิทธิ์ไว้ หรือลิงก์กับช่องที่คุณดูแลเท่านั้น ด้วยเหตุนี้ เจ้าของช่องจึงสามารถสร้างกลุ่มวิดีโอและเพลย์ลิสต์ได้ เจ้าของเนื้อหาสามารถสร้างกลุ่มวิดีโอ เพลย์ลิสต์ ช่อง หรือเนื้อหาได้

เมธอด

API รองรับวิธีการต่อไปนี้สําหรับทรัพยากร groups

list

แสดงรายการกลุ่มที่ตรงกับพารามิเตอร์คําขอ API เช่น คุณสามารถดึงข้อมูลกลุ่มทั้งหมดที่ผู้ใช้ที่ตรวจสอบสิทธิ์เป็นเจ้าของ หรือดึงข้อมูลกลุ่มอย่างน้อย 1 กลุ่มตามรหัสที่ไม่ซ้ำกันได้ ลองใช้เลย

แทรก

สร้างกลุ่ม YouTube Analytics หลังจากสร้างกลุ่มแล้ว ให้ใช้เมธอด groupItems.insert เพื่อเพิ่มรายการลงในกลุ่ม ลองใช้เลย

update

แก้ไขข้อมูลเมตาสำหรับกลุ่ม ปัจจุบันมีเพียงชื่อกลุ่มเท่านั้นที่อัปเดตได้ (ใช้ groupItems.insert และ groupItems.delete เพื่อเพิ่มและนำรายการกลุ่มออก) ลองใช้เลย

ลบ

ลบกลุ่ม ลองใช้เลย

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

โครงสร้าง JSON ด้านล่างแสดงรูปแบบของทรัพยากร groups

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

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

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

พร็อพเพอร์ตี้
kind	string ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#group
etag	etag Etag ของทรัพยากรนี้
id	string รหัสที่ YouTube ใช้เพื่อระบุกลุ่มที่ไม่ซ้ำกัน
snippet	object ออบเจ็กต์ snippet มีข้อมูลพื้นฐานเกี่ยวกับกลุ่ม ซึ่งรวมถึงวันที่สร้างและชื่อ
snippet.publishedAt	datetime วันที่และเวลาที่สร้างกลุ่ม ค่าที่ระบุอยู่ในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ)
snippet.title	string ชื่อกลุ่ม ค่าต้องเป็นสตริงที่ไม่ว่างเปล่า
contentDetails	object ออบเจ็กต์ contentDetails มีข้อมูลเพิ่มเติมเกี่ยวกับกลุ่ม เช่น จํานวนประเภทของรายการที่มี
contentDetails.itemCount	unsigned long จำนวนรายการในกลุ่ม
contentDetails.itemType	string ประเภททรัพยากรของกลุ่ม ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ youtube#channel youtube#playlist youtube#video youtubePartner#asset