Method: presentations.pages.getThumbnail

Sunudaki belirtilen sayfanın en son sürümünün küçük resmini oluşturur ve küçük resim görüntüsünün URL'sini döndürür.

Bu istek, kota açısından pahalı bir okuma isteği olarak sayılır.

HTTP isteği

GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
presentationId

string

Alınacak sununun kimliği.

pageObjectId

string

Küçük resmi alınacak sayfanın nesne kimliği.

Sorgu parametreleri

Parametreler
thumbnailProperties

object (ThumbnailProperties)

Küçük resim özellikleri.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Sayfanın küçük resmi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "width": integer,
  "height": integer,
  "contentUrl": string
}
Alanlar
width

integer

Küçük resmin piksel cinsinden pozitif genişliği.

height

integer

Küçük resmin piksel cinsinden pozitif yüksekliği.

contentUrl

string

Küçük resmin içerik URL'si.

Resmin URL'sinin varsayılan geçerlilik süresi 30 dakikadır. Bu URL, istekte bulunan kullanıcının hesabıyla etiketlenir. URL'ye sahip herkes, resme orijinal talep sahibi olarak erişir. Sunumun paylaşım ayarları değişirse resme erişim kaybedilebilir. Küçük resim görüntüsünün MIME türü, GetPageThumbnailRequest içinde belirtilenle aynıdır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/presentations
  • https://www.googleapis.com/auth/presentations.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

ThumbnailProperties

Sayfa küçük resmi oluşturma üzerinde kontrol sağlar.

JSON gösterimi
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
Alanlar
mimeType

enum (MimeType)

Küçük resim görüntüsünün isteğe bağlı MIME türü.

MIME türünü belirtmezseniz varsayılan olarak PNG kullanılır.

thumbnailSize

enum (ThumbnailSize)

İsteğe bağlı küçük resim boyutu.

Boyutu belirtmezseniz sunucu, resmin varsayılan boyutunu seçer.

MimeType

Küçük resmin MIME türü.

Sıralamalar
PNG Varsayılan MIME türü.

ThumbnailSize

Önceden tanımlanmış küçük resim boyutları. Buradaki değerler, küçük resmin genişliğini açıklar. Sayfa yüksekliği genişlikten büyük olduğunda genişlik, belirtilen boyuttan daha küçük olabilir.

Sıralamalar
THUMBNAIL_SIZE_UNSPECIFIED

Varsayılan küçük resim boyutu.

Belirtilmeyen küçük resim boyutu, sunucunun resim boyutunu gelecekte değişebilecek bir şekilde seçtiği anlamına gelir.

LARGE Küçük resmin genişliği 1.600 piksel olmalıdır.
MEDIUM Küçük resmin genişliği 800 piksel olmalıdır.
SMALL Küçük resmin genişliği 200 piksel olmalıdır.