Google डेटा Java क्लाइंट लाइब्रेरी के साथ शुरू करना

स्टेफ़नी लिउ, Google डेटा एपीआई टीम
सितंबर 2007

1. शुरुआती जानकारी
2. इंस्टॉलिंग डिपेंडेंसी
   1. Windows पर
   2. Mac OS X पर
   3. Linux पर
3. Google डेटा क्लाइंट लाइब्रेरी इंस्टॉल करना
4. रनिंग सैंपल
5. अपने ऐप्लिकेशन बनाना
6. निष्कर्ष
7. अपेंडिक्स: एनवायरमेंट वैरिएबल सेट करना

सुविधा के बारे में जानकारी

किसी अज्ञात API के साथ डेवलप करना कभी भी आसान नहीं होता, इसलिए इस लेख में Google डेटा API ("GData") Java क्लाइंट लाइब्रेरी को डाउनलोड और इंस्टॉल करने के चरण-दर-चरण निर्देश दिए गए हैं. मैं सभी डिपेंडेंसी पाने के साथ-साथ, आपके लिए ज़रूरी एनवायरमेंट वैरिएबल सेट करूंगा/करूंगी. आप कुछ ही समय में अलग-अलग GData सेवाएं मैश कर रहे होंगे!

एक्लिप्स का उपयोग कर रहे हैं?

कोडिंग में शेड को कोडिंग करना: Google Data API के साथ Eclipse का इस्तेमाल करना लेख देखें.

डिपेंडेंसी इंस्टॉल करना

GData Java क्लाइंट लाइब्रेरी में ये बाहरी डिपेंडेंसी होती हैं. नीचे दिए गए सेक्शन में, आपके पसंदीदा ऑपरेटिंग सिस्टम (या उस ओएस पर जिसे आप काम करते समय इस्तेमाल नहीं कर रहे हैं) पर इन डिपेंडेंसी को इंस्टॉल करने का तरीका बताया जाएगा.

• JDK (Java डेवलपमेंट किट) वर्शन 1.5+
• Apache Ant वर्शन 1.7+
• Sun के JavaMail API 1.4+ में mail.jamer
• Sun के JavaBeansऐक्टिवेशनफ़्रेमवर्क में active.jam. यह सिर्फ़ मीडिया सूची से जुड़े एपीआई के लिए ज़रूरी है, जिसमें दस्तावेज़ सूची का डेटा एपीआई, Picasa वेब एल्बम एपीआई, और YouTube डेटा एपीआई शामिल हैं.
• Serlet.Jervet

कुछ .jar डिपेंडेंसी सिर्फ़ खास सैंपल के लिए ज़रूरी होती हैं. हालांकि, बिल्ड से जुड़ी गड़बड़ियों से बचने के लिए, बेहतर होगा कि आप पूरी तरह तैयार रहें. जारी रखने के लिए, अपनी पसंद का ऑपरेटिंग सिस्टम चुनें: Windows, Mac OS X या Linux.

Windows पर

Windows ऑपरेटिंग सिस्टम के लिए निर्देश.

Java इंस्टॉल करना

Java डेवलपमेंट पैकेज, सूरज से JDK (Java डेवलपमेंट किट) के रूप में मिलता है. JRE (Java रनटाइम एनवायरमेंट) और Java ऐप्लिकेशन को लिखने, कंपाइल करने, उसकी जांच करने, और उसे डीबग करने के लिए, आपके पास जो कुछ भी है वह सब इसमें है. अगर आपने पहले से ही Java इंस्टॉल किया हुआ है, तो सीधे Ant. इंस्टॉल करना पर जाएं.

ध्यान दें: JDK इंस्टॉल करने के लिए, आपके पास एडमिन से जुड़ी अनुमतियां होनी चाहिए.

1. http://java.sun.com/javase/download/index.jsp पर जाएं
2. नए अपडेट के आगे "डाउनलोड करें" पर क्लिक करें.
3. लाइसेंस देने के लिए कानूनी समझौता पढ़ें और उसे स्वीकार करें.
4. Windows की कोई एक इंस्टॉलेशन फ़ाइल डाउनलोड करें.
5. इंस्टॉलर चलाएं.
6. javac जैसे JDK एक्ज़ीक्यूटेबल को आसानी से चलाने के लिए, Path एनवायरमेंट वैरिएबल में बदलाव करें. आप जिस पाथ को जोड़ना चाहते हैं वह C:\jdk\bin\ जैसा दिखेगा. Windows में Path वैरिएबल में बदलाव करने का तरीका जानने के लिए, अपेंडिक्स देखें.

अगर आपको JDK इंस्टॉल करने में कोई समस्या है, तो Sun की वेबसाइट पर इंस्टॉलेशन के विस्तृत निर्देश देखें.

चींटियाँ इंस्टॉल करना

Apache Ant जावा के लिए बिल्ड टूल है, जो make से मिलता-जुलता है (लेकिन बेहतर है). इसका इस्तेमाल करके, लाइब्रेरी बनाई जाएगी और सैंपल पूरे किए जाएंगे. अगर आपने पहले से चींटी इंस्टॉल की हुई है, तो देखें कि उसका वर्शन 1.7 या उसके बाद वाला वर्शन है या नहीं.

1. "शुरू करें" मेन्यू पर क्लिक करें. इसके बाद, "चलाएं" पर क्लिक करें.
2. टेक्स्ट फ़ील्ड में cmd टाइप करें.
3. यह देखने के लिए कि आपका वर्शन क्या है, प्रॉम्प्ट में ant -version टाइप करें.

अगर आपके पास 1.7+ है, तो mail.jar पाना शुरू करें. अगर चींटी का आपका वर्शन 1.7 से पहले का है या आपने उसे इंस्टॉल नहीं किया है, तो नीचे दिए गए कदमों का पालन करें.

1. http://ant.apache.org/bindownload.cgi पर जाएं
2. .zip डाउनलोड के लिए, डाउनलोड लिंक पर क्लिक करें.
3. सभी फ़ाइलों को अपनी पसंद की जगह पर निकालें, जैसे कि C:\ant
4. bin डायरेक्ट्री जैसे, C:\ant\bin को अपने Path Environment वैरिएबल में जोड़ें
5. ANT_HOME परिवेश वैरिएबल को नई जगह के तौर पर सेट करने के लिए इसे जोड़ें या इसमें बदलाव करें, जैसे C:\ant
6. Java को इंस्टॉल करने के लिए, JAVA_HOME का एनवायरमेंट वैरिएबल जोड़ें या उसमें बदलाव करें, जैसे कि C:\jdk.

अगर आपको कोई समस्या आती है, तो आपको Ant की वेबसाइट पर इंस्टॉल करने के बारे में ज़्यादा जानकारी मिल सकती है.

mail.व्यवस्थित करें

मीडिया समर्थन के लिए JavaMail API शामिल है.

1. http://java.sun.com/products/javamail/download/index.html पर जाएं
2. "डाउनलोड" बटन पर क्लिक करें. पक्का करें कि आप वर्शन 1.4 या इसके बाद का वर्शन डाउनलोड कर रहे हैं.
3. लाइसेंस देने के लिए कानूनी समझौता पढ़ें और उसे स्वीकार करें.
4. Java फ़ाइल वाले .zip फ़ाइल के लिंक पर क्लिक करें.
5. फ़ाइलों को अपने कंप्यूटर पर निकालें और स्थान को नोट कर लें. mail.jar, रूट डायरेक्ट्री में होगा, javamail-(version)

जो ऐक्टिवेशन.जैर किया जा रहा है

JavaBeans ऐक्टिवेशन फ़्रेमवर्क, मीडिया से जुड़ी सहायता के लिए शामिल है.

1. JAF डाउनलोड पेज पर जाएं.
2. "डाउनलोड" बटन पर क्लिक करें.
3. लाइसेंस देने के लिए कानूनी समझौता पढ़ें और उसे स्वीकार करें.
4. ऐक्टिवेशन फ़्रेमवर्क वाली .zip फ़ाइल के लिंक पर क्लिक करें.
5. फ़ाइलों को अपने कंप्यूटर पर निकालें और स्थान को नोट कर लें. activation.jar, रूट डायरेक्ट्री में होगा, jaf-(version)

सर्वलेट का जा रहा है

servlet.jar (इसे servlet-api.jar भी कहा जा सकता है) आपके सर्वरलेट कंटेनर (J2EE, टॉमकैट, WebLogic वगैरह) पर मौजूद हैं. इसका इस्तेमाल AuthSub और Google Base नमूनों के लिए किया जाता है. नीचे दिए गए निर्देश, टॉमकैट 6.x को पाने के लिए हैं.

1. http://tomcat.apache.org/download-60.cgi पर जाएं
2. कोर बाइनरी डिस्ट्रिब्यूशन के तहत Windows सेवा इंस्टॉलर डाउनलोड पर क्लिक करें.
3. इंस्टॉलर चलाएं.
4. अगर आप डिफ़ॉल्ट मोड पर बने रहते हैं, तो servlet-api.jar को C:\Program Files\Apache Software Foundation\Tomcat 6.0\lib पर स्थित होना चाहिए

टॉमकैट का सेट अप और इंस्टॉलेशन के ज़्यादा दस्तावेज़ यहां देखे जा सकते हैं.

अरे, अब आप GData Java क्लाइंट लाइब्रेरी इंस्टॉल करने के लिए तैयार हैं.

Mac OS X पर

Mac OS X ऑपरेटिंग सिस्टम के लिए निर्देश.

Java इंस्टॉल करना

अगर आप Mac OS X चला रहे हैं, तो आपके पास करने के लिए कम काम है! Apple में हर इंस्टेंस के साथ पूरी तरह से कॉन्फ़िगर किया गया और इस्तेमाल के लिए तैयार JDK (Java डेवलपमेंट किट) है. ज़्यादा जानकारी के लिए, Apple की Java साइट देखें.

चींटियाँ इंस्टॉल करना

Apache Ant जावा के लिए बिल्ड टूल है, जो make से मिलता-जुलता है (लेकिन बेहतर है). इसका इस्तेमाल करके, लाइब्रेरी बनाई जाएगी और सैंपल पूरे किए जाएंगे. आपने शायद चींटी को भी इंस्टॉल कर लिया है, लेकिन देखें कि आपके पास वर्शन 1.7+ है.

1. टर्मिनल विंडो खोलें. (Command + Spacebar, फिर ऐप्लिकेशन ढूंढने के लिए 'टर्मिनल' लिखें)
2. कमांड प्रॉम्प्ट में, यह लिखें:

ant -version

अगर आपकी चींटी का वर्शन 1.7 से पुराना है, तो सबसे नया वर्शन पाने के लिए नीचे दिया गया तरीका अपनाएं.

1. http://ant.apache.org/bindownload.cgi पर जाएं
2. .zip डाउनलोड के लिए, डाउनलोड लिंक पर क्लिक करें.
3. टर्मिनल विंडो खोलें. (Command + Spacebar, फिर ऐप्लिकेशन ढूंढने के लिए 'टर्मिनल' लिखें)
4. कमांड प्रॉम्प्ट में, यह लिखें:
   • cd ~/Desktop
   • sudo sh
   • mv apache-ant-(version)-bin.zip /usr/local/
   • cd /usr/local/
   • unzip apache-ant-(version)-bin.zip
   • chown (your account name):(your account name) apache-ant-(version)
   • ln -s apache-ant-(version) ant

अगर आपको कोई समस्या आती है, तो आपको Ant की वेबसाइट पर इंस्टॉल करने के बारे में ज़्यादा जानकारी मिल सकती है. ब्लॉग पोस्ट में पूरी जानकारी दी गई है कि ऊपर दिए गए शेल कमांड का क्या मतलब है.

mail.व्यवस्थित करें

मीडिया समर्थन के लिए JavaMail API शामिल है.

1. http://java.sun.com/products/javamail/download/index.html पर जाएं
2. "डाउनलोड" बटन पर क्लिक करें. पक्का करें कि आप वर्शन 1.4 या इसके बाद का वर्शन डाउनलोड कर रहे हैं.
3. लाइसेंस देने के लिए कानूनी समझौता पढ़ें और उसे स्वीकार करें.
4. Java फ़ाइल वाले .zip फ़ाइल के लिंक पर क्लिक करें.
5. फ़ाइलों को अपने कंप्यूटर पर निकालें और स्थान को नोट कर लें. mail.jar, रूट डायरेक्ट्री में होगा, javamail-(version)

जो ऐक्टिवेशन.जैर किया जा रहा है

JavaBeans ऐक्टिवेशन फ़्रेमवर्क, मीडिया से जुड़ी सहायता के लिए शामिल है.

1. JAF डाउनलोड पेज पर जाएं.
2. "डाउनलोड" बटन पर क्लिक करें.
3. लाइसेंस देने के लिए कानूनी समझौता पढ़ें और उसे स्वीकार करें.
4. ऐक्टिवेशन फ़्रेमवर्क वाली .zip फ़ाइल के लिंक पर क्लिक करें.
5. फ़ाइलों को अपने कंप्यूटर पर निकालें और स्थान को नोट कर लें. activation.jar, रूट डायरेक्ट्री में होगा, jaf-(version)

सर्वलेट का जा रहा है

servlet.jar (इसे servlet-api.jar भी कहा जा सकता है) आपके सर्वरलेट कंटेनर (J2EE, टॉमकैट, WebLogic वगैरह) पर मौजूद हैं. इसका इस्तेमाल AuthSub और Google Base नमूनों के लिए किया जाता है. नीचे दिए गए निर्देश, टॉमकैट 6.x को पाने के लिए हैं.

1. http://tomcat.apache.org/download-60.cgi पर जाएं
2. कोर बाइनरी डिस्ट्रिब्यूशन के नीचे .zip डाउनलोड पर क्लिक करें.
3. फ़ाइलों को अपने कंप्यूटर पर निकालें और स्थान को नोट कर लें. servlet.jar, apache-tomcat-(version)/lib में मिलेंगे

टॉमकैट का सेट अप और इंस्टॉलेशन के ज़्यादा दस्तावेज़ यहां देखे जा सकते हैं.

अरे, अब आप GData Java क्लाइंट लाइब्रेरी इंस्टॉल करने के लिए तैयार हैं.

Linux पर

Linux ऑपरेटिंग सिस्टम के लिए निर्देश.

Java इंस्टॉल करना

इस ट्यूटोरियल में Sun के JDK (Java डेवलपमेंट किट) का इस्तेमाल किया जाएगा. अगर आपके पास रूट ऐक्सेस है, तो कृपया नीचे दिए गए निर्देशों का पालन करें. अगर ऐसा नहीं है, तो आप इन निर्देशों का पालन करके अपनी होम डायरेक्ट्री में JDK इंस्टॉल कर सकते हैं. अगर आपने पहले से ही JDK 1.5+ इंस्टॉल कर रखा है, तो सीधे Int इंस्टॉल करना पर जाएं.

अगर आपके पास रूट के खास अधिकार हैं, तो:

1. http://java.sun.com/javase/download/index.jsp पर जाएं
2. सबसे नए वर्शन के आगे "डाउनलोड करें" पर क्लिक करें.
3. लाइसेंस देने के लिए कानूनी समझौता पढ़ें और उसे स्वीकार करें.
4. "Linux Platform" में जाकर, आरपीएम फ़ाइल के डेटा को खुद से निकालने की सुविधा पर क्लिक करें और इसे डाउनलोड करें.
5. कोई टर्मिनल विंडो खोलें, उस डायरेक्ट्री में बदलें जहां आपने फ़ाइल डाउनलोड की थी, और ये करें:
• su
• chmod a+x jdk-6(version)-linux-i586-rpm.bin
• ./jdk-6(version)-linux-i586-rpm.bin
• लाइसेंस के लिए कानूनी समझौता स्वीकार करें.

अगर आपके पास रूट के खास अधिकार नहीं हैं, तो:

1. http://java.sun.com/javase/download/index.jsp पर जाएं
2. सबसे नए वर्शन के आगे "डाउनलोड करें" पर क्लिक करें.
3. लाइसेंस देने के लिए कानूनी समझौता पढ़ें और उसे स्वीकार करें.
4. "Linux Platform" में, सेल्फ़ एक्स्ट्रैक्टिंग बिल्ड (आरपीएम नहीं) पर क्लिक करें और उसे डाउनलोड करें.
5. टर्मिनल विंडो खोलें, उस डायरेक्ट्री में बदलें जहां आपने फ़ाइल डाउनलोड की थी, और नीचे दिए गए निर्देश लिखें:
• chmod +x jdk-6(version)-linux-i586-rpm.bin
• उस डायरेक्ट्री में बदलें जहां आपको फ़ाइल इंस्टॉल करनी है.
• सेल्फ़ एक्सट्रैक्टिंग बाइनरी चलाएं. अगर आप उसे मौजूदा डायरेक्ट्री में इंस्टॉल कर रहे हैं, तो आपको सिर्फ़ ./jdk-6(version)-linux-i586-rpm.bin टाइप करना होगा
• लाइसेंस के लिए कानूनी समझौता स्वीकार करें.

अगर आपको समस्या आती है, तो इंस्टॉलेशन के बारे में ज़्यादा जानकारी यहां मिल सकती है.

चींटियाँ इंस्टॉल करना

GData Java क्लाइंट लाइब्रेरी के लिए Ant 1.7 या उसके बाद का वर्शन होना ज़रूरी है. अगर आपने पहले से ही Ant इंस्टॉल किया हुआ है, तो किसी कमांड प्रॉम्प्ट में ant -version टाइप करके वर्शन देखें. अगर आपको सबसे नया वर्शन इंस्टॉल करना है या आपने उसे इंस्टॉल नहीं किया है, तो नीचे दिए गए निर्देशों का पालन करें. अगर आपके Java और Ant इंस्टॉलेशन पहले से सेट हैं, तो mail.jar डाउनलोड करना पर जाएं.

1. http://ant.apache.org/bindownload.cgi पर जाएं
2. .tar.gz डाउनलोड के लिए, डाउनलोड लिंक पर क्लिक करें.
3. एक टर्मिनल विंडो लाकर, डाउनलोड की गई फ़ाइल के साथ निर्देशिका में बदलाव करके और नीचे दिए गए कमांड लिखकर फ़ाइलों को निकालें:
• gunzip apache-ant-(version)-bin.tar.gz
• tar xvf apache-ant-(version)-bin.tar
4. अपने PATH एनवायरमेंट वैरिएबल में चींटियों वाली bin डायरेक्ट्री जोड़ें.
5. ANT_HOME परिवेश वैरिएबल को नई जगह के तौर पर सेट करने के लिए इसे जोड़ें या इसमें बदलाव करें.
6. JDK जिस जगह पर इंस्टॉल किया गया है उसके तौर पर सेट करने के लिए, JAVA_HOME एनवायरमेंट वैरिएबल जोड़ें या उसमें बदलाव करें.

अगर आपको कोई समस्या होती है, तो Ant इंस्टॉलेशन दस्तावेज़ यहां देखें.

mail.व्यवस्थित करें

मीडिया समर्थन के लिए JavaMail API शामिल है.

1. http://java.sun.com/products/javamail/download/index.html पर जाएं
2. "डाउनलोड" बटन पर क्लिक करें. पक्का करें कि आप वर्शन 1.4 या इसके बाद का वर्शन डाउनलोड कर रहे हैं.
3. लाइसेंस देने के लिए कानूनी समझौता पढ़ें और उसे स्वीकार करें.
4. Java फ़ाइल वाले .zip फ़ाइल के लिंक पर क्लिक करें.
5. unzip फ़ाइलें अपने कंप्यूटर पर खोलें और जगह की जानकारी नोट करें. mail.jar, रूट डायरेक्ट्री में होगा, javamail-(version)

जो ऐक्टिवेशन.जैर किया जा रहा है

JavaBeans ऐक्टिवेशन फ़्रेमवर्क, मीडिया से जुड़ी सहायता के लिए शामिल है.

1. JAF डाउनलोड पेज पर जाएं.
2. "डाउनलोड" बटन पर क्लिक करें.
3. लाइसेंस देने के लिए कानूनी समझौता पढ़ें और उसे स्वीकार करें.
4. ऐक्टिवेशन फ़्रेमवर्क वाली .zip फ़ाइल के लिंक पर क्लिक करें.
5. unzip फ़ाइलें अपने कंप्यूटर पर खोलें और जगह की जानकारी नोट करें. activation.jar, रूट डायरेक्ट्री में होगा, jaf-(version)

सर्वलेट का जा रहा है

servlet.jar (इसे servlet-api.jar भी कहा जा सकता है) आपके सर्वरलेट कंटेनर (J2EE, टॉमकैट, WebLogic वगैरह) पर मौजूद हैं. इसका इस्तेमाल AuthSub और Google Base नमूनों के लिए किया जाता है. नीचे दिए गए निर्देश, टॉमकैट 6.x को पाने के लिए हैं.

1. http://tomcat.apache.org/download-60.cgi पर जाएं
2. कोर बाइनरी डिस्ट्रिब्यूशन के तहत .tar.gz फ़ाइल डाउनलोड करें.
3. डाउनलोड को gunzip और tar के साथ अनपैकेज करें. इसके बारे में ऊपर, इंस्टॉलिंग एंट सेक्शन में बताया गया है.
4. servlet.jar, apache-tomcat-(version)/lib में मिलेंगे

अब आपके पास GData Java क्लाइंट लाइब्रेरी पाने के लिए सभी ज़रूरी चीज़ें मौजूद हैं!

Google डेटा क्लाइंट लाइब्रेरी इंस्टॉल करना

1. http://code.google.com/p/gdata-java-client/download/list पर जाएं
2. क्लाइंट लाइब्रेरी (gdata-src.java-1.x.x.java.zip) और सैंपल (gdata-samples.java-1.x.x.java.zip) का नया वर्शन डाउनलोड करें.
3. अपने कंप्यूटर पर क्लाइंट लाइब्रेरी का स्रोत निकालें.
4. gdata/java/build-src/build.properties पर जाएं और फ़ाइल खोलें.
5. अपनी लोकल मशीन पर मौजूद .jar फ़ाइलों की लोकेशन के बारे में बताने के लिए, बाहरी डिपेंडेंसी में बदलाव करें.

ध्यान दें: Windows पर, बैकस्लैश को एस्केप करना न भूलें. उदाहरण के लिए,

servlet.jar=C:\\Program Files\\Apache Software Foundation\\Tomcat 6.0\\lib\\servlet-api.jar

चल रहे नमूने

सभी उपलब्ध नमूने gdata-samples.java-1.x.x.java.zip संग्रह में gdata/java/sample के तहत मौजूद हैं. gdata/java/build-samples/build.properties फ़ाइल में, लाइब्रेरी में मौजूद नमूनों की सभी इनपुट वैल्यू शामिल हैं. sample.credentials.username और sample.credentials.password को एक मान्य उपयोगकर्ता नाम और पासवर्ड पर सेट करें. हम चींटी का इस्तेमाल नमूने बनाने और साथ ही नमूनों को चलाने के लिए कर सकते हैं.

आपने कमांड प्रॉम्प्ट खोलकर और gdata/java डायरेक्ट्री में बदलाव करके, यह देखा है कि आपने सब कुछ सही तरीके से इंस्टॉल किया है या नहीं. इसके लिए, टाइप करें:

ant -f build-samples.xml sample.calendar.run

आपको कुछ जानकारी या चेतावनी मैसेज मिल सकते हैं, लेकिन आखिर में BUILD SUCCESSFUL मैसेज ढूंढें! अगर आपको गड़बड़ी का मैसेज नहीं मिलता है, तो समस्या का हल वाला सेक्शन देखें.

टाइप करके ज़्यादा इंटरैक्टिव नमूना आज़माएं:

ant -f build-samples.xml sample.spreadsheet.guidemo.run

किसी खास नमूने को चलाने का तरीका जानने के लिए, gdata/java/build-samples पर जाएं और उस नमूने की बिल्ड फ़ाइल देखें. samples run सेक्शन ढूंढें.

समस्या हल करना

अगर आपका बिल्ड इस तरह के गड़बड़ी मैसेज के साथ काम नहीं करता,

BUILD FAILED
Target 'core.sample.core.util.build' does not exist in this project. It is used from target 'sample.calendar.build'.

Total time: 0 seconds

या प्रोजेक्ट से एक ज़रूरी फ़ाइल के बारे में एक जैसी गड़बड़ी का मैसेज हो सकता है, तो शायद आप Ant का पुराना वर्शन चला रहे हों. यह पक्का करने के लिए कि 1.7 या इसके बाद का वर्शन चल रहा है, ant -version टाइप करें. Ant.

अपने ऐप्लिकेशन बनाना

अगला सवाल खुद का ऐप्लिकेशन बनाने का है. मूल काम को प्रदर्शित करने के लिए कैलेंडर सेवा का उपयोग करते हुए मुझे "हैलो, विश्व!" समान कार्यक्रम के बारे में जानकारी दी जाएगी. ज़्यादा जानकारी के लिए, Java क्लाइंट लाइब्रेरी की डेवलपर गाइड और अलग-अलग प्रॉडक्ट के डेवलपर गाइड में जाएं.

CalendarTest.java नाम की फ़ाइल बनाएं. नीचे दिए गए इंपोर्ट स्टेटमेंट को शामिल करके शुरुआत करें.

import com.google.gdata.client.*;
import com.google.gdata.client.calendar.*;
import com.google.gdata.data.*;
import com.google.gdata.data.acl.*;
import com.google.gdata.data.calendar.*;
import com.google.gdata.data.extensions.*;
import com.google.gdata.util.*;

import java.net.*;
import java.io.*;

import sample.util.*;

यहां पूरा प्रोग्राम दिया गया है (बिना किसी अपवाद के हैंडल करने की सुविधा).

public class CalendarTest {

    public static void main(String[] args) {
        CalendarService myService = new CalendarService("exampleCo-exampleApp-1.0");
        myService.setUserCredentials("[e-mail]", "pa$$word");

        URL feedUrl = new URL("http://www.google.com/calendar/feeds/default/allcalendars/full");
        CalendarFeed resultFeed = myService.getFeed(feedUrl, CalendarFeed.class);

        System.out.println("Your calendars:");
        System.out.println();

        for (int i = 0; i < resultFeed.getEntries().size(); i++) {
          CalendarEntry entry = resultFeed.getEntries().get(i);
          System.out.println("\t" + entry.getTitle().getPlainText());
        }

    }
}

This little program will request all the calendars you own and display all the titles. It's a little longer than the canonical "Hello, World!" example, but it's very simple once we break it down. The first couple of lines creates a service object and sets the user credentials.

CalendarService myService = new CalendarService("exampleCo-exampleApp-1.0");
myService.setUserCredentials("[e-mail]", "pa$$word");

रिसॉर्स का यूआरएल सेट हो जाता है. इस मामले में, पुष्टि किए गए उपयोगकर्ता के सभी कैलेंडर की सूची यहां मांगी जा सकती है.

URL feedUrl = new URL("http://www.google.com/calendar/feeds/default/allcalendars/full");

नीचे दी गई लाइन, यूआरएल पर असल GET निर्देश को लागू करेगी. साथ ही, नतीजे वाले फ़ीड को एक बेहतर ऑब्जेक्ट में डाल देगी.

CalendarFeed resultFeed = myService.getFeed(feedUrl, CalendarFeed.class);

नीचे दिया गया for लूप हर एंट्री में बदलाव करेगा और शीर्षक प्रिंट करेगा. ध्यान रखें कि शीर्षक को TextConstruct के तौर पर सेव किया जाता है. इसलिए, सादा टेक्स्ट पाने के लिए, फ़ंक्शन को ज़्यादा कॉल करना पड़ता है.

for (int i = 0; i < resultFeed.getEntries().size(); i++) {
    CalendarEntry entry = resultFeed.getEntries().get(i);
    System.out.println("\t" + entry.getTitle().getPlainText());
}

यह बुनियादी बात थी - कुछ और सामान्य चीज़ों पर बात करते हैं. इस स्निपेट में, ऑब्जेक्ट बनाने और उसे जोड़ने का तरीका बताया गया है. उदाहरण के लिए, यह एक नई कैलेंडर इवेंट एंट्री होगी.

URL postURL = new URL("http://www.google.com/calendar/feeds/[e-mail]/private/full");
CalendarEventEntry myEvent = new CalendarEventEntry();

//Set the title and description
myEvent.setTitle(new PlainTextConstruct("Pi Day Party"));
myEvent.setContent(new PlainTextConstruct("I am throwing a Pi Day Party!"));

//Create DateTime events and create a When object to hold them, then add
//the When event to the event
DateTime startTime = DateTime.parseDateTime("2007-03-14T15:00:00-08:00");
DateTime endTime = DateTime.parseDateTime("2007-03-14T17:00:00-08:00");
When eventTimes = new When();
eventTimes.setStartTime(startTime);
eventTimes.setEndTime(endTime);
myEvent.addTime(eventTimes);

// POST the request and receive the response:
CalendarEventEntry insertedEntry = myService.insert(postURL, myEvent);

दूसरा सामान्य काम क्वेरी बनाना है.

//Create a new query object and set the parameters
Query myQuery = new Query(feedURL);
myQuery.setFullTextQuery("Pi");

//Send the request with the built query URL
CalendarEventFeed myResultsFeed = myService.query(myQuery, CalendarEventFeed.class);

//Take the first match and print the title
if (myResultsFeed.getEntries().size() > 0) {
    CalendarEventEntry firstMatchEntry = new CalendarEventEntry();
    myResultsFeed.getEntries().get(0);
    System.out.println(firstMatchEntry.getTitle().getPlainText());
}

डीबग करते समय, एक अन्य ज़रूरी कार्रवाई, रॉ एक्सएमएल को डंप करना है. इस लाइब्रेरी को इस्तेमाल करने का एक आसान तरीका है. पक्का करें कि samples.util.* इंपोर्ट किया गया हो. इसके बाद, फ़ीड या एंट्री को डंप करें.

CommonUtils.dump(resultFeed, System.out);

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

इससे, आपको यह पता चलेगा कि क्लाइंट लाइब्रेरी का इस्तेमाल करके, ऐप्लिकेशन कैसे बनाए जा रहे हैं. ज़्यादा जानकारी के लिए, हर Google Data API के लिए उपलब्ध डेवलपर गाइड की सूची देखने के लिए, आखिर का सेक्शन देखें.

नतीजा

हम उम्मीद करते हैं कि अब आप GData Java क्लाइंट लाइब्रेरी का उपयोग करके ऐप्लिकेशन बना और चला सकेंगे! मैंने आपके लिए कोई मशहूर आईडीई इस्तेमाल नहीं की है, लेकिन Eclipse या NetBeans जैसे लोकप्रिय टूल के बारे में जानें. यहां कुछ और लिंक दिए गए हैं जो आपके काम आ सकते हैं:

• GData Java क्लाइंट लाइब्रेरी का होम पेज
• Google के डेटा एपीआई की सूची
• Java डेवलपर गाइड, इन Google Data API के लिए उपलब्ध हैं:
  • Shopping के लिए Content API
  • Blogger
  • संपर्क
  • Google Calendar
  • Google दस्तावेज़ों की सूची
  • Google Finance
  • Google स्प्रेडशीट
  • Google Search Console
  • YouTube
• शैडो में कोडिंग: Google Data API के साथ Eclipse का इस्तेमाल करना
• Google डेटा एपीआई Java क्लाइंट Eclipse प्लग-इन

अगर आपके पास किसी एपीआई के साथ Java क्लाइंट लाइब्रेरी के इस्तेमाल से जुड़ा कोई सवाल है, तो हमें बताएं. इसके लिए, एपीआई से जुड़े फ़ोरम में पोस्ट करें.

अन्य जानकारी: एनवायरमेंट वैरिएबल सेट करना

Windows या Linux पर अपने एनवायरमेंट वैरिएबल सेट करने के निर्देश. आपको Mac OS X के लिए कुछ भी सेट नहीं करना होगा.

Windows

सिस्टम वैरिएबल, कंप्यूटर पर मौजूद सभी उपयोगकर्ताओं पर लागू होंगे. अगर आपके पास एडमिन के खास अधिकार नहीं हैं, इसलिए आप सिस्टम वैरिएबल में बदलाव नहीं कर सकते. इसके लिए, यहां दिए गए निर्देशों का पालन करें.

अगर आपके पास एडमिन के अधिकार हैं, तो:

1. "मेरा कंप्यूटर" दायां क्लिक करें और "प्रॉपर्टी" चुनें.
2. "बेहतर सेटिंग" टैब पर क्लिक करें.
3. "एनवायरमेंट" पर क्लिक करें.
4. सिस्टम वैरिएबल "जोड़ें" या "बदलाव करें". अपनी स्थानीय मशीन पर जगह की जानकारी डालें
• ANT_HOME को जोड़ें या उसमें बदलाव करें और वैल्यू को C:\ant पर सेट करें
• JAVA_HOME को जोड़ें या उसमें बदलाव करें और वैल्यू को C:\jdk पर सेट करें
• Path को जोड़ें या उसमें बदलाव करें और ;C:\ant\bin;C:\jdk\bin को आखिर में जोड़ें (अर्धविराम, डायरेक्ट्री पाथ को अलग करता है)
• आपको जिन सेवाओं के साथ काम करना है उनके हिसाब से, CLASSPATH फ़ाइलों को जोड़ें या उनमें बदलाव करें. साथ ही, .jar की फ़ाइलें जोड़ें. पक्का करें कि "." &mash शामिल किया गया है; यह मौजूदा डायरेक्ट्री के बारे में बताता है. .;C:\gdata\java\lib\gdata-core-1.0.jar;C:\gdata\java\lib\gdata-calendar-1.0.jar, वगैरह.
5. यह पक्का करने के लिए कि ये लागू हों, डिवाइस को फिर से चालू करें.

ध्यान दें: पक्का करें कि वैरिएबल में कोट (या तो ' या ") न हों और \ या / पर खत्म न हों.

अगर आपके पास एडमिन के अधिकार नहीं हैं, तो:

1. "मेरा कंप्यूटर" दायां क्लिक करें और "प्रॉपर्टी" चुनें.
2. "बेहतर सेटिंग" टैब पर क्लिक करें.
3. "एनवायरमेंट" पर क्लिक करें.
4. उपयोगकर्ता वैरिएबल "जोड़ें" या "बदलाव करें"
• ANT_HOME को जोड़ें या उसमें बदलाव करें और वैल्यू को C:\ant पर सेट करें
• JAVA_HOME को जोड़ें या उसमें बदलाव करें और वैल्यू को C:\jdk पर सेट करें
• Path को जोड़ें या उसमें बदलाव करें और ;C:\ant\bin;C:\jdk\bin को आखिर में जोड़ें (अर्धविराम, डायरेक्ट्री पाथ को अलग करता है)
• आपको जिन सेवाओं के साथ काम करना है उनके हिसाब से, CLASSPATH फ़ाइलों को जोड़ें या उनमें बदलाव करें. साथ ही, .jar की फ़ाइलें जोड़ें. पक्का करें कि "." &mash शामिल किया गया है; यह मौजूदा डायरेक्ट्री के बारे में बताता है. .;C:\gdata\java\lib\gdata-core-1.0.jar;C:\gdata\java\lib\gdata-calendar-1.0.jar, वगैरह.
5. यह पक्का करने के लिए कि ये लागू हों, डिवाइस को फिर से चालू करें.

ध्यान दें: पक्का करें कि वैरिएबल में कोट (या तो ' या ") न हों और \ या / पर खत्म न हों.

आपने अभी जिन उपयोगकर्ता वैरिएबल में बदलाव किए हैं वे सिर्फ़ आपकी उपयोगकर्ता प्रोफ़ाइल पर लागू होंगे.

Linux

1. अपनी होम डायरेक्ट्री में मौजूद, .bash_profile एडिटर को अपनी पसंद के एडिटर में खोलें.
2. अपने.bash_profile में नीचे दी गई जानकारी जोड़ें और अपनी मशीन पर फ़ाइलों की असल जगह डालें:
• export ANT_HOME=/usr/local/ant
• export JAVA_HOME=/usr/local/jdk
• export PATH=${PATH}:${ANT_HOME}/bin
• आपको जिन सेवाओं का उपयोग करना है उनके लिए आपको .jar फ़ाइलें जोड़नी होंगी. उदाहरण के लिए, export CLASSPATH=${CLASSPATH}:/home/username/gdata/java/lib/gdata-core-1.0.jar:/home/username/gdata/java/lib/gdata-calendar-1.0.jar:/home/username/gdata/java/sample/util/lib/sample-util.jar
3. वैरिएबल इंस्टॉल करने के लिए source .bash_profile

ध्यान दें: पक्का करें कि वैरिएबल में कोट (या तो ' या ") न हों और \ या / पर खत्म न हों.