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önteminin kullanıldığı 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.

MIME türü olarak application/vnd.google-apps.presentation belirtilerek Google Drive API files.create yöntemi kullanılarak boş sunu dosyaları da oluşturulabilir.

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 olarak MIME türünü de belirtir.

Mevcut sunu dosyalarını listelemek için kullanılan 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 metinleri değiştirme

Aşağıdaki presentations.batchUpdate kod örneğinde, PRESENTATION_ID ile belirtilen sunumdaki metinleri 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. 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."
      }
    }
  ]
}