URL Fetch Service

جلب عنوان URL

تسمح هذه الخدمة للنصوص البرمجية بالوصول إلى موارد أخرى على الويب من خلال جلب عناوين URL. ويمكن للنص البرمجي استخدام خدمة UrlFetch لإصدار طلبات HTTP وHTTPS وتلقّي الردود. تستخدِم خدمة UrlFetch بنية شبكة Google الأساسية لأغراض الكفاءة والتوسّع.

تأتي الطلبات المقدَّمة باستخدام هذه الخدمة من مجموعة محدّدة من نطاقات عناوين IP. يمكنك الاطّلاع على القائمة الكاملة لعناوين IP إذا كنت بحاجة إلى إدراج هذه الطلبات في القائمة البيضاء أو الموافقة عليها.

تتطلّب هذه الخدمة نطاق https://www.googleapis.com/auth/script.external_request. في معظم الحالات، ترصد Apps Script النطاقات التي يحتاجها النص البرمجي وتضمّنها تلقائيًا، ولكن إذا كنت تضبط نطاقاتك صراحةً، عليك إضافة هذا النطاق يدويًا لاستخدام UrlFetchApp.

انظر أيضًا

صفوف

الاسموصف قصير
HTTPResponseتسمح هذه الفئة للمستخدمين بالوصول إلى معلومات محدّدة حول ردود HTTP.
UrlFetchAppجلب الموارد والتواصل مع المضيفين الآخرين عبر الإنترنت

HTTPResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getAllHeaders()Objectتعرِض هذه الدالة خريطة سمة/قيمة لعناوين استجابة HTTP، مع عرض العناوين التي تحتوي على قيم متعددة في شكل صفائف.
getAs(contentType)Blobعرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد
getBlob()Blobعرض البيانات داخل هذا الكائن ككتلة بيانات
getContent()Byte[]تحصل على المحتوى الثنائي الأوّلي لاستجابة HTTP.
getContentText()Stringتحصل على محتوى استجابة HTTP الذي تم ترميزه كسلسلة.
getContentText(charset)Stringلعرض محتوى استجابة HTTP بترميز سلسلة من ترميز مجموعة الأحرف المحدّدة.
getHeaders()Objectعرض خريطة سمة/قيمة للعناوين الخاصة باستجابة HTTP
getResponseCode()Integerالحصول على رمز حالة HTTP (200 للإشارة إلى أنّه بحالة جيدة وما إلى ذلك) لاستجابة HTTP

UrlFetchApp

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
fetch(url)HTTPResponseيُقدّم طلبًا لجلب عنوان URL.
fetch(url, params)HTTPResponseيُقدّم طلبًا لجلب عنوان URL باستخدام مَعلمات متقدّمة اختيارية.
fetchAll(requests)HTTPResponse[]يُجري طلبات متعددة لجلب عناوين URL متعددة باستخدام مَعلمات متقدمة اختيارية.
getRequest(url)Objectتعرِض هذه السمة الطلب الذي تم تقديمه في حال تمّ استدعاء العملية.
getRequest(url, params)Objectتعرِض هذه السمة الطلب الذي تم تقديمه في حال تمّ استدعاء العملية.