الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
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. |
الوثائق التفصيلية
getAllHeaders()
تعرض خريطة السمات/القيم للعناوين لاستجابة HTTP، مع العناوين التي تتضمّن قيمًا متعددة يتم عرضها على شكل مصفوفات.
// The code below logs the HTTP headers from the response // received when fetching the Google home page. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getAllHeaders());
استرجاع الكرة
Object
: مفتاح/خريطة قيم JavaScript لعناوين HTTP
getAs(contentType)
عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير يتم تحويله إلى نوع المحتوى المحدّد. تضيف هذه الطريقة الامتداد المناسب إلى اسم الملف - على سبيل المثال، "myfile.pdf". ومع ذلك، يُفترض أن يمثّل جزء اسم الملف الذي يلي النقطة الأخيرة (إن وُجدت) إضافة حالية يجب استبدالها. وبالتالي، يصبح "ShoppingList.12.25.2014" هو "ShoppingList.12.25.pdf".
لعرض الحصص اليومية للإحالات الناجحة، راجِع حصص خدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا لحصص أكثر صرامة مؤقتًا.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
contentType | String | نوع MIME المطلوب التحويل إليه. بالنسبة إلى معظم الكائنات الثنائية الكبيرة، يكون 'application/pdf' هو الخيار الصالح الوحيد. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يكون أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' صالحًا أيضًا. |
استرجاع الكرة
Blob
— البيانات في صورة كائن ثنائي كبير (blob).
getBlob()
عرض البيانات داخل هذا الكائن على هيئة كائن ثنائي كبير (blob).
استرجاع الكرة
Blob
— البيانات في صورة كائن ثنائي كبير (blob).
getContent()
الحصول على المحتوى الثنائي الأولي لاستجابة HTTP.
// The code below logs the value of the first byte of the Google home page. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getContent()[0]);
استرجاع الكرة
Byte[]
- المحتوى كصفيف ثنائي أولي
getContentText()
للحصول على محتوى استجابة HTTP مرمّزة كسلسلة.
// The code below logs the HTML code of the Google home page. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getContentText());
استرجاع الكرة
String
- محتوى استجابة HTTP، كسلسلة
getContentText(charset)
لعرض محتوى استجابة HTTP تم ترميزها كسلسلة من مجموعة الأحرف المحددة.
// The code below logs the HTML code of the Google home page with the UTF-8 charset. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getContentText("UTF-8"));
المَعلمات
الاسم | Type | الوصف |
---|---|---|
charset | String | سلسلة تمثل مجموعة الأحرف التي سيتم استخدامها لترميز محتوى استجابة HTTP |
استرجاع الكرة
String
: محتوى استجابة HTTP، مع الترميز باستخدام مجموعة الأحرف المحدّدة
getHeaders()
لعرض تعيين السمة/القيمة للرؤوس لاستجابة HTTP.
// The code below logs the HTTP headers from the response // received when fetching the Google home page. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getHeaders());
استرجاع الكرة
Object
: مفتاح/خريطة قيم JavaScript لعناوين HTTP
getResponseCode()
احصل على رمز حالة HTTP (200 لـ OK، وما إلى ذلك) لاستجابة HTTP.
// The code below logs the HTTP status code from the response received // when fetching the Google home page. // It should be 200 if the request succeeded. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getResponseCode());
استرجاع الكرة
Integer
: رمز استجابة HTTP (مثل 200 لـ OK)