বাহ্যিক API

Google Apps Script সমগ্র ওয়েবের 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 প্রবাহ সম্পাদন করতে এবং আপনার অনুরোধগুলির সাথে শংসাপত্রগুলি প্রেরণ করতে আপনি ওপেন সোর্স লাইব্রেরি ব্যবহার করতে পারেন:

একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করে প্রমাণীকরণ করুন

অ্যাপস স্ক্রিপ্ট থেকে একটি API কল করার জন্য, আপনি নিম্নলিখিত যেকোনো কারণে পরিষেবা অ্যাকাউন্ট প্রমাণীকরণ ব্যবহার করতে পারেন:

  • গুগল ক্লাউড এপিআই-এর সাথে আরও ভালো পারফরম্যান্স
  • অটোমেশন এবং দীর্ঘমেয়াদী কাজ
  • উন্নত নিরাপত্তা (সর্বনিম্ন সুবিধা)
  • কেন্দ্রীভূত প্রবেশাধিকার ব্যবস্থাপনা

অ্যাপস স্ক্রিপ্টে একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করতে, পরিষেবা অ্যাকাউন্ট ব্যবহার করে একটি অ্যাপস স্ক্রিপ্ট প্রকল্প হিসাবে প্রমাণীকরণ দেখুন।

গুগল ক্লাউড পরিষেবার সাথে সংযোগ করুন

কার্যকর ব্যবহারকারীর জন্য একটি OpenID Connect পরিচয় টোকেন (একটি JSON ওয়েব টোকেন বা JWT) পেতে আপনি ScriptApp.getIdentityToken() পদ্ধতি ব্যবহার করতে পারেন। আপনি এই টোকেনটি Google ক্লাউড পরিষেবাগুলির সাথে প্রমাণীকরণের জন্য ব্যবহার করতে পারেন, যেমন Cloud Run, যা এটি গ্রহণ করার জন্য কনফিগার করা আছে।

আরও তথ্যের জন্য, Google ক্লাউড পরিষেবাগুলিতে সংযোগ করুন দেখুন।

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

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

যখন একটি API একটি raw JSON প্রতিক্রিয়া ফেরত দেয়, তখন HTTPResponse.getContentText পদ্ধতি ব্যবহার করে JSON স্ট্রিং প্রতিক্রিয়া অ্যাক্সেস করুন। স্ট্রিংটি পুনরুদ্ধার করার পরে, এটিকে একটি JavaScript অবজেক্টে পার্স করতে 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 স্ট্রিংয়ে রূপান্তর করতে, 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 অনুরোধ করার সময়, পাঠানোর জন্য XML তৈরি করতে XmlService পদ্ধতি ব্যবহার করুন।

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.