Google Slaytlar API'si sunu dosyaları oluşturmanıza ve mevcut dosyaları yönetmenize olanak tanır.
Bu sayfadaki örnekler, presentations.batchUpdate yöntemini kullanan bazı yaygın sayfa sunma işlemlerini göstermektedir.
Bu örnekler, dilden bağımsız olmaları için HTTP istekleri olarak sunulur. Toplu güncellemenin Google API istemci kitaplıklarını kullanarak farklı dillerde nasıl uygulanacağını öğrenmek için aşağıdaki kılavuzlara bakın:
Sunu oluşturma
Aşağıdaki presentations.create kod örneğinde "Yeni Sunum" adlı boş bir sunu dosyasının nasıl oluşturulacağı gösterilmektedir.
MIME türü olarak application/vnd.google-apps.presentation belirterek Google Drive API files.create yöntemini kullanarak boş sunu dosyaları oluşturmak da mümkündür.
Aşağıda, sunum oluşturmak için gereken istek protokolü verilmiştir:
POST https://slides.googleapis.com/v1/presentations
{
"title": "My New Presentation"
}
Mevcut sunu dosyalarını listeleme
Slaytlar API, sunuların listesini almak için bir yöntem sağlamaz, ancak Drive API sağlar.
files.list yöntemi (aşağıda sunulmuştur); alan maskelerini kullanarak Drive'ınızdaki sunum dosyalarının listesini; dosya kimliği, dosya adı ve dosyayı açmak için kullanılacak bağlantıyla birlikte döndürür. İstek, MIME türü olarak application/vnd.google-apps.presentation değerini de belirtir.
Aşağıda, mevcut sunu dosyalarını listelemek için kullanılan istek protokolü bulunmaktadır:
GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)
Bu isteğin yanıtı aşağıdaki yapıya sahiptir:
{
"files": [
{
"id": "abcdefghijklmnopqrstuvwxyz0123456789",
"name": "Project Vision",
"webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk"
},
{
"id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
"name": "Untitled Presentation",
"webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk"
},
...
]
}
Sunu boyunca metin değiştirme
Aşağıdaki presentations.batchUpdate kod örneğinde, PRESENTATION_ID ile belirtilen sunum boyunca metni değiştirmek için ReplaceAllTextRequest yönteminin nasıl kullanılacağı gösterilmektedir. Sunu kimliği değerini sunu URL'sinden bulabilirsiniz.
"Gizmo Corp." dizesinin her örneğinin yerine "Gadget Inc." metni eklenir. Buna, metin kutularındaki ve diğer şekillerdeki, slaytlardaki ve ana öğeler içindeki metinler de dahildir. Bu örnekte, matchCase öğesi true değerine ayarlandığında metin değiştirme işlemi büyük/küçük harfe duyarlıdır.
Aşağıda, bir sunum boyunca metin değiştirmek için gereken istek protokolü verilmiştir:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"replaceAllText": {
"containsText": {
"text": "Gizmo Corp.",
"matchCase": true
},
"replaceText": "Gadget Inc."
}
}
]
}