Groups

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

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

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

วิธีการ

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

list
แสดงผลรายการกลุ่มที่ตรงกับพารามิเตอร์คําขอ API ตัวอย่างเช่น คุณสามารถเรียกดูกลุ่มทั้งหมดที่ผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์เป็นเจ้าของ หรือจะเรียกดูกลุ่มอย่างน้อย 1 กลุ่มตามรหัสที่ไม่ซ้ํากันก็ได้ ลองใช้เลย
แทรก
สร้างกลุ่ม YouTube Analytics หลังจากสร้างกลุ่มแล้ว ให้ใช้เมธอด groupItems.insert เพื่อเพิ่มรายการลงในกลุ่ม ลองใช้เลย
อัปเดต
แก้ไขข้อมูลเมตาของกลุ่ม ปัจจุบันอัปเดตพร็อพเพอร์ตี้ได้เพียงรายการเดียวคือชื่อกลุ่ม (ใช้ 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