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 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ü 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ın yapısı aşağıdaki gibidir:

{
 "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 metinleri 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. Sunum kimliği değerini sunum URL'sinden öğrenebilirsiniz.

"Gizmo Corp." dizesinin her örneği "Gadget Inc." metniyle değiştirilir. Buna metin kutularındaki ve diğer şekillerdeki, slaytlardaki ve ana slaytlardaki metinler 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."
      }
    }
  ]
}