Class UrlFetchApp

UrlFetchApp

সম্পদ আনুন এবং ইন্টারনেটের মাধ্যমে অন্যান্য হোস্টদের সাথে যোগাযোগ করুন।

এই পরিষেবাটি স্ক্রিপ্টগুলিকে অন্য অ্যাপ্লিকেশনগুলির সাথে যোগাযোগ করতে বা URL গুলি নিয়ে ওয়েবে অন্যান্য সংস্থানগুলি অ্যাক্সেস করার অনুমতি দেয়৷ একটি স্ক্রিপ্ট HTTP এবং HTTPS অনুরোধ ইস্যু করতে এবং প্রতিক্রিয়া পেতে URL আনয়ন পরিষেবা ব্যবহার করতে পারে। URL আনয়ন পরিষেবাটি দক্ষতা এবং স্কেলিং উদ্দেশ্যে Google এর নেটওয়ার্ক অবকাঠামো ব্যবহার করে৷

এই পরিষেবা ব্যবহার করে করা অনুরোধগুলি আইপি রেঞ্জের একটি সেট পুল থেকে উদ্ভূত হয়। আপনি যদি এই অনুরোধগুলিকে অনুমতি দিতে বা অনুমোদন করতে চান তবে আপনি IP ঠিকানাগুলির সম্পূর্ণ তালিকা দেখতে পারেন।

এই পরিষেবাটির জন্য https://www.googleapis.com/auth/script.external_request সুযোগ প্রয়োজন৷ বেশিরভাগ ক্ষেত্রে Apps স্ক্রিপ্ট স্বয়ংক্রিয়ভাবে সনাক্ত করে এবং একটি স্ক্রিপ্টের প্রয়োজনীয় স্কোপগুলি অন্তর্ভুক্ত করে, তবে আপনি যদি আপনার স্কোপগুলি স্পষ্টভাবে সেট করে থাকেন তবে UrlFetchApp ব্যবহার করার জন্য আপনাকে অবশ্যই এই সুযোগটি ম্যানুয়ালি যোগ করতে হবে।

এছাড়াও দেখুন

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
fetch(url) HTTPResponse একটি URL আনার জন্য একটি অনুরোধ করে৷
fetch(url, params) HTTPResponse ঐচ্ছিক উন্নত পরামিতি ব্যবহার করে একটি URL আনার অনুরোধ করে।
fetchAll(requests) HTTPResponse[] ঐচ্ছিক উন্নত প্যারামিটার ব্যবহার করে একাধিক URL আনার জন্য একাধিক অনুরোধ করে।
getRequest(url) Object অপারেশন চালু করা হলে যে অনুরোধ করা হয় তা ফেরত দেয়।
getRequest(url, params) Object ক্রিয়াকলাপটি চালু করা হলে যে অনুরোধ করা হয় তা ফেরত দেয়।

বিস্তারিত ডকুমেন্টেশন

fetch(url)

একটি URL আনার জন্য একটি অনুরোধ করে৷

এটি HTTP এর পাশাপাশি HTTPS-এ কাজ করে। 

// The code below logs the HTML code of the Google home page.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getContentText());

পরামিতি

নাম টাইপ বর্ণনা
url String আনার জন্য URL। ইউআরএলে 2,082টি অক্ষর থাকতে পারে।

প্রত্যাবর্তন

HTTPResponse — HTTP প্রতিক্রিয়া ডেটা।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/script.external_request

fetch(url, params)

ঐচ্ছিক উন্নত পরামিতি ব্যবহার করে একটি URL আনার অনুরোধ করে।

এটি HTTP এর পাশাপাশি HTTPS-এ কাজ করে। 

// Make a GET request and log the returned content.
var response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getContentText());
// Make a POST request with form data.
var resumeBlob = Utilities.newBlob('Hire me!', 'text/plain', 'resume.txt');
var formData = {
  'name': 'Bob Smith',
  'email': 'bob@example.com',
  'resume': resumeBlob
};
// Because payload is a JavaScript object, it is interpreted as
// as form data. (No need to specify contentType; it automatically
// defaults to either 'application/x-www-form-urlencoded'
// or 'multipart/form-data')
var options = {
  'method' : 'post',
  'payload' : formData
};
UrlFetchApp.fetch('https://httpbin.org/post', options);
// Make a POST request with a JSON payload.
var data = {
  'name': 'Bob Smith',
  'age': 35,
  'pets': ['fido', 'fluffy']
};
var options = {
  'method' : 'post',
  'contentType': 'application/json',
  // Convert the JavaScript object to a JSON string.
  'payload' : JSON.stringify(data)
};
UrlFetchApp.fetch('https://httpbin.org/post', options);

পরামিতি

নাম টাইপ বর্ণনা
url String আনার জন্য URL। ইউআরএলে 2,082টি অক্ষর থাকতে পারে।
params Object ঐচ্ছিক জাভাস্ক্রিপ্ট অবজেক্টটি নিম্নে সংজ্ঞায়িত হিসাবে উন্নত প্যারামিটার নির্দিষ্ট করে।

উন্নত পরামিতি

নাম টাইপ বর্ণনা
contentType String বিষয়বস্তুর প্রকার (ডিফল্ট 'application/x-www-form-urlencoded')। কন্টেন্ট টাইপের আরেকটি উদাহরণ হল 'application/xml; charset=utf-8'।
headers Object অনুরোধের জন্য HTTP হেডারগুলির একটি জাভাস্ক্রিপ্ট কী/মান মানচিত্র
method String অনুরোধের জন্য HTTP পদ্ধতি: get , delete , patch , post , or put . ডিফল্ট get ।
payload String অনুরোধের জন্য পেলোড (অর্থাৎ, POST বডি)। কিছু HTTP পদ্ধতি (উদাহরণস্বরূপ, GET) একটি পেলোড গ্রহণ করে না। এটি একটি স্ট্রিং, একটি বাইট অ্যারে, একটি ব্লব বা একটি জাভাস্ক্রিপ্ট অবজেক্ট হতে পারে। একটি জাভাস্ক্রিপ্ট অবজেক্টকে মানের ক্ষেত্রে ফর্ম ফিল্ড নামের মানচিত্র হিসাবে ব্যাখ্যা করা হয়, যেখানে মানগুলি হয় স্ট্রিং বা ব্লব হতে পারে।
useIntranet Boolean অবচয়। এটি (বঞ্চিত) SDC এর মাধ্যমে আপনার ডোমেনের সাথে লিঙ্ক করা ইন্ট্রানেটের মধ্যে নির্দিষ্ট URL-এর সমাধান করার জন্য আনয়নের নির্দেশ দেয়
validateHttpsCertificates Boolean false হলে HTTPS অনুরোধের জন্য আনয়ন কোনো অবৈধ শংসাপত্র উপেক্ষা করে। ডিফল্ট true ।
followRedirects Boolean false হলে স্বয়ংক্রিয়ভাবে HTTP পুনঃনির্দেশ অনুসরণ করে না; এটি মূল HTTP প্রতিক্রিয়া প্রদান করে। ডিফল্ট true ।
muteHttpExceptions Boolean যদি true তবে প্রতিক্রিয়া কোডটি ব্যর্থতার ইঙ্গিত করলে ফেচ একটি ব্যতিক্রম নিক্ষেপ করে না এবং পরিবর্তে HTTPResponse প্রদান করে। ডিফল্ট false .
escaping Boolean যদি URL-এ false সংরক্ষিত অক্ষরগুলি এড়িয়ে না যায়। ডিফল্ট true ।

প্রত্যাবর্তন

HTTPResponse — HTTP প্রতিক্রিয়া ডেটা।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/script.external_request

fetchAll(requests)

ঐচ্ছিক উন্নত প্যারামিটার ব্যবহার করে একাধিক URL আনার জন্য একাধিক অনুরোধ করে।

এটি HTTP এর পাশাপাশি HTTPS-এ কাজ করে। 

// Make both a POST request with form data, and a GET request.
var resumeBlob = Utilities.newBlob('Hire me!', 'text/plain', 'resume.txt');
var formData = {
  'name': 'Bob Smith',
  'email': 'bob@example.com',
  'resume': resumeBlob
};
// Because payload is a JavaScript object, it is interpreted as
// as form data. (No need to specify contentType; it defaults to either
// 'application/x-www-form-urlencoded' or 'multipart/form-data')
var request1 = {
  'url': 'https://httpbin.org/post',
  'method' : 'post',
  'payload' : formData
};
// A request may also just be a URL.
var request2 = 'https://httpbin.org/get?key=value';
UrlFetchApp.fetchAll([request1, request2]);

পরামিতি

নাম টাইপ বর্ণনা
requests Object[] URL বা JavaScript অবজেক্টের একটি বিন্যাস যা নীচে সংজ্ঞায়িত করা অনুরোধগুলিকে নির্দিষ্ট করে৷

উন্নত পরামিতি

নাম টাইপ বর্ণনা
url String আনার জন্য URL। ইউআরএলে 2,082টি অক্ষর থাকতে পারে।
contentType String বিষয়বস্তুর প্রকার (ডিফল্ট 'application/x-www-form-urlencoded')। কন্টেন্ট টাইপের আরেকটি উদাহরণ হল 'application/xml; charset=utf-8'।
headers Object অনুরোধের জন্য HTTP হেডারগুলির একটি জাভাস্ক্রিপ্ট কী/মান মানচিত্র
method String অনুরোধের জন্য HTTP পদ্ধতি: get , delete , patch , post , or put . ডিফল্ট get ।
payload String অনুরোধের জন্য পেলোড (অর্থাৎ, POST বডি)। কিছু HTTP পদ্ধতি (উদাহরণস্বরূপ, GET) একটি পেলোড গ্রহণ করে না। এটি একটি স্ট্রিং, একটি বাইট অ্যারে, একটি ব্লব বা একটি জাভাস্ক্রিপ্ট অবজেক্ট হতে পারে। একটি জাভাস্ক্রিপ্ট অবজেক্টকে মানের ক্ষেত্রে ফর্ম ফিল্ড নামের মানচিত্র হিসাবে ব্যাখ্যা করা হয়, যেখানে মানগুলি হয় স্ট্রিং বা ব্লব হতে পারে।
useIntranet Boolean অবচয়। এটি (বঞ্চিত) SDC এর মাধ্যমে আপনার ডোমেনের সাথে লিঙ্ক করা ইন্ট্রানেটের মধ্যে নির্দিষ্ট URL-এর সমাধান করার জন্য আনয়নের নির্দেশ দেয়
validateHttpsCertificates Boolean false হলে HTTPS অনুরোধের জন্য আনয়ন কোনো অবৈধ শংসাপত্র উপেক্ষা করে। ডিফল্ট true ।
followRedirects Boolean false হলে স্বয়ংক্রিয়ভাবে HTTP পুনঃনির্দেশ অনুসরণ করে না; এটি মূল HTTP প্রতিক্রিয়া প্রদান করে। ডিফল্ট true ।
muteHttpExceptions Boolean true হলে, প্রতিক্রিয়া কোডটি ব্যর্থতার ইঙ্গিত করলে ফেচ একটি ব্যতিক্রম থ্রো করে না এবং পরিবর্তে HTTPResponse প্রদান করে। ডিফল্ট false .
escaping Boolean false হলে, ইউআরএলে সংরক্ষিত অক্ষরগুলি এড়িয়ে যাবে না। ডিফল্ট true ।

প্রত্যাবর্তন

HTTPResponse[] — প্রতিটি ইনপুট অনুরোধ থেকে HTTP প্রতিক্রিয়া ডেটার একটি অ্যারে।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/script.external_request

getRequest(url)

অপারেশন চালু করা হলে যে অনুরোধ করা হয় তা ফেরত দেয়।

এই পদ্ধতিটি আসলে অনুরোধ জারি করে না। 

// The code below logs the value for every key of the returned map.
var response = UrlFetchApp.getRequest("http://www.google.com/");
for(i in response) {
  Logger.log(i + ": " + response[i]);
}

পরামিতি

নাম টাইপ বর্ণনা
url String দেখতে URL. ইউআরএলে 2,082টি অক্ষর থাকতে পারে।

প্রত্যাবর্তন

Object — মান থেকে ক্ষেত্রের নামের একটি মানচিত্র। মানচিত্রে কমপক্ষে নিম্নলিখিত কী রয়েছে: url , method , contentType , payload , এবং headers .

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/script.external_request

getRequest(url, params)

ক্রিয়াকলাপটি চালু করা হলে যে অনুরোধ করা হয় তা ফেরত দেয়।

এই পদ্ধতিটি আসলে অনুরোধ জারি করে না।

পরামিতি

নাম টাইপ বর্ণনা
url String দেখতে URL. ইউআরএলে 2,082টি অক্ষর থাকতে পারে।
params Object একটি ঐচ্ছিক জাভাস্ক্রিপ্ট অবজেক্ট যা নিম্নে সংজ্ঞায়িত উন্নত পরামিতিগুলি নির্দিষ্ট করে৷

উন্নত পরামিতি

নাম টাইপ বর্ণনা
contentType String বিষয়বস্তুর প্রকার (ডিফল্ট 'application/x-www-form-urlencoded')। কন্টেন্ট টাইপের আরেকটি উদাহরণ হল 'application/xml; charset=utf-8'।
headers Object অনুরোধের জন্য HTTP হেডারগুলির একটি জাভাস্ক্রিপ্ট কী/মান মানচিত্র
method String অনুরোধের জন্য HTTP পদ্ধতি: get , delete , patch , post , or put . ডিফল্ট get ।
payload String অনুরোধের জন্য পেলোড (অর্থাৎ, POST বডি)। কিছু HTTP পদ্ধতি (উদাহরণস্বরূপ, GET) একটি পেলোড গ্রহণ করে না। এটি একটি স্ট্রিং, একটি বাইট অ্যারে, একটি ব্লব বা একটি জাভাস্ক্রিপ্ট অবজেক্ট হতে পারে। একটি জাভাস্ক্রিপ্ট অবজেক্টকে মানের ক্ষেত্রে ফর্ম ফিল্ড নামের মানচিত্র হিসাবে ব্যাখ্যা করা হয়, যেখানে মানগুলি হয় স্ট্রিং বা ব্লব হতে পারে।
useIntranet Boolean অবচয়। এটি (বঞ্চিত) SDC এর মাধ্যমে আপনার ডোমেনের সাথে লিঙ্ক করা ইন্ট্রানেটের মধ্যে নির্দিষ্ট URL-এর সমাধান করার জন্য আনয়নের নির্দেশ দেয়
validateHttpsCertificates Boolean false হলে HTTPS অনুরোধের জন্য আনয়ন কোনো অবৈধ শংসাপত্র উপেক্ষা করে। ডিফল্ট true ।
followRedirects Boolean false হলে স্বয়ংক্রিয়ভাবে HTTP পুনঃনির্দেশ অনুসরণ করে না; এটি মূল HTTP প্রতিক্রিয়া প্রদান করে। ডিফল্ট true ।
muteHttpExceptions Boolean যদি true তবে প্রতিক্রিয়া কোডটি ব্যর্থতার ইঙ্গিত করলে ফেচ একটি ব্যতিক্রম নিক্ষেপ করে না এবং পরিবর্তে HTTPResponse প্রদান করে। ডিফল্ট false .
escaping Boolean যদি URL-এ false সংরক্ষিত অক্ষরগুলি এড়িয়ে যাওয়া না হয়। ডিফল্ট true ।

প্রত্যাবর্তন

Object — মান থেকে ক্ষেত্রের নামের একটি মানচিত্র। মানচিত্রে কমপক্ষে নিম্নলিখিত কী রয়েছে: url , method , contentType , payload , এবং headers .

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/script.external_request