تسمح هذه الخدمة للنصوص البرمجية بالوصول إلى الموارد الأخرى على الويب من خلال جلب عناوين 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 | تعرض الطلب الذي يتم إجراؤه في حال استدعاء العملية. |