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 sunma işlemleri gösterilmektedir.

Bu örnekler, dilden bağımsız olarak HTTP istekleri olarak sunulur. Google API istemci kitaplıklarını kullanarak bir toplu güncellemeyi farklı dillerde nasıl uygulayacağınızı öğrenmek için aşağıdaki kılavuzlara bakın:

Sunum hazırlayın

Aşağıdaki presentations.create kod örneğinde "Yeni Sunum" adında 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şturmak için kullanılacak istek protokolü verilmiştir:

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

Mevcut sunu dosyalarını listele

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

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

Sunu boyunca metni değiştirme

Aşağıdaki presentations.batchUpdate kod örneğinde, PRESENTATION_ID ile belirtilen sunu boyunca metin değiştirmek için ReplaceAllTextRequest yönteminin nasıl kullanılacağı gösterilmektedir. Sunu kimliği değerini, sunu URL'sinden bulabilirsiniz.

"Gizmo Corp." dizesinin tüm örnekleri, "Tarife Inc." ifadesiyle değiştirilir. Bu, metin kutuları ve diğer şekillerde, slaytlardaki ve ana öğelerdeki metinleri içerir. Bu durumda, matchCase değeri true olarak ayarlandığında metin değiştirme büyük/küçük harfe duyarlı olur.

Aşağıda, sunu boyunca metinlerin değiştirilmesi için kullanılacak 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."
      }
    }
  ]
}