Class PictureFill

صورةتعبئة

تعبئة تعرِض صورة تم تمديدها إلى أبعاد حاويتها

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getAs(contentType)Blobعرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد
getBlob()Blobعرض البيانات داخل هذا الكائن ككتلة بيانات
getContentUrl()Stringالحصول على عنوان URL للصورة
getSourceUrl()Stringتحصل على عنوان URL لمصدر الصورة، إذا كان متاحًا.

مستندات تفصيلية

getAs(contentType)

عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد تُضيف هذه الطريقة امتداد اسم الملف المناسب، على سبيل المثال "myfile.pdf". ومع ذلك، فإنه يفترض أنّ جزء اسم الملف الذي يلي النقطة الأخيرة (إن وُجد) هو امتداد حالي يجب استبداله. ونتيجةً لذلك، يصبح ملف ShoppingList.12.25.2014 هو ShoppingList.12.25.pdf.

للاطّلاع على الحصص اليومية للإحالات الناجحة، يُرجى الاطّلاع على الحصص لخدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا مؤقتًا لحدود برمجية أكثر صرامة.

المعلَمات

الاسمالنوعالوصف
contentTypeStringنوع MIME المطلوب التحويل إليه بالنسبة إلى معظم العناصر المصغّرة، يكون 'application/pdf' هو الخيار الوحيد الصالح. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يمكن استخدام أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' أيضًا. بالنسبة إلى مستند "مستندات Google"، يكون 'text/markdown' صالحًا أيضًا.

الإرجاع

Blob: البيانات بتنسيق ملف نصي


getBlob()

عرض البيانات داخل هذا الكائن ككتلة بيانات

الإرجاع

Blob: البيانات بتنسيق ملف نصي


getContentUrl()

الحصول على عنوان URL للصورة

يتم وضع علامة على عنوان URL هذا بالحساب الذي يخصّ مقدّم الطلب، وبالتالي يمكن لأي مستخدم لديه عنوان URL الوصول إلى الصورة بصفتها مقدّم الطلب الأصلي. قد لا تتمكّن من الوصول إلى الصورة في حال تغيّر إعدادات مشاركة الجدول الزمني. تنتهي صلاحية عنوان URL بعد فترة قصيرة.

الإرجاع

String

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSourceUrl()

تحصل على عنوان URL لمصدر الصورة، إذا كان متاحًا.

عند إدراج صورة باستخدام عنوان URL، يتم عرض عنوان URL الذي تم تقديمه أثناء إدراج الصورة.

الإرجاع

String: عنوان URL للصورة أو null إذا لم تكن الصورة تتضمّن عنوان URL للمصدر

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations