تسمح هذه الخدمة للنصوص البرمجية بالوصول إلى موارد أخرى على الويب من خلال جلب عناوين URL. ويمكن للنص البرمجي استخدام خدمة UrlFetch لإصدار طلبات HTTP وHTTPS وتلقّي الردود. تستخدِم خدمة UrlFetch بنية شبكة Google الأساسية لأغراض الكفاءة والتوسّع.
تأتي الطلبات المقدَّمة باستخدام هذه الخدمة من مجموعة محدّدة من نطاقات عناوين IP. يمكنك الاطّلاع على القائمة الكاملة لعناوين IP إذا كنت بحاجة إلى إدراج هذه الطلبات في القائمة البيضاء أو الموافقة عليها.
تتطلّب هذه الخدمة نطاق https://www.googleapis.com/auth/script.external_request
. في معظم الحالات، ترصد Apps Script النطاقات التي يحتاجها النص البرمجي وتضمّنها تلقائيًا، ولكن
إذا كنت
تضبط نطاقاتك صراحةً،
عليك إضافة هذا النطاق يدويًا لاستخدام Url
.
انظر أيضًا
صفوف
الاسم | وصف قصير |
---|---|
HTTPResponse | تسمح هذه الفئة للمستخدمين بالوصول إلى معلومات محدّدة حول ردود HTTP. |
Url | جلب الموارد والتواصل مع المضيفين الآخرين عبر الإنترنت |
HTTPResponse
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
get | Object | تعرِض هذه الدالة خريطة سمة/قيمة لعناوين استجابة HTTP، مع عرض العناوين التي تحتوي على قيم متعددة في شكل صفائف. |
get | Blob | عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد |
get | Blob | عرض البيانات داخل هذا الكائن ككتلة بيانات |
get | Byte[] | تحصل على المحتوى الثنائي الأوّلي لاستجابة HTTP. |
get | String | تحصل على محتوى استجابة HTTP الذي تم ترميزه كسلسلة. |
get | String | لعرض محتوى استجابة HTTP بترميز سلسلة من ترميز مجموعة الأحرف المحدّدة. |
get | Object | عرض خريطة سمة/قيمة للعناوين الخاصة باستجابة HTTP |
get | Integer | الحصول على رمز حالة HTTP (200 للإشارة إلى أنّه بحالة جيدة وما إلى ذلك) لاستجابة HTTP |
Url Fetch App
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
fetch(url) | HTTPResponse | يُقدّم طلبًا لجلب عنوان URL. |
fetch(url, params) | HTTPResponse | يُقدّم طلبًا لجلب عنوان URL باستخدام مَعلمات متقدّمة اختيارية. |
fetch | HTTPResponse[] | يُجري طلبات متعددة لجلب عناوين URL متعددة باستخدام مَعلمات متقدمة اختيارية. |
get | Object | تعرِض هذه السمة الطلب الذي تم تقديمه في حال تمّ استدعاء العملية. |
get | Object | تعرِض هذه السمة الطلب الذي تم تقديمه في حال تمّ استدعاء العملية. |