URL Fetch Service

جلب عنوان URL

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

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

سلسلة وكيل المستخدم التلقائية لطلبات خدمة UrlFetch هي Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID).

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

انظر أيضًا

• HTTPResponse
• ضبط نطاقات صريحة

صفوف

الاسم	وصف قصير
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	تعرِض هذه السمة الطلب الذي تم تقديمه في حال تمّ استدعاء العملية.