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. في معظم الحالات، ترصد برمجة تطبيقات تلقائيًا النطاقات التي يحتاجها النص البرمجي وتضمّنها، ولكن إذا كنت تضبط نطاقاتك بشكل صريح، عليك إضافة هذا النطاق يدويًا لاستخدام 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 في حال OK، وما إلى ذلك) لاستجابة HTTP

UrlFetchApp

الطُرق

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