ทรัพยากร 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 ประเภททรัพยากรของกลุ่ม ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|