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عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير يتم تحويله إلى نوع المحتوى المحدّد.
getBlob()Blobعرض البيانات داخل هذا الكائن على هيئة كائن ثنائي كبير (blob).
getContent()Byte[]الحصول على المحتوى الثنائي الأولي لاستجابة HTTP.
getContentText()Stringللحصول على محتوى استجابة HTTP مرمّزة كسلسلة.
getContentText(charset)Stringلعرض محتوى استجابة HTTP تم ترميزها كسلسلة من مجموعة الأحرف المحددة.
getHeaders()Objectلعرض تعيين السمة/القيمة للرؤوس لاستجابة HTTP.
getResponseCode()Integerاحصل على رمز حالة HTTP (200 لـ OK، وما إلى ذلك) لاستجابة HTTP.

UrlFetchApp

الطُرق

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