Activities: list

YouTube ने चैनल बुलेटिन की सुविधा बंद कर दी है. The activities.list तरीके से अब भी चैनल बुलेटिन नहीं मिलते. साथ ही, activities.insert तरीका अब काम नहीं करता. ज़्यादा जानकारी के लिए, कृपया YouTube सहायता केंद्र पर जाएं.

यह तरीका, चैनल की गतिविधि से जुड़े उन इवेंट की सूची दिखाता है जो अनुरोध के मानदंड के मुताबिक होते हैं. उदाहरण के लिए, किसी खास चैनल या उपयोगकर्ता के अपने चैनल से जुड़े इवेंट वापस पाए जा सकते हैं.

कोटे पर असर: इस तरीके को कॉल करने पर, कोटे की एक यूनिट का खर्च आता है.

इस्तेमाल के सामान्य उदाहरण

अनुरोध

एचटीटीपी अनुरोध

GET https://www.googleapis.com/youtube/v3/activities

पैरामीटर

यहां दी गई टेबल में, वे पैरामीटर दिए गए हैं जिन्हें इस क्वेरी में इस्तेमाल किया जा सकता है. यहां दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
part string
part पैरामीटर, activity रिसॉर्स की एक या उससे ज़्यादा प्रॉपर्टी की कॉमा से अलग की गई सूची तय करता है. यह सूची, एपीआई के जवाब में शामिल होगी.

अगर पैरामीटर, ऐसी प्रॉपर्टी की पहचान करता है जिसमें चाइल्ड प्रॉपर्टी शामिल हैं, तो जवाब में चाइल्ड प्रॉपर्टी भी शामिल होंगी. उदाहरण के लिए, activity रिसॉर्स में, snippet प्रॉपर्टी में अन्य प्रॉपर्टी शामिल होती हैं. ये प्रॉपर्टी, गतिविधि के टाइप, गतिविधि के लिए दिखने वाले टाइटल वगैरह की पहचान करती हैं. अगर आपने part=snippet सेट किया है, तो एपीआई से मिली जानकारी में नेस्ट की गई वे सभी प्रॉपर्टी भी शामिल होंगी.

यहां दी गई सूची में, part के वे नाम शामिल हैं जिन्हें पैरामीटर वैल्यू में शामिल किया जा सकता है:
  • contentDetails
  • id
  • snippet
फ़िल्टर (इनमें से कोई एक पैरामीटर तय करें)
channelId string
channelId पैरामीटर, YouTube चैनल का यूनीक आईडी तय करता है. इसके बाद, एपीआई उस चैनल की गतिविधियों की सूची दिखाएगा.
home boolean
ध्यान दें: इस पैरामीटर को बंद कर दिया गया है.
इस पैरामीटर को सेट करने वाले अनुरोधों के लिए, एपीआई से मिली जानकारी में ऐसे आइटम शामिल होते हैं जो लॉग आउट किए गए उपयोगकर्ता को YouTube होम पेज पर दिखते हैं. ध्यान दें कि इस पैरामीटर का इस्तेमाल, सिर्फ़ अनुमति वाले अनुरोध में किया जा सकता है.
mine boolean
यह पैरामीटर, सिर्फ़ अनुमति वाले अनुरोध में इस्तेमाल किया जा सकता है. अनुरोध करने वाले उपयोगकर्ता की गतिविधियों का फ़ीड पाने के लिए, इस पैरामीटर की वैल्यू true पर सेट करें.
वैकल्पिक पैरामीटर
maxResults unsigned integer
maxResults पैरामीटर, नतीजों के सेट में ज़्यादा से ज़्यादा आइटम की संख्या तय करता है. 0 से 50 तक की वैल्यू मान्य हैं. डिफ़ॉल्ट वैल्यू 5 है.
pageToken string
pageToken पैरामीटर, नतीजों के सेट में मौजूद किसी खास पेज की पहचान करता है. यह पेज, जवाब के तौर पर दिखाया जाएगा. एपीआई से मिली जानकारी में, nextPageToken और prevPageToken प्रॉपर्टी, उन अन्य पेजों की पहचान करती हैं जिन्हें वापस पाया जा सकता है.
publishedAfter datetime
publishedAfter पैरामीटर, वह शुरुआती तारीख और समय तय करता है जब कोई गतिविधि हुई हो. इससे, उस गतिविधि को एपीआई से मिली जानकारी में शामिल किया जा सकता है. अगर पैरामीटर वैल्यू में सिर्फ़ तारीख तय की जाती है और समय नहीं, तो उस तारीख को हुई सभी गतिविधियां, नतीजों के सेट में शामिल की जाएंगी. वैल्यू, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में तय की जाती है.
publishedBefore datetime
publishedBefore पैरामीटर, वह तारीख और समय तय करता है जिससे पहले कोई गतिविधि हुई हो. इससे, उस गतिविधि को एपीआई से मिली जानकारी में शामिल किया जा सकता है. अगर पैरामीटर की वैल्यू में सिर्फ़ तारीख तय की जाती है और समय नहीं, तो उस तारीख को हुई सभी गतिविधियां, नतीजों के सेट से बाहर रखी जाएंगी. वैल्यू, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में तय की जाती है.
regionCode string
regionCode पैरामीटर, एपीआई को तय किए गए देश के नतीजे दिखाने का निर्देश देता है. पैरामीटर वैल्यू, ISO 3166-1 alpha-2 देश का कोड होती है. YouTube इस वैल्यू का इस्तेमाल तब करता है, जब अनुमति वाले उपयोगकर्ता की YouTube पर पिछली गतिविधि से, गतिविधि का फ़ीड जनरेट करने के लिए ज़रूरी जानकारी नहीं मिलती.

अनुरोध का मुख्य भाग

इस तरीके को कॉल करते समय, अनुरोध का मुख्य भाग न दें.

जवाब

अगर अनुरोध सही से काम करता है, तो यह तरीका, जवाब के मुख्य भाग में यह स्ट्रक्चर दिखाता है:

{
  "kind": "youtube#activityListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    activity Resource
  ]
}

प्रॉपर्टी

यहां दी गई टेबल में, इस रिसॉर्स में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
kind string
इससे, एपीआई रिसॉर्स के टाइप की पहचान होती है. इसकी वैल्यू youtube#activityListResponse होगी.
etag etag
यह इस रिसॉर्स का Etag है.
nextPageToken string
यह टोकन, नतीजों के सेट में अगला पेज पाने के लिए, pageToken पैरामीटर की वैल्यू के तौर पर इस्तेमाल किया जा सकता है.
prevPageToken string
यह टोकन, नतीजों के सेट में पिछला पेज पाने के लिए, pageToken पैरामीटर की वैल्यू के तौर पर इस्तेमाल किया जा सकता है.
pageInfo object
pageInfo ऑब्जेक्ट, नतीजों के सेट के लिए पेजिंग की जानकारी कैप्सूल में बंद करता है.
pageInfo.totalResults integer
नतीजों के सेट में नतीजों की कुल संख्या.
pageInfo.resultsPerPage integer
एपीआई से मिली जानकारी में शामिल नतीजों की संख्या.
items[] list
गतिविधियों या इवेंट की सूची. ये गतिविधियां या इवेंट, अनुरोध के मानदंड के मुताबिक होते हैं.

गड़बड़ियां

यहां दी गई टेबल में, गड़बड़ी के उन मैसेज की पहचान की गई है जो इस तरीके को कॉल करने पर, एपीआई के जवाब में दिख सकते हैं. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी के मैसेज का दस्तावेज़ देखें.

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
forbidden (403) forbidden अनुरोध को अनुमति नहीं मिली है.
forbidden (403) homeParameterDeprecated उपयोगकर्ता के होम पेज की गतिविधि का डेटा, इस एपीआई के ज़रिए उपलब्ध नहीं है. अगर आपने अनुमति न मिलने वाले अनुरोध में, home पैरामीटर की वैल्यू true पर सेट की है, तो यह गड़बड़ी हो सकती है.
notFound (404) channelNotFound अनुरोध के channelId पैरामीटर से पहचाना गया चैनल आईडी नहीं मिला.
notFound (404) homeChannelNotFound फ़िलहाल, अनुमति वाले उपयोगकर्ता के लिए, YouTube के होम पेज का फ़ीड नहीं मिला.
unauthorized (401) authorizationRequired अनुरोध में home पैरामीटर का इस्तेमाल किया गया है, लेकिन उसे अनुमति नहीं मिली है.

इसे आज़माएं!

इस एपीआई को कॉल करने और एपीआई अनुरोध और जवाब को देखने के लिए, APIs Explorer का इस्तेमाल करें.