कोड के नमूने चलाएं

cURL

सेट अप करें

1. अपने ऐप्लिकेशन के लिए कोई प्रोजेक्ट बनाने या चुनने और एपीआई चालू करने के लिए, एपीआई दस्तावेज़ में दिए गए निर्देशों का पालन करें.
2. Cloud Console में, एपीआई पासकोड बनाएं.
3. Cloud Console में, वेब ऐप्लिकेशन के लिए OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. साथ ही, रीडायरेक्ट यूआरआई के तौर पर https://developers.google.com/oauthplayground का इस्तेमाल करें.
4. OAuth 2.0 Playground में, OAuth 2.0 कॉन्फ़िगरेशन settings पर क्लिक करें.
5. अपने क्रेडेंशियल का इस्तेमाल करें पर सही का निशान लगाएं.
6. तीसरे चरण में जनरेट किया गया क्लाइंट आईडी और क्लाइंट सीक्रेट डालें.
7. स्कोप फ़ील्ड में, अपने तरीके के साथ इस्तेमाल किया जाने वाला स्कोप टाइप करें. इसके बाद, एपीआई को अनुमति दें पर क्लिक करें.
8. (ज़रूरी नहीं) अगर आपको साइन इन करने की स्क्रीन दिखती है, तो वह खाता चुनें जिसका इस्तेमाल करना है.
9. (ज़रूरी नहीं) अगर आपको अनुमति देने के लिए स्क्रीन दिखती है, तो स्वीकार करें पर क्लिक करें.
10. टोकन के लिए ऑथराइज़ेशन कोड बदलें पर क्लिक करें. एक टोकन वापस कर दिया जाता है.
11. cURL कोड सैंपल में, [YOUR_API_KEY] को दूसरे चरण में जनरेट किए गए एपीआई पासकोड से बदलें: 'https://www.googleapis.com/drive/v3/files?key=[YOUR_API_KEY]' \
12. cURL कोड सैंपल में, [YOUR_ACCESS_TOKEN] की जगह 10वें चरण में जनरेट किया गया ऐक्सेस टोकन डालें: --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \

कोड का सैंपल लागू करना

कमांड लाइन से, cURL कमांड चलाएं. कमांड इस तरह की होनी चाहिए:

curl \
'https://www.googleapis.com/drive/v3/files?key=AIzaSyBiKcaoXmVApwnT24hitQG_dwjGvAj6Ddw' \
--header 'Authorization: Bearer ya29.a0ARrdaM_yQn9MWBpJgKPx880BSnRYIizRYIDz0JN9e66nSliIYpqNXmPsvv2ccfplCTG_U4b1' \
--header 'Accept: application/json' \
--compressed

JavaScript

सेट अप करें

1. अपने ऐप्लिकेशन के लिए कोई प्रोजेक्ट बनाने या चुनने और एपीआई चालू करने के लिए, एपीआई दस्तावेज़ में दिए गए निर्देशों का पालन करें.
2. Cloud Console में, एक एपीआई पासकोड बनाएं.
3. क्लाउड कंसोल में, "वेब ऐप्लिकेशन" के लिए OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. साथ ही, अनुमति वाले JavaScript ऑरिजिन सेट करें, ताकि उस यूआरएल की पहचान की जा सके जिससे आपको अनुरोध भेजने हैं. जैसे, http://localhost.
4. पूरे कोड सैंपल को ऐसी लोकल फ़ाइल में कॉपी करें जिसे आपका वेब सर्वर ऐक्सेस कर सके. जैसे, /var/www/html/example.html.

5. कोड के सैंपल में, वह लाइन ढूंढें जो एपीआई कुंजी या क्लाइंट आईडी सेट करती है. इसके बाद, वैल्यू को दूसरे और तीसरे चरण में जनरेट की गई वैल्यू से बदलें:

   • एपीआई पासकोड: gapi.client.setApiKey(YOUR_API_KEY);
   • OAuth 2.0 क्लाइंट आईडी: gapi.client.init({ 'clientId': 'YOUR_CLIENT_ID',

कोड का सैंपल लागू करना

1. अपनी फ़ाइल को ब्राउज़र में खोलें. जैसे, http://localhost/example.html. हमारा सुझाव है कि डीबग करने वाले कंसोल वाले ब्राउज़र का इस्तेमाल करें. जैसे, Google Chrome.
2. (ज़रूरी नहीं) अगर आपको साइन इन करने की स्क्रीन दिखती है, तो वह खाता चुनें जिसका इस्तेमाल करना है.
3. (ज़रूरी नहीं) अगर आपको अनुमति देने के लिए स्क्रीन दिखती है, तो स्वीकार करें पर क्लिक करें. डीबगिंग कंसोल में, JSON ऑब्जेक्ट के तौर पर तरीके का जवाब दिखना चाहिए.

Java

ज़रूरी शर्तें

• Java 1.7 या इसके बाद का वर्शन.
• Gradle 7 या इसके बाद का वर्शन.

सेट अप करें

1. अपने ऐप्लिकेशन के लिए कोई प्रोजेक्ट बनाने या चुनने और एपीआई चालू करने के लिए, एपीआई दस्तावेज़ में दिए गए निर्देशों का पालन करें.
2. यह तरीका जिस तरह के डेटा को ऐक्सेस कर रहा है उसके आधार पर, एपीआई कुंजी (सार्वजनिक डेटा) बनाएं या OAuth 2.0 क्लाइंट आईडी (निजी डेटा) बनाएं.
3. ऐप्लिकेशन टाइप को डेस्कटॉप ऐप्लिकेशन पर सेट करें.
4. अगर आपने OAuth 2.0 क्लाइंट आईडी बनाया है, तो OAuth 2.0 क्रेडेंशियल वाली JSON फ़ाइल डाउनलोड करें. इस फ़ाइल का नाम client_secret_CLIENTID.json जैसा होता है. इसमें CLIENTID आपके प्रोजेक्ट का क्लाइंट आईडी होता है.

5. अपनी वर्किंग डायरेक्ट्री में, नया प्रोजेक्ट स्ट्रक्चर बनाने के लिए ये कमांड चलाएं:

   $ gradle init --type basic
   $ mkdir -p src/main/java src/main/resources
   

6. अगर आपने दूसरे चरण में OAuth 2.0 क्लाइंट आईडी बनाया है, तो डाउनलोड की गई JSON फ़ाइल का नाम बदलकर client_secret.json कर दें.

7. नाम बदली गई फ़ाइल को उस src/main/resources डायरेक्ट्री में सेव करें जिसे आपने पाँचवें चरण में बनाया था.

8. अपनी वर्किंग डायरेक्ट्री में, build.gradle फ़ाइल खोलें और इसके कॉन्टेंट को इससे बदलें:

   apply plugin: 'java'
   apply plugin: 'application'
   
   mainClassName = 'ApiExample'
   sourceCompatibility = 1.7
   targetCompatibility = 1.7
   version = '1.0'
   
   repositories {
       mavenCentral()
   }
   
   dependencies {
       compile 'com.google.api-client:google-api-client:1.23.0'
       compile 'com.google.oauth-client:google-oauth-client-jetty:1.23.0'
       API_SPECIFIC_DEPENDENCY
   }
   

9. build.gradle फ़ाइल में, API_SPECIFIC_DEPENDENCY वाली लाइन को उस एपीआई के लिए कोड कंपाइल करने के निर्देश से बदलें जिसे कॉल किया जा रहा है. YouTube Analytics API का सैंपल यहां दिया गया है:

   compile 'com.google.apis:google-api-services-youtubeAnalytics:v2-rev16-1.23.0'
   

   निर्देश इस टेंप्लेट के मुताबिक होता है:

   compile 'com.google.apis:google-api-services-API_NAME:API_VERSION-   revREVISION-CL_VERSION'
   

कहां:

• API_NAME, GitHub पर एपीआई के लिए दिया गया एपीआई का नाम है. नाम ढूंढने के लिए, Google के साथ काम करने वाले एपीआई पेज पर, अपने एपीआई के बगल में मौजूद वर्शन लिंक पर क्लिक करें. वर्शन लिंक, GitHub पर ले जाता है. एपीआई का नाम, पेज के ऊपर बीच में होता है और इसके पहले googleapis/google-apis-services- होता है. उदाहरण के लिए, Drive API के v3 के लिए, API_NAME, drive है.
• API_VERSION, एपीआई का वह वर्शन है जो 'Google के साथ काम करने वाले एपीआई' पेज पर, एपीआई के नाम के नीचे दिया गया है.
• REVISION, एपीआई के लिए JavaDoc रेफ़रंस में दिया गया वर्शन नंबर है. JavaDoc रेफ़रंस यहां देखा जा सकता है: https://googleapis.dev/java/google-api-services-API_NAME/latest/index.html
• CL_VERSION क्लाइंट लाइब्रेरी का वर्शन है. यह वैल्यू, JavaDoc रेफ़रंस में भी दिखती है.
• अपनी वर्किंग डायरेक्ट्री से, APIs Explorer से कोड सैंपल को src/main/java/ApiExample.java में कॉपी करें. (हर सैंपल में क्लास का नाम ApiExample है, ताकि अलग-अलग सैंपल चलाने के लिए आपको build.gradle फ़ाइल में बदलाव न करना पड़े.

कोड का सैंपल लागू करना

उदाहरण को चलाने के लिए, इस कमांड का इस्तेमाल करें:

  gradle -q run

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

Node.js

ज़रूरी शर्तें

• Node.js

• Node.js के लिए Google APIs Client Library:

  • अगर आपने क्लाइंट लाइब्रेरी को पहले इंस्टॉल नहीं किया है, तो यह कमांड चलाएं:

  npm install googleapis --save
  

  • अगर आपने पहले से ही क्लाइंट लाइब्रेरी इंस्टॉल की हुई है, तो हमारा सुझाव है कि आप उसे अपडेट करें. इससे यह पक्का किया जा सकेगा कि आपके पास उस लाइब्रेरी के सबसे नए क्लास हैं जिसकी आपको जाँच करनी है. क्लाइंट लाइब्रेरी को अपडेट करने के लिए, यह कमांड चलाएं:

  npm update googleapis --save
  

सेट अप करें

1. अपने ऐप्लिकेशन के लिए कोई प्रोजेक्ट बनाने या चुनने और एपीआई चालू करने के लिए, एपीआई दस्तावेज़ में दिए गए निर्देशों का पालन करें.
2. यह तरीका जिस तरह के डेटा को ऐक्सेस कर रहा है उसके आधार पर, एपीआई कुंजी (सार्वजनिक डेटा) बनाएं या OAuth 2.0 क्लाइंट आईडी (निजी डेटा) बनाएं.
3. ऐप्लिकेशन टाइप को डेस्कटॉप ऐप्लिकेशन पर सेट करें.
4. अगर आपने OAuth 2.0 क्लाइंट आईडी बनाया है, तो OAuth 2.0 क्रेडेंशियल वाली JSON फ़ाइल डाउनलोड करें. इस फ़ाइल का नाम client_secret_CLIENTID.json जैसा होता है. इसमें CLIENTID आपके प्रोजेक्ट का क्लाइंट आईडी होता है.
5. कोड के सैंपल को किसी लोकल फ़ाइल में कॉपी करें. इसके बाद, सैंपल में बदलाव करके अपनी एपीआई पासकोड या क्लाइंट सीक्रेट फ़ाइल की सही पहचान करें. इस सैंपल में, एपीआई पासकोड की वैल्यू YOUR_API_KEY है और क्लाइंट सीक्रेट फ़ाइल की जगह YOUR_CLIENT_SECRET_FILE.json है.

कोड का सैंपल लागू करना

उदाहरण को चलाने के लिए, इस कमांड का इस्तेमाल करें:

  node sample.js

ज़्यादातर सैंपल, एपीआई से मिले रिस्पॉन्स (या कुछ और) को STDOUT में प्रिंट करते हैं.

PHP

ज़रूरी शर्तें

• PHP 5.4 या इसके बाद का वर्शन, जिसमें कमांड-लाइन इंटरफ़ेस (सीएलआई) और JSON एक्सटेंशन हो.
• Composer डिपेंडेंसी मैनेजमेंट टूल को ग्लोबल लेवल पर इंस्टॉल किया गया हो.

• PHP के लिए Google APIs Client Library:

  • अगर आपने क्लाइंट लाइब्रेरी को पहले इंस्टॉल नहीं किया है, तो यह कमांड चलाएं:

    composer require google/apiclient:^2.0
    

  • अगर आपने पहले क्लाइंट लाइब्रेरी इंस्टॉल की थी, तो हमारा सुझाव है कि आप इसे अपडेट करें. इससे यह पक्का किया जा सकेगा कि आपके पास उस लाइब्रेरी के सबसे नए क्लास हैं जिसकी आपको जाँच करनी है. क्लाइंट लाइब्रेरी को अपडेट करने के लिए, यह कमांड चलाएं:

    composer update google/apiclient --with-dependencies
    

कोड का सैंपल लागू करना

उदाहरण को चलाने के लिए, इस कमांड का इस्तेमाल करें:

  php sample.php

ज़्यादातर सैंपल, एपीआई से मिले रिस्पॉन्स (या कुछ और) को STDOUT में प्रिंट करते हैं.

Python

ज़रूरी शर्तें

• Python 2.7 या Python 3.5+
• pip पैकेज मैनेजमेंट टूल

• Python के लिए Google APIs क्लाइंट लाइब्रेरी:

  pip install --upgrade google-api-python-client
  

• उपयोगकर्ता की पुष्टि करने के लिए google-auth-oauthlib और google-auth-httplib2 लाइब्रेरी:

  pip install --upgrade google-auth-oauthlib google-auth-httplib2
  

सेट अप करें

1. अपने ऐप्लिकेशन के लिए कोई प्रोजेक्ट बनाने या चुनने और एपीआई चालू करने के लिए, एपीआई दस्तावेज़ में दिए गए निर्देशों का पालन करें.
2. यह तरीका जिस तरह के डेटा को ऐक्सेस कर रहा है उसके आधार पर, एपीआई कुंजी (सार्वजनिक डेटा) बनाएं या OAuth 2.0 क्लाइंट आईडी (निजी डेटा) बनाएं.
3. ऐप्लिकेशन टाइप को डेस्कटॉप ऐप्लिकेशन पर सेट करें.
4. अगर आपने OAuth 2.0 क्लाइंट आईडी बनाया है, तो OAuth 2.0 क्रेडेंशियल वाली JSON फ़ाइल डाउनलोड करें. इस फ़ाइल का नाम client_secret_CLIENTID.json जैसा होता है. इसमें CLIENTID आपके प्रोजेक्ट का क्लाइंट आईडी होता है.
5. कोड के सैंपल को किसी लोकल फ़ाइल में कॉपी करें. इसके बाद, सैंपल में बदलाव करके अपनी एपीआई पासकोड या क्लाइंट सीक्रेट फ़ाइल की सही पहचान करें. इस सैंपल में, एपीआई पासकोड की वैल्यू YOUR_API_KEY है और क्लाइंट सीक्रेट फ़ाइल की जगह YOUR_CLIENT_SECRET_FILE.json है.

कोड का सैंपल लागू करना

उदाहरण को चलाने के लिए, इस कमांड का इस्तेमाल करें:

  python sample.py

ज़्यादातर सैंपल, एपीआई से मिले रिस्पॉन्स (या कुछ और) को STDOUT में प्रिंट करते हैं.

Ruby

ज़रूरी शर्तें

• Ruby 2.0 या इसके बाद का वर्शन

• Ruby के लिए Google APIs क्लाइंट लाइब्रेरी:

  gem install google-api-client`
  

सेट अप करें

1. अपने ऐप्लिकेशन के लिए कोई प्रोजेक्ट बनाने या चुनने और एपीआई चालू करने के लिए, एपीआई दस्तावेज़ में दिए गए निर्देशों का पालन करें.
2. यह तरीका जिस तरह के डेटा को ऐक्सेस कर रहा है उसके आधार पर, एपीआई कुंजी (सार्वजनिक डेटा) बनाएं या OAuth 2.0 क्लाइंट आईडी (निजी डेटा) बनाएं.
3. ऐप्लिकेशन टाइप को डेस्कटॉप ऐप्लिकेशन पर सेट करें.
4. अगर आपने OAuth 2.0 क्लाइंट आईडी बनाया है, तो OAuth 2.0 क्रेडेंशियल वाली JSON फ़ाइल डाउनलोड करें. इस फ़ाइल का नाम client_secret_CLIENTID.json जैसा होता है. इसमें CLIENTID आपके प्रोजेक्ट का क्लाइंट आईडी होता है.
5. कोड के सैंपल को किसी लोकल फ़ाइल में कॉपी करें. इसके बाद, सैंपल में बदलाव करके अपनी एपीआई पासकोड या क्लाइंट सीक्रेट फ़ाइल की सही पहचान करें. इस सैंपल में, एपीआई पासकोड की वैल्यू YOUR_API_KEY है और क्लाइंट सीक्रेट फ़ाइल की जगह YOUR_CLIENT_SECRET_FILE.json है.

कोड का सैंपल लागू करना

उदाहरण को चलाने के लिए, इस कमांड का इस्तेमाल करें:

  ruby sample.rb

ज़्यादातर सैंपल, एपीआई से मिले रिस्पॉन्स (या कुछ और) को STDOUT में प्रिंट करते हैं.