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 |
objectsnippet ऑब्जेक्ट में ग्रुप के बारे में बुनियादी जानकारी होती है. इसमें ग्रुप बनाने की तारीख और नाम शामिल होता है. |
snippet.publishedAt |
datetimeग्रुप बनाने की तारीख और समय. वैल्यू को ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में बताया गया है. |
snippet.title |
stringग्रुप का नाम. वैल्यू एक स्ट्रिंग होनी चाहिए. |
contentDetails |
objectcontentDetails ऑब्जेक्ट में ग्रुप के बारे में ज़्यादा जानकारी होती है. जैसे, उसमें मौजूद आइटम की संख्या और टाइप. |
contentDetails.itemCount |
unsigned longग्रुप में मौजूद आइटम की संख्या. |
contentDetails.itemType |
stringग्रुप में मौजूद संसाधनों का टाइप. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|