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

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. Cloud Console में, एक "वेब ऐप्लिकेशन&quot के लिए 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 या उसके बाद का वर्शन.
• 7 या उससे ज़्यादा Gradle.

सेट अप करें

1. अपने ऐप्लिकेशन के लिए प्रोजेक्ट बनाने या चुनने के लिए, एपीआई दस्तावेज़ में दिए गए निर्देशों का पालन करें.
2. तरीका, डेटा को ऐक्सेस करने के आधार पर एपीआई कुंजी (सार्वजनिक डेटा) बनाता है या OAuth 2.0 क्लाइंट आईडी (निजी डेटा) बनाता है.
3. ऐप्लिकेशन टाइप को डेस्कटॉप ऐप्लिकेशन पर सेट करें.
4. अगर आपने OAuth 2.0 क्लाइंट आईडी बनाया है, तो ऐसी JSON फ़ाइल डाउनलोड करें जिसमें आपके OAuth 2.0 क्रेडेंशियल शामिल हों. इस फ़ाइल का नाम 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'
   

जगह:

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

कोड का एक्ज़ीक्यूट करें

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

  gradle -q run

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

Node.js के लिए

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

• Node.js के लिए

• Node.js के लिए Google API क्लाइंट लाइब्रेरी:

  • अगर आपने पहले क्लाइंट लाइब्रेरी इंस्टॉल नहीं की है, तो निर्देश खोलें:

  npm install googleapis --save
  

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

  npm update googleapis --save
  

सेट अप करें

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

कोड का एक्ज़ीक्यूट करें

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

  node sample.js

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

PHP

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

• कमांड-लाइन इंटरफ़ेस (CLI) और JSON एक्सटेंशन के साथ PHP 5.4 या उसके बाद का वर्शन.
• Composer डिपेंडेंसी मैनेजमेंट टूल दुनिया भर में इंस्टॉल किया गया.

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

  • अगर आपने पहले क्लाइंट लाइब्रेरी इंस्टॉल नहीं की है, तो निर्देश खोलें:

    composer require google/apiclient:^2.0
    

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

    composer update google/apiclient --with-dependencies
    

कोड का एक्ज़ीक्यूट करें

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

  php sample.php

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

Python

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

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

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

  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 क्लाइंट आईडी बनाया है, तो ऐसी JSON फ़ाइल डाउनलोड करें जिसमें आपके OAuth 2.0 क्रेडेंशियल शामिल हों. इस फ़ाइल का नाम client_secret_CLIENTID.json से मिलता-जुलता है, जहां CLIENTID आपके प्रोजेक्ट का क्लाइंट आईडी है.
5. अपनी एपीआई कुंजी या क्लाइंट सीक्रेट फ़ाइल की सही से पहचान करने के लिए, कोड के सैंपल को किसी स्थानीय फ़ाइल में कॉपी करें और नमूने में बदलाव करें. नमूने में, एपीआई कुंजी की वैल्यू YOUR_API_KEY है और क्लाइंट सीक्रेट फ़ाइल की जगह YOUR_CLIENT_SECRET_FILE.json है.

कोड का एक्ज़ीक्यूट करें

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

  python sample.py

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

Ruby

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

• रूबी 2.0 या उसके बाद का वर्शन

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

  gem install google-api-client`
  

सेट अप करें

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

कोड का एक्ज़ीक्यूट करें

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

  ruby sample.rb

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