ทรัพยากร 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 ประเภทของทรัพยากรที่กลุ่มมี ค่าที่ถูกต้องของพร็อพเพอร์ตี้นี้คือ
|