URL Fetch Service

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
جلب عنوان URL

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

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

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

راجع أيضًا

صفوف

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

HTTPResponse

الطُرق

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

UrlFetchApp

الطُرق

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