job
संसाधन, शेड्यूल किए गए रिपोर्टिंग जॉब के बारे में बताता है. रिपोर्टिंग जॉब एक खास रिपोर्ट की पहचान करती है, जिसे YouTube किसी खास चैनल या कॉन्टेंट के मालिक के लिए हर दिन तैयार करता है.
तरीके
इस टेबल में वे तरीके दिखाए गए हैं जो एपीआई, job
संसाधनों के लिए इस्तेमाल करते हैं.
तरीके | |
---|---|
create |
रिपोर्टिंग जॉब बनाता है. रिपोर्टिंग जॉब बनाकर, आप YouTube को यह निर्देश दे रहे हैं कि वह हर दिन की रिपोर्ट जनरेट करे. रिपोर्ट, जॉब बनाए जाने के बाद 24 घंटे के अंदर उपलब्ध हो जाती है. |
delete |
रिपोर्टिंग जॉब को मिटाता है. |
get |
चैनल या कॉन्टेंट के मालिक के लिए शेड्यूल किए गए किसी खास काम के बारे में जानकारी हासिल करता है. |
list |
यह किसी चैनल या कॉन्टेंट के मालिक के लिए शेड्यूल की गई जॉब की जानकारी देता है. रिस्पॉन्स के हर संसाधन में एक id प्रॉपर्टी होती है. इस प्रॉपर्टी से उस आईडी के बारे में पता चलता है जिसका इस्तेमाल YouTube, खास तौर पर नौकरी की पहचान करने के लिए करता है. जॉब के लिए जनरेट की गई रिपोर्ट की सूची फिर से पाने के लिए या जॉब को मिटाने के लिए, आपको उस आईडी की ज़रूरत है. |
JSON के रिसॉर्स रिप्रज़ेंटेशन
नीचे दी गई JSON संरचना, job
संसाधन का फ़ॉर्मैट दिखाती है:
{ "id": string, "reportTypeId": string, "name": string, "createTime": timestamp, "expireTime": timestamp, "systemManaged": boolean }
प्रॉपर्टी
यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:
प्रॉपर्टी | |
---|---|
id |
string इस आईडी का इस्तेमाल YouTube, रिपोर्टिंग जॉब की खास तरह से पहचान करने के लिए करता है. वैल्यू में ज़्यादा से ज़्यादा 40 वर्ण इस्तेमाल किए जा सकते हैं. |
reportTypeId |
string नौकरी की बनाई गई रिपोर्ट का टाइप. प्रॉपर्टी की वैल्यू, reportTypes.list तरीके से मिले reportType के id के id से मेल खाती है. |
name |
string एक नाम जिसे YouTube, नौकरी के बारे में बताने के लिए जनरेट करता है. वैल्यू में ज़्यादा से ज़्यादा 100 वर्ण इस्तेमाल किए जा सकते हैं. |
createTime |
timestamp वह तारीख और समय, जब जॉब को बनाया गया. प्रॉपर्टी की वैल्यू, RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप है. यह माइक्रोसेकंड तक सटीक होता है. उदाहरण: "2015-10-02T15:01:23.045678Z" . |
expireTime |
timestamp वह तारीख और समय जब नौकरी खत्म हो गई या खत्म हो जाएगी. प्रॉपर्टी की वैल्यू, RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप है. यह माइक्रोसेकंड तक सटीक होता है. उदाहरण: "2015-10-02T15:01:23.045678Z" .इस प्रॉपर्टी में वैल्यू तब मौजूद होती है, जब जॉब के साथ जुड़ी रिपोर्ट के टाइप का इस्तेमाल बंद कर दिया गया हो या काफ़ी समय से नौकरी के लिए जनरेट की गई रिपोर्ट डाउनलोड नहीं की गई हों. यह वैल्यू वह तारीख होती है जिसके बाद YouTube, नौकरी के लिए नई रिपोर्ट जनरेट नहीं करता. अगर आपके पास कोई ऐसा काम है जिसके खत्म होने की तारीख का पता चलता है, तो आपको अपने सिस्टम को अपडेट करना होगा, ताकि उस तारीख तक रिपोर्ट का अनुरोध करना बंद कर दिया जाए. कुछ मामलों में, वीडियो बदलने की रिपोर्ट उपलब्ध हो सकती है. |
systemManaged |
boolean अगर जॉब, सिस्टम से मैनेज की जाने वाली रिपोर्ट जनरेट करता है, तो यह वैल्यू true होती है. YouTube, कॉन्टेंट के जिन मालिकों के पास YouTube Creator Studio में इन रिपोर्ट का ऐक्सेस है उनके लिए, सिस्टम से मैनेज होने वाली रिपोर्ट अपने-आप जनरेट होती हैं. कॉन्टेंट के मालिक उन रिपोर्ट को बनाने वाले जॉब में न तो बदलाव कर सकते हैं और न ही उन्हें मिटा सकते हैं. |