বাহ্যিক API

Google Apps Script সমগ্র ওয়েব থেকে API-এর সাথে ইন্টারঅ্যাক্ট করতে পারে। এই নির্দেশিকাটি দেখায় কিভাবে আপনার স্ক্রিপ্টে বিভিন্ন ধরনের API-এর সাথে কাজ করতে হয়।

সর্বজনীন API-এর সাথে সংযোগ করুন

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

নিম্নলিখিত উদাহরণটি "অ্যাপস স্ক্রিপ্ট" উল্লেখ করে 100 বা তার বেশি স্টার সহ সংগ্রহস্থলগুলি অনুসন্ধান করতে 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 একটি অনুরোধের জন্য একটি কাঁচা 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.