Sunu işlemleri

Google Slaytlar API, sunu dosyaları oluşturmanıza ve mevcut sunuları yönetmenize olanak tanır. Bu sayfada, presentations.batchUpdate yönteminin kullanıldığı bazı yaygın sayfa sunma işlemleri gösterilmektedir.

Bu örnekler, dil açısından tarafsız olması için HTTP istekleri olarak sunulur. Google API istemci kitaplıklarını kullanarak farklı dillerde toplu güncelleme uygulamayı öğrenmek için aşağıdaki kılavuzları inceleyin:

Sunu oluşturma

Aşağıdaki presentations.create kod örneğinde, "Yeni Sunumum" başlıklı 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ı da oluşturabilirsiniz.

Aşağıda, sunu oluşturma istek protokolü verilmiştir:

POST https://slides.googleapis.com/v1/presentations
{
  "title": "My New Presentation"
}

Mevcut sunu dosyalarını listeleme

Slaytlar API'sinde, sunumların listesini almak için bir yöntem yoktur ancak Drive API'de vardır. files.list yöntemi (aşağıda sunulmuştur), Drive'ınızdaki sunu dosyalarının dosya kimliği, dosya adı ve dosyayı açma bağlantısını içeren bir listesini döndürmek için alan maskelerini kullanır. İstek, MIME türü olarak application/vnd.google-apps.presentation değerini de belirtir.

Mevcut sunu dosyalarını listelemek için istek protokolü aşağıda verilmiştir:

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"
    },
    ...
  ]
}

Sunudaki metni değiştirme

Aşağıdaki presentations.batchUpdate kod örneğinde, PRESENTATION_ID tarafından belirtilen sunudaki metni değiştirmek için ReplaceAllTextRequest yönteminin nasıl kullanılacağı gösterilmektedir. Sunu kimliğinin değerini sunu URL'sinden öğrenebilirsiniz.

"Gizmo Corp." dizesinin her örneği "Gadget Inc." metniyle değiştirilir. Metin kutularındaki ve diğer şekillerdeki metinler, slaytlardaki metinler ve ana şablonlardaki metinler buna dahildir. Bu örnekte, matchCase yerine true yazılarak metin değişimi büyük/küçük harfe duyarlı hale getirilmiştir.

Aşağıda, bir sunudaki metni değiştirmek için kullanılan 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."
      }
    }
  ]
}