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