বাহ্যিক API

গুগল অ্যাপস স্ক্রিপ্ট সমগ্র ওয়েবের API গুলির সাথে ইন্টারঅ্যাক্ট করতে পারে। এই নির্দেশিকাটি আপনার স্ক্রিপ্টগুলিতে বিভিন্ন ধরণের API গুলির সাথে কীভাবে কাজ করবেন তা দেখায়।

পাবলিক API গুলিতে সংযোগ করুন

আপনি সরাসরি API অনুরোধ করতে UrlFetch পরিষেবা ব্যবহার করতে পারেন।

নিচের উদাহরণে "Apps Script" উল্লেখ করে ১০০ বা তার বেশি স্টার সহ রিপোজিটরি অনুসন্ধান করার জন্য GitHub API ব্যবহার করা হয়েছে। এই API অনুরোধের জন্য অনুমোদন বা API কী প্রয়োজন হয় না।

var query = '"Apps Script" stars:">=100"';
var url = 'https://api.github.com/search/repositories'
  + '?sort=stars'
  + '&q=' + encodeURIComponent(query);

var response = UrlFetchApp.fetch(url, {'muteHttpExceptions': true});
Logger.log(response);

OAuth ব্যবহার করে পরিষেবাগুলিতে অনুরোধ করুন

ব্যবহারকারীর পক্ষে কাজ করে এমন API গুলির জন্য সাধারণত অনুমোদনের প্রয়োজন হয়, প্রায়শই OAuth প্রোটোকল ব্যবহার করে। অ্যাপস স্ক্রিপ্ট প্রোটোকলের জন্য অন্তর্নির্মিত সমর্থন প্রদান করে না, তবে OAuth প্রবাহ সম্পাদন করতে এবং আপনার অনুরোধগুলির সাথে শংসাপত্রগুলি প্রেরণ করতে আপনি ওপেন সোর্স লাইব্রেরি ব্যবহার করতে পারেন:

JSON এর সাথে কাজ করুন

JSON অবজেক্টের সাথে কাজ করা XML এর সাথে কাজ করার মতোই, তবে JSON অবজেক্ট পার্সিং বা এনকোডিং করা অনেক সহজ।

যদি অনুরোধ করা API কোনও অনুরোধের জন্য একটি raw JSON প্রতিক্রিয়া প্রদান করে, তাহলে JSON স্ট্রিং প্রতিক্রিয়া HTTPResponse.getContentText() পদ্ধতি ব্যবহার করে অ্যাক্সেস করা যেতে পারে। এই স্ট্রিংটি পুনরুদ্ধার করা হয়ে গেলে, একটি নেটিভ অবজেক্ট উপস্থাপনা পেতে কেবল স্ট্রিংটিতে JSON.parse() কল করুন।

// Make request to API and get response before this point.
var json = response.getContentText();
var data = JSON.parse(json);
Logger.log(data.title);

একইভাবে, একটি অনুরোধ করার জন্য একটি জাভাস্ক্রিপ্ট অবজেক্টের স্ট্রিং উপস্থাপনা তৈরি করতে, JSON.stringify() ব্যবহার করুন।

var data = {
  'entry': {
    'group': {
      'title': 'Dog Skateboarding',
      'description': 'My dog gets some serious air'
    },
    'keywords': 'dog, skateboard'
  }
}
var payload = JSON.stringify(data);
// Make request to API with payload after this point.

XML পার্স করুন

যদি কোনও বহিরাগত API কোনও অনুরোধের জন্য একটি কাঁচা XML প্রতিক্রিয়া প্রদান করে, তাহলে আপনি HTTPResponse.getContentText() পদ্ধতি ব্যবহার করে XML প্রতিক্রিয়া অ্যাক্সেস করতে পারেন।

// Make request to API and get response before this point.
var xml = response.getContentText();
var doc = XmlService.parse(xml);

কোনও API-তে XML অনুরোধ করার সময়, XmlService পদ্ধতি ব্যবহার করে পাঠানোর জন্য XML তৈরি করুন।

var root = XmlService.createElement('entry')
    .setAttribute('keywords', 'dog, skateboard');
var group = XmlService.createElement('group')
    .setAttribute('title', 'Dog Skateboarding');
    .setAttribute('description', 'My dog gets some serious air');
root.addContent(group);
var document = XmlService.createDocument(root);
var payload = XmlService.getPrettyFormat().format(document);
// Make request to API with payload after this point.