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şleminin 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.

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 listesi alma yöntemi 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 sunum 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ğe verilen 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ındaki metni değiştirme

Aşağıdaki presentations.batchUpdate kod örneğinde, PRESENTATION_ID ile belirtilen sunumda 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. Bu kapsamda, metin kutularındaki ve diğer şekillerdeki, slaytlardaki ve ana slaytlardaki metinler yer alır. 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."
      }
    }
  ]
}