Sunu işlemleri

Google Slaytlar API'si, sunu dosyaları oluşturmanıza ve mevcut dosyaları yönetmenize olanak tanır. Bu sayfadaki örneklerde, presentations.batchUpdate yöntemi kullanılarak yapılan bazı yaygın sayfa sunumu işlemleri gösterilmektedir.

Bu örnekler, dilden bağımsız olması için HTTP istekleri olarak sunulur. Google API istemci kitaplıklarını kullanarak farklı dillerde toplu güncelleme işlemini nasıl uygulayacağınızı öğ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.

Google Drive API'nin files.create yöntemini kullanarak boş sunu dosyaları da oluşturabilirsiniz. Bunun için application/vnd.google-apps.presentation değerini MIME türü olarak belirtmeniz gerekir.

Sunu oluşturmak için kullanılan istek protokolü aşağıda verilmiştir:

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

Mevcut sunu dosyalarını listeleme

Slides API, sunu listesini almak için bir yöntem sağlamaz ancak Drive API sağlar. Aşağıda sunulan files.list yöntemi, Drive'ınızdaki sunu dosyalarının listesini döndürmek için alan maskelerini kullanır. Bu listede dosya kimliği, dosya adı ve dosyayı açma bağlantısı yer alır. İstek ayrıca application/vnd.google-apps.presentation değerini MIME türü olarak belirtir.

Aşağıda, mevcut sunu dosyalarını listelemek için kullanılan istek protokolü 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"
    },
    ...
  ]
}

Sununun tamamında metin değiştirme

Aşağıdaki presentations.batchUpdate kod örneğinde, ReplaceAllTextRequest yönteminin, PRESENTATION_ID ile belirtilen sunumdaki metni değiştirmek için nasıl kullanılacağı gösterilmektedir. Sunum kimliği değerini sunum URL'sinden öğrenebilirsiniz.

"Gizmo Corp." dizesinin her örneği "Gadget Inc." metniyle değiştirilir. Metin kutularındaki ve diğer şekillerdeki, slaytlardaki ve ana öğelerdeki metinler buna dahildir. Bu durumda, matchCase ayarı true olarak belirlendiğinden metin değiştirme büyük/küçük harfe duyarlıdır.

Bir sunudaki metni değiştirme için istek protokolü aşağıda verilmiştir:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
 
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}