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