group
रिसॉर्स, YouTube Analytics ग्रुप को दिखाता है. यह ज़्यादा से ज़्यादा 500 चैनलों, वीडियो, प्लेलिस्ट या ऐसेट का कस्टम कलेक्शन होता है.
किसी ग्रुप में मौजूद सभी आइटम, एक ही तरह के संसाधन होने चाहिए. उदाहरण के लिए, ऐसा ग्रुप नहीं बनाया जा सकता जिसमें 100 वीडियो और 100 प्लेलिस्ट हों.
किसी Analytics ग्रुप में सिर्फ़ ऐसे संसाधन शामिल हो सकते हैं जिन्हें आपने अपलोड किया हो या उन पर दावा किया हो. इसके अलावा, वे संसाधन भी ऐसे चैनल से जुड़े हो सकते हैं जिसे आप एडमिन मैनेज करते हैं. इसकी मदद से, चैनल के मालिक वीडियो और प्लेलिस्ट के ग्रुप बना सकते हैं. कॉन्टेंट के मालिक, वीडियो, प्लेलिस्ट, चैनलों या ऐसेट के ग्रुप बना सकते हैं.
तरीके
एपीआई, groups
संसाधनों के लिए इन तरीकों का इस्तेमाल करता है:
- list
- एपीआई अनुरोध पैरामीटर से मैच करने वाले ग्रुप की सूची दिखाता है. उदाहरण के लिए, उन सभी ग्रुप को फिर से हासिल किया जा सकता है जिनके मालिकाना हक की पुष्टि पुष्टि किए गए उपयोगकर्ता के पास है. इसके अलावा, एक या एक से ज़्यादा ग्रुप के यूनीक आईडी की मदद से, ग्रुप को वापस लाया जा सकता है. इसे अभी आज़माएं.
- शामिल करें
- 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 एपीआई संसाधन के टाइप की पहचान करता है. वैल्यू 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 ग्रुप में मौजूद संसाधनों का टाइप. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|